Cette intégration synchronise les appareils Level dans ConnectWise PSA en tant que configurations et route les alertes de moniteur Level vers les tickets de service ConnectWise. La configuration commence dans ConnectWise d'abord (rôle de sécurité, membre API, clés API), puis dans Level (identifiants, mappage de groupe, ticketing), puis vous appuyez sur le commutateur pour devenir actif.
⚙️ CONDITIONS PRÉALABLES
Accès administrateur Level
Accès administrateur ConnectWise PSA avec permission de gérer les rôles de sécurité, les membres API et les clés API
Intégration ConnectWise PSA
Créer un rôle de sécurité dans ConnectWise
L'intégration PSA Connectwise nécessite de configurer un « Rôle de sécurité » dans Connectwise. Ce rôle doit disposer des autorisations appropriées pour que Level puisse créer des configurations, des types et des tickets.
1. Accédez à Paramètres > Rôles de sécurité
2. Cela vous affichera une liste des rôles de sécurité déjà créés. Cliquez sur le symbole « + » pour créer un nouveau rôle pour Level :
3. Donnez au nouveau rôle de sécurité un nom, par exemple « Level ». Cliquez sur l'icône d'enregistrement :
4. Vous serez amené à une liste de toutes les autorisations disponibles. Level n'en a besoin que d'un petit sous-ensemble. Vous devrez définir les autorisations sous « Entreprises », « Service Desk » et « Système » :
5. Précisément, Level aura besoin des autorisations suivantes :
Entreprises :
Maintenance de l'entreprise - Ajouter, Modifier, Enquête
Configurations - Ajouter, Modifier, Enquête
Service Desk :
Fermer les tickets de service - Modifier, Enquête
Tickets de service - Ajouter, Modifier, Enquête
Système :
Configuration du tableau - Ajouter, Enquête
6. Cliquez sur l'icône d'enregistrement pour persister les modifications :
Créer un membre API dans Connectwise
Connectwise utilise des membres API pour contenir les clés API.
1. Accédez à Système > Membres > Membres API
2. Cliquez sur « Membres API » :
3. Cliquez sur le « + » :
4. Remplissez les champs obligatoires et assurez-vous de sélectionner le rôle de sécurité que nous avons créé à l'étape précédente comme « ID de rôle » :
5. Cliquez sur l'icône d'enregistrement pour persister vos modifications :
Créer des clés API
1. À partir du membre API nouvellement créé, allez à « Clés API » :
2. Nous devons créer une clé API que Level peut utiliser. Cliquez sur l'icône « + » :
3. Donnez à la clé une « Description » et cliquez sur l'icône d'enregistrement pour générer les clés :
4. Prenez note de la « Clé publique » et de la « Clé privée », nous les utiliserons dans Level :
Configurer l'intégration dans Level
1. Accédez à Paramètres > Intégrations
2. Cliquez sur l'intégration Connectwise PSA :
3. Complétez les quatre champs de configuration :
URL ConnectWise PSA
L'URL PSA ConnectWise. Cette URL peut pointer vers un emplacement sur site ou dans le cloud et doit inclure le protocole approprié. Par exemple : https://connect.mycompanydomain.com.
Entreprise
Votre nom d'entreprise que vous utilisez pour vous connecter à votre compte ConnectWise PSA.
Clés API
Les clés publiques et privées que nous avons générées aux étapes précédentes.
4. Cliquez sur le bouton « Enregistrer les modifications » :
5. Appuyez sur « Tester la connexion » pour vous assurer que vos paramètres fonctionnent :
Mapper les groupes Level aux sites Connectwise
Level créera des configurations dans Connectwise en fonction de vos mappages de groupes. Vous pouvez choisir n'importe quel groupe ou sous-groupe dans Level et le faire correspondre avec une combinaison de société et de site de Connectwise.
1. Allez à Mappage des groupes :
2. Cliquez sur « Ajouter de nouveaux groupes » pour sélectionner les groupes Level à mapper aux sites Connectwise :
3. Choisissez un ou plusieurs groupes et cliquez sur « Ajouter de nouveaux groupes » :
4. Choisissez un type de société et un statut Connectwise et cliquez sur « Charger les sociétés Connectwise » pour récupérer le sous-ensemble de sociétés parmi lesquelles vous souhaitez choisir :
5. Choisissez une société Connectwise pour le premier mappage :
6. Sélectionnez le site Connectwise :
7. Répétez pour chaque ligne et cliquez sur « Enregistrer » une fois terminé :
ℹ️ REMARQUE : L'intégration est toujours désactivée à ce stade — aucun appareil n'est encore synchronisé.
Mapper les stratégies de moniteur Level aux tableaux de service Connectwise
Level peut mapper les alertes aux tickets Connectwise. Nous devons juste choisir quelles stratégies de moniteur doivent créer des tickets, ainsi que sur quel tableau de service les tickets doivent apparaître.
1. Cliquez sur « Ticketing » :
2. Choisissez des tableaux de service Connectwise pour chaque stratégie que vous souhaitez mapper :
3. Lorsque vous avez terminé, cliquez sur « Enregistrer les modifications » en bas de la page :
ℹ️ REMARQUE : L'intégration est toujours désactivée à ce stade — aucun appareil n'est encore synchronisé.
Commencer à envoyer des appareils et des alertes
1. Cliquez sur le bouton « Désactivé » :
2. Cela commencera immédiatement à envoyer des appareils et des alertes. Vous pouvez voir le mappage des groupes passer de « Non synchronisé » à « Synchronisation en cours » et finalement à « Synchronisé » :
3. Si vous souhaitez suivre la progression ou dépanner un problème, accédez à l'onglet « Événements » pour voir une liste en temps réel des demandes envoyées à Connectwise :
FAQ
Qui peut configurer cette intégration ? Un administrateur Level et un administrateur ConnectWise PSA. Le côté ConnectWise nécessite une permission pour gérer les rôles de sécurité, les membres API et les clés API.
Pourquoi ai-je besoin d'un rôle de sécurité dédié ? La limitation des autorisations à exactement ce que Level a besoin réduit le risque. Le rôle n'accorde l'accès qu'aux configurations, aux tickets de service et à la configuration du tableau — rien de plus.
Dois-je mapper chaque groupe ? Seuls les groupes qui doivent synchroniser les appareils vers ConnectWise ont besoin de mappages. Vous pouvez mapper un sous-ensemble de vos groupes Level et laisser d'autres non mappés.
Pourquoi un appareil n'apparaît-il pas en tant que configuration dans ConnectWise ? Confirmez que le groupe de l'appareil est mappé sous Mappage des groupes et que l'intégration est activée. Consultez l'onglet Événements pour les demandes échouées et vérifiez les codes de réponse HTTP pour identifier le problème.
Puis-je ajouter ou modifier les mappages de groupes après que l'intégration soit en direct ? Oui. Retournez à Mappage des groupes, apportez des modifications et enregistrez. Les mises à jour prennent effet immédiatement.