Introduction
Cette intégration synchronise les appareils Level dans HaloPSA en tant qu'actifs et achemine les alertes Level vers des tickets HaloPSA. La configuration se déroule en trois étapes : configurer une application HaloPSA, la connecter dans Level, puis associer vos groupes d'appareils aux sites HaloPSA et choisir quelles politiques de surveillance créent des tickets.
⚙️ PRÉREQUIS
Accès administrateur Level
Accès administrateur HaloPSA avec permission de créer des applications et de gérer les agents
Intégration HaloPSA
Configurer l'application HaloPSA
HaloPSA utilise des «Applications» pour autoriser l'accès à l'API. Nous devons en créer une pour Level.
1. Accédez à Paramètres > Intégrations :
2. Cliquez sur «HaloPSA API» :
3. Notez l'URL de base affichée ci-dessous. Elle sera utilisée comme «URL HaloPSA» lors de la configuration de Level :
4. Cliquez sur «Afficher les applications» :
5. Voici la liste de vos «Applications» existantes. Cliquez sur «Nouveau» en haut à droite pour créer une application pour Level :
6. Renseignez le champ obligatoire «Nom de l'application» avec le nom de votre choix. Sélectionnez l'option «Client ID and Secret (Services)» :
7. Notez le «Client ID» et le «Client Secret», 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 utiliser pour Level.
💡 CONSEIL : HaloPSA recommande de créer un agent «API uniquement» pour les intégrations. Ce type d'agent ne compte pas dans vos postes de licence.
9. Cliquez sur «Enregistrer» :
10. Cliquez sur «Autorisations» :
11. Sélectionnez les autorisations 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 administrateurs d'ajouter des champs aux types d'actifs. Ils travaillent à annuler cette modification, mais cela prendra environ deux semaines (aux alentours du 19 novembre). Entre-temps, si vous configurez votre intégration Halo pour la première fois, veuillez accorder l'autorisation «admin» à l'application et l'agent. Veuillez nous excuser pour la gêne occasionnée.
12. Cliquez sur «Enregistrer» une fois terminé :
Configurer les autorisations de l'agent HaloPSA
L'agent API que vous avez défini à l'étape précédente pour le «Agent à utiliser pour la connexion» nécessite quelques autorisations pour fonctionner correctement.
1. Accédez à Paramètres > Équipes & Agents > Agents et choisissez l'agent associé à l'application :
2. Cliquez sur l'onglet «Autorisations» et passez en mode «Édition» :
3. Assurez-vous que les paramètres suivants sont définis :
Niveau d'accès aux tickets - Lecture et modification
Niveau d'accès aux clients - Lecture seule
Niveau d'accès aux actifs - Lecture et modification
Peut ajouter de nouveaux tickets - Oui
Autoriser l'utilisation de tous les types de tickets - Oui
4. Cliquez sur «Enregistrer» une fois terminé :
Configurer l'intégration dans Level
1. Accédez à Paramètres > Intégrations :
2. Cliquez sur l'intégration HaloPSA :
3. Renseignez 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.
Client ID
La valeur générée lors des étapes précédentes.
Secret client
La valeur générée 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 :
Associer les groupes Level aux sites HaloPSA
Level créera des actifs dans HaloPSA en fonction de vos associations de groupes. Vous pouvez choisir n'importe quel groupe ou sous-groupe dans Level et l'associer à une combinaison société/site dans HaloPSA.
1. Accédez à «Association de groupes» :
2. Cliquez sur «Ajouter de nouveaux groupes» pour sélectionner les groupes Level à associer aux sites HaloPSA :
3. Choisissez un ou plusieurs groupes et cliquez sur «Ajouter de nouveaux groupes» :
4. Choisissez une société HaloPSA pour la première association :
5. Sélectionnez le site HaloPSA :
6. Répétez pour chaque ligne et cliquez sur «Enregistrer» une fois terminé :
ℹ️ REMARQUE : L'intégration reste désactivée à ce stade, donc aucun appareil n'est encore synchronisé.
Associer les politiques de surveillance Level aux types de tickets HaloPSA
Level peut associer des alertes à des tickets HaloPSA. Il suffit de sélectionner quelles politiques de surveillance doivent créer des tickets, ainsi que les types de tickets sous lesquels ils doivent être créés.
1. Cliquez sur «Tickets» :
2. Choisissez les types de tickets HaloPSA pour chaque politique que vous souhaitez associer :
3. Une fois terminé, cliquez sur «Enregistrer les modifications» en bas de la page :
ℹ️ REMARQUE : L'intégration reste désactivée à ce stade, donc aucun appareil n'est encore synchronisé.
Commencer à envoyer des appareils et des alertes
1. Cliquez sur le bouton bascule «Désactivé» :
2. Cela déclenchera immédiatement l'envoi des appareils et des alertes. Vous pouvez voir les associations 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 une liste en temps réel des requêtes envoyées à HaloPSA :
FAQ
Qui peut configurer cette intégration ? Un administrateur Level. Du côté de HaloPSA, un administrateur avec permission de créer des applications et de gérer les agents est également requis.
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 permet de séparer l'activité d'intégration de l'activité des agents humains.
Tous les appareils seront-ils synchronisés immédiatement lorsque j'active l'intégration ? Oui. L'activation du bouton bascule lance la synchronisation de tous les appareils dans les groupes associés. Surveillez le tableau d'association de groupes — les lignes 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 associé sous Association 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 associer d'autres groupes une fois l'intégration en service ? Oui. Revenez à Association de groupes, ajoutez de nouveaux groupes et enregistrez. Les nouveaux groupes se synchronisent une fois l'association enregistrée.