Cette intégration synchronise les appareils Level dans HaloPSA en tant qu'actifs et achemine les alertes Level vers les tickets HaloPSA. La configuration s'effectue en trois étapes : configurer une application HaloPSA, la connecter dans Level, puis mapper vos groupes d'appareils aux sites HaloPSA et choisir les politiques de monitoring qui créent des tickets.
⚙️ PRÉREQUIS
Accès administrateur Level
Accès administrateur HaloPSA avec permission de créer des applications et gérer les agents
Intégration HaloPSA
Configurer l'Application HaloPSA
HaloPSA utilise des « Applications » pour permettre l'accès API. Nous devons en créer une pour Level.
1. Allez à Paramètres > Intégrations :
2. Cliquez sur « API HaloPSA » :
3. Notez l'URL de base affichée ci-dessous. Celle-ci sera utilisée comme « URL HaloPSA » lors de la configuration de Level :
4. Cliquez sur « Afficher les Applications » :
5. Ceci est une liste de vos « Applications » existantes. Cliquez sur « Nouveau » dans le coin supérieur droit pour créer une application pour Level :
6. Complétez le champ requis « Nom de l'Application » avec le nom de votre choix. Sélectionnez l'option « ID Client et Secret (Services) » :
7. Notez l'« ID Client » et le « Secret Client » car nous en aurons besoin lors de la configuration de Level.
8. Choisissez « Agent » pour le « Type de Connexion » et sélectionnez l'agent que vous souhaitez que Level utilise.
💡 CONSEIL : HaloPSA recommande de créer un agent « API uniquement » pour les intégrations. Ce type d'agent ne consomme pas de siège de licence.
9. Cliquez sur « Enregistrer » :
10. Cliquez sur « Permissions » :
11. Sélectionnez les permissions suivantes :
read:tickets
edit:tickets
read:customers
read:assets
edit:assets
ℹ️ REMARQUE : Halo a récemment apporté une modification qui empêche les intégrations non-administrateur d'ajouter des champs aux types d'actifs. Ils travaillent à l'annulation de la modification, mais cela prendra environ deux semaines (autour du 19 novembre). En attendant, si vous configurez votre intégration Halo pour la première fois, veuillez accorder la permission « administrateur » à l'application et à l'agent. Nous nous excusons pour le désagrément.
12. Cliquez sur « Enregistrer » quand vous avez terminé :
Configurer les permissions de l'agent HaloPSA
L'agent API que vous avez défini à l'étape précédente pour « Agent à se connecter en tant que » nécessite quelques permissions pour fonctionner correctement.
1. Allez à Paramètres > Équipes et Agents > Agents et choisissez l'agent assigné à l'application :
2. Cliquez sur l'onglet « Permissions » et entrez le mode « Modification » :
3. Assurez-vous que les paramètres suivants sont définis :
Niveau d'Accès aux Tickets - Lire et Modifier
Niveau d'Accès aux Clients - Lecture Seule
Niveau d'Accès aux Actifs - Lire et Modifier
Peut ajouter de nouveaux Tickets - Oui
Autoriser l'utilisation de tous les Types de Tickets - Oui
4. Cliquez sur « Enregistrer » quand vous avez terminé :
Configurer l'intégration dans Level
1. Allez à Paramètres > Intégrations :
2. Cliquez sur l'intégration HaloPSA :
3. Complétez les trois champs de configuration :
URL HaloPSA
L'URL que vous utilisez pour accéder à votre instance HaloPSA. Cette URL peut pointer vers un emplacement sur site ou dans le cloud et doit inclure le protocole approprié. Par exemple : https://domainhalopsa.com.
ID Client
La valeur que nous avons générée aux étapes précédentes.
Secret Client
La valeur que nous avons générée 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 HaloPSA
Level créera des actifs dans HaloPSA 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 HaloPSA.
1. Allez à « Mappage de groupes » :
2. Cliquez sur « Ajouter de nouveaux groupes » pour sélectionner les groupes Level à mapper aux sites HaloPSA :
3. Choisissez un ou plusieurs groupes et cliquez sur « Ajouter de nouveaux groupes » :
4. Choisissez une société HaloPSA pour le premier mappage :
5. Sélectionnez le site HaloPSA :
6. Répétez pour chaque ligne et cliquez sur « Enregistrer » quand vous avez terminé :
ℹ️ REMARQUE : L'intégration reste désactivée à ce stade, aucun appareil n'est synchronisé.
Mapper les politiques de monitoring Level aux types de tickets HaloPSA
Level peut mapper des alertes aux tickets HaloPSA. Nous devons juste sélectionner les politiques de monitoring qui doivent créer des tickets, ainsi que les types de tickets dans lesquels elles doivent être créées.
1. Cliquez sur « Ticketing » :
2. Choisissez les types de tickets HaloPSA pour chaque politique que vous souhaitez mapper :
3. Quand vous avez terminé, cliquez sur « Enregistrer les modifications » en bas de la page :
ℹ️ REMARQUE : L'intégration reste désactivée à ce stade, aucun appareil n'est synchronisé.
Commencer à envoyer les appareils et les alertes
1. Cliquez sur le bouton bascule « Désactivé » :
2. Cela commencera immédiatement à envoyer les appareils et les alertes. Vous pouvez voir les mappages de groupes passer de « Non synchronisé » à « Synchronisation en cours » et finalement à « Synchronisé » :
3. Si vous souhaitez suivre la progression ou résoudre un problème, accédez à l'onglet « Événements » pour voir une liste en temps réel des requêtes envoyées à HaloPSA :
FAQ
Qui peut configurer cette intégration ? Un administrateur Level. Le côté HaloPSA nécessite également un administrateur avec la permission de créer des applications et de gérer les agents.
Dois-je créer un agent HaloPSA dédié pour cela ? HaloPSA le recommande. Un agent « API uniquement » ne consomme pas de siège de licence et maintient l'activité d'intégration séparée de l'activité de l'agent humain.
Tous les appareils seront-ils synchronisés immédiatement quand j'active l'intégration ? Oui. L'activation du bouton bascule démarre la synchronisation de tous les appareils dans les groupes mappés. Regardez le tableau de mappage des groupes - les rangées passent de Non synchronisé à Synchronisé au fur et à mesure que les appareils sont traités.
Pourquoi un appareil n'apparaît-il pas dans HaloPSA ? Vérifiez que le groupe de l'appareil est mappé sous Mappage de groupes et que l'intégration est activée. Ouvrez ensuite l'onglet Événements et recherchez les requêtes échouées liées à cet appareil.
Puis-je mapper plus de groupes une fois que l'intégration est opérationnelle ? Oui. Allez à Mappage de groupes, ajoutez de nouveaux groupes et enregistrez. Les nouveaux groupes se synchronisent après le sauvegarde du mappage.