Introduction
Cette intégration synchronise les appareils Level dans ConnectWise PSA en tant que configurations et achemine les alertes des moniteurs Level vers des tickets de service ConnectWise. La configuration s'effectue d'abord dans ConnectWise (rôle de sécurité, membre API, clés API), puis dans Level (identifiants, mappage de groupes, billetterie), puis vous activez le commutateur pour passer en production.
⚙️ PRÉREQUIS
Accès administrateur Level
Accès administrateur ConnectWise PSA avec autorisation 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 ConnectWise PSA nécessite la configuration d'un «Rôle de sécurité» dans ConnectWise. Ce rôle doit disposer des autorisations appropriées afin que Level puisse créer des configurations, des types et des tickets.
1. Accédez aux Paramètres > Rôles de sécurité
2. Une liste des rôles de sécurité déjà créés s'affiche. Cliquez sur le symbole «+» pour créer un nouveau rôle pour Level :
3. Donnez un nom au nouveau rôle de sécurité, par exemple «Level». Cliquez sur l'icône d'enregistrement :
4. Vous serez redirigé vers une liste de toutes les autorisations disponibles. Level n'a besoin que d'un petit sous-ensemble de celles-ci. Vous devrez définir les autorisations sous «Entreprises», «Service d'assistance» et «Système» :
5. Plus précisément, Level aura besoin des autorisations suivantes :
Entreprises :
Maintenance de l'entreprise - Ajouter, Modifier, Consulter
Configurations - Ajouter, Modifier, Consulter
Service d'assistance :
Clôturer les tickets de service - Modifier, Consulter
Tickets de service - Ajouter, Modifier, Consulter
Système :
Configuration des tables - Ajouter, Consulter
6. Cliquez sur l'icône d'enregistrement pour valider les modifications :
Créer un membre API dans ConnectWise
ConnectWise utilise des membres API pour stocker les clés API.
1. Accédez à Système > Membres > Membres API
2. Cliquez sur «Membres API» :
3. Cliquez sur «+» :
4. Remplissez les champs obligatoires et veillez à sélectionner le rôle de sécurité créé à l'étape précédente comme «ID de rôle» :
5. Cliquez sur l'icône d'enregistrement pour valider vos modifications :
Créer des clés API
1. Depuis le membre API nouvellement créé, accédez à «Clés API» :
2. Nous devons créer une clé API que Level pourra utiliser. Cliquez sur l'icône «+» :
3. Donnez une «Description» à la clé et cliquez sur l'icône d'enregistrement pour générer les clés :
4. Notez la «Clé publique» et la «Clé privée», nous les utiliserons dans Level :
Configurer l'intégration dans Level
1. Accédez aux Paramètres > Intégrations
2. Cliquez sur l'intégration ConnectWise PSA :
3. Remplissez les quatre champs de configuration :
URL ConnectWise PSA
L'URL ConnectWise PSA. 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
Le nom de votre entreprise que vous utilisez pour vous connecter à votre compte ConnectWise PSA.
Clés API
Les clés publique et privée générées lors des étapes précédentes.
4. Cliquez sur le bouton «Enregistrer les modifications» :
5. Appuyez sur «Tester la connexion» pour vérifier 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 l'associer à une combinaison entreprise/site dans ConnectWise.
1. Accédez au Mappage de 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 et un statut d'entreprise ConnectWise, puis cliquez sur «Charger les entreprises ConnectWise» pour récupérer le sous-ensemble d'entreprises parmi lesquelles vous souhaitez choisir :
5. Choisissez une entreprise ConnectWise pour le premier mappage :
6. Sélectionnez le site ConnectWise :
7. Répétez l'opération pour chaque ligne et cliquez sur «Enregistrer» lorsque vous avez terminé :
ℹ️ REMARQUE : L'intégration est encore désactivée à ce stade — aucun appareil n'est encore synchronisé.
Mapper les politiques de moniteurs Level aux tableaux de service ConnectWise
Level peut mapper les alertes vers des tickets ConnectWise. Il suffit de choisir quelles politiques de moniteurs doivent créer des tickets, ainsi que le tableau de service sur lequel les tickets doivent apparaître.
1. Cliquez sur «Billetterie» :
2. Choisissez des tableaux de service ConnectWise pour chaque politique que vous souhaitez mapper :
3. Une fois terminé, cliquez sur «Enregistrer les modifications» en bas de la page :
ℹ️ REMARQUE : L'intégration est encore 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. L'envoi des appareils et des alertes commence immédiatement. Vous pouvez voir les mappages de groupes passer de «Non synchronisé» à «En cours de synchronisation», puis à «Synchronisé» :
3. Si vous souhaitez suivre la progression ou résoudre un problème, accédez à l'onglet «Événements» pour voir la liste en temps réel des requêtes envoyées à ConnectWise :
FAQ
Qui peut configurer cette intégration ? Un administrateur Level et un administrateur ConnectWise PSA. Le côté ConnectWise nécessite l'autorisation de 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é ? Limiter les autorisations exactement à ce dont Level a besoin réduit les risques. Le rôle accorde l'accès uniquement aux configurations, aux tickets de service et à la configuration des tables — rien de plus.
Dois-je mapper tous les groupes ? Seuls les groupes qui doivent synchroniser des appareils avec ConnectWise nécessitent des mappages. Vous pouvez mapper un sous-ensemble de vos groupes Level et laisser les autres sans mappage.
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 de groupes et que l'intégration est activée. Vérifiez le Événements pour les requêtes échouées et examinez les codes de réponse HTTP pour identifier le problème.
Puis-je ajouter ou modifier des mappages de groupes après la mise en service de l'intégration ? Oui. Revenez à Mappage de groupes, apportez des modifications et enregistrez. Les mises à jour prennent effet immédiatement.