Introduction
Cette intégration synchronise les appareils Level dans ConnectWise PSA en tant que configurations et route les alertes de surveillance de Level vers les tickets de service ConnectWise. La configuration se fait d'abord dans ConnectWise (rôle de sécurité, membre API, clés API), puis dans Level (identifiants, mappage de groupe, tickets), puis vous activez le commutateur pour passer à la production.
⚙️ PRÉREQUIS
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 ConnectWise PSA nécessite de configurer un « rôle de sécurité » dans Connectwise. Ce rôle doit disposer des permissions appropriées pour que Level soit en mesure de créer des configurations, des types et des tickets.
1. Allez à Paramètres > Rôles de sécurité
2. Cela vous montrera 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, comme « Level ». Cliquez sur l'icône d'enregistrement:
4. Vous serez amené à une liste de toutes les permissions disponibles. Level n'a besoin que d'un petit sous-ensemble de ceux-ci. Vous devrez définir les permissions sous « Entreprises », « Service Desk » et « Système »:
5. Spécifiquement, Level aura besoin des permissions suivantes:
Companies:
Gestion des entreprises - Ajouter, Modifier, Demander
Configurations - Ajouter, Modifier, Demander
Service Desk:
Tickets de service de fermeture - Modifier, Demander
Tickets de service - Ajouter, Modifier, Demander
System:
Configuration de table - Ajouter, Demander
6. Cliquez sur l'icône d'enregistrement pour conserver les modifications:
Créer un membre API dans Connectwise
Connectwise utilise les membres API pour contenir les clés API.
1. Allez à 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 en tant que « ID de rôle »:
5. Cliquez sur l'icône d'enregistrement pour conserver vos modifications:
Create API Keys
1. À partir du membre API nouvellement créé, allez à « Clés API »:
2. Nous devons créer une clé API que Level puisse 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. Notez la « Clé publique » et la « Clé privée », nous les utiliserons dans Level:
Configuration de l'intégration dans Level
1. Allez à Paramètres > Intégrations
2. Cliquez sur l'intégration Connectwise PSA:
3. Complétez les quatre champs de configuration:
URL PSA ConnectWise
L'URL ConnectWise PSA. Cette URL peut pointer vers un emplacement sur site ou cloud et doit inclure le protocole approprié. Par exemple:https://connect.mycompanydomain.com.
Company
Votre nom d'entreprise que vous utilisez pour vous connecter à votre compte ConnectWise PSA.
API Keys
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 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 groupe. Vous pouvez choisir n'importe quel groupe ou sous-groupe dans Level et l'associer à une combinaison d'entreprise et de site de Connectwise.
1. Allez à Mappage de groupe:
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 et cliquez sur « Charger les entreprises Connectwise » pour récupérer le sous-ensemble d'entreprises que vous souhaitez choisir:
5. Choisissez une entreprise Connectwise pour le premier mappage:
6. Sélectionnez le site Connectwise:
7. Répétez pour chaque ligne et cliquez sur « Enregistrer » lorsque vous avez terminé:
ℹ️ REMARQUE: L'intégration est toujours désactivée à ce stade — aucun appareil n'est encore synchronisé.
Mapper les politiques de surveillance de Level aux tableaux de service Connectwise
Level peut mapper les alertes aux tickets Connectwise. Nous devons simplement choisir quelles politiques de surveillance doivent créer des tickets, ainsi que le tableau de service sur lequel les tickets doivent apparaître.
1. Cliquez sur « Ticketing »:
2. Choisissez les tableaux de service Connectwise pour chaque politique 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é.
Commencez à envoyer des appareils et des alertes
1. Cliquez sur le curseur « Désactivé »:
2. Cela commencera immédiatement à envoyer des appareils et des alertes. Vous pouvez voir le mappage de groupe passer de « Non synchronisé » à « Synchronisation » et éventuellement à « 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 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 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 définition des permissions à 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 de table — rien de plus.
Dois-je mapper chaque groupe? Seuls les groupes qui doivent synchroniser les appareils avec 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 comme une configuration dans ConnectWise? Confirmez que le groupe de l'appareil est mappé sous Group mapping et que l'intégration est activée. Vérifiez leEvents onglet pour les demandes échouées et regardez les codes de réponse HTTP pour identifier le problème.
Puis-je ajouter ou modifier les mappages de groupe après que l'intégration soit en direct? Yes. Return to Group mapping , apporter des modifications et enregistrer. Les mises à jour prennent effet immédiatement.