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 la 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 à Settings > Integrations :
2. Cliquez sur «HaloPSA API» :
3. Notez l'URL de base affichée ci-dessous. Elle sera utilisée comme «HaloPSA URL» lors de la configuration de Level :
4. Cliquez sur «View Applications» :
5. Ceci est la liste de vos «Applications» existantes. Cliquez sur «New» dans le coin supérieur droit pour créer une application pour Level :
6. Remplissez le champ obligatoire «Application Name» avec un 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 «Login Type» et sélectionnez l'agent que vous souhaitez que Level utilise.
💡 CONSEIL : HaloPSA recommande de créer un agent «API only» pour les intégrations. Ce type d'agent ne compte pas dans vos licences.
9. Cliquez sur «Save» :
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-admin d'ajouter des champs aux types d'actifs. Ils travaillent à annuler ce changement, 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 la permission «admin» à l'application et l'agent. Désolé pour le dérangement.
12. Cliquez sur «Save» lorsque vous avez terminé :
Configurer les permissions de l'agent HaloPSA
L'agent API que vous avez défini à l'étape précédente pour le champ «Agent to log in as» nécessite quelques permissions pour fonctionner correctement.
1. Accédez à Settings > Teams & Agents > Agents et choisissez l'agent assigné à l'application :
2. Cliquez sur l'onglet «Permissions» et passez en mode «Edit» :
3. Assurez-vous que les paramètres suivants sont configurés :
Tickets Access Level - Read and Modify
Clients Access Level - Read Only
Assets Access Level - Read and Modify
Can add new Tickets - Yes
Allow use of all Ticket Types - Yes
4. Cliquez sur «Save» lorsque vous avez terminé :
Configurer l'intégration dans Level
1. Accédez à Settings > Integrations :
2. Cliquez sur l'intégration HaloPSA :
3. Remplissez les trois champs de configuration :
HaloPSA URL
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 que nous avons générée lors des étapes précédentes.
Client secret
La valeur que nous avons générée lors des étapes précédentes.
4. Cliquez sur le bouton «Save changes» :
5. Appuyez sur «Test connection» 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 entreprise et site dans HaloPSA.
1. Accédez à «Group mapping» :
2. Cliquez sur «Add new groups» pour sélectionner les groupes Level à associer aux sites HaloPSA :
3. Choisissez un ou plusieurs groupes et cliquez sur «Add new groups» :
4. Choisissez une entreprise HaloPSA pour la première association :
5. Sélectionnez le site HaloPSA :
6. Répétez pour chaque ligne et cliquez sur «Save» lorsque vous avez 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 «Ticketing» :
2. Choisissez les types de tickets HaloPSA pour chaque politique que vous souhaitez associer :
3. Lorsque vous avez terminé, cliquez sur «Save changes» 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 «Disabled» :
2. Cela commencera immédiatement à envoyer les appareils et les alertes. Vous pouvez voir les associations de groupes passer de «Unsynced» à «Syncing» puis finalement à «Synced» :
3. Si vous souhaitez suivre la progression ou résoudre un problème, accédez à l'onglet «Events» 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 requiert é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 only» ne consomme pas de siège de licence et maintient l'activité d'intégration séparée de l'activité des agents humains.
Tous les appareils se synchroniseront-ils 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. Observez le tableau des associations de groupes — les lignes passent de Unsynced à Synced 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 bien associé sous Group mapping et que l'intégration est activée. Ouvrez ensuite Events et recherchez les requêtes échouées liées à cet appareil.
Puis-je associer d'autres groupes après la mise en service de l'intégration ? Oui. Retournez dans Group mapping, ajoutez de nouveaux groupes et enregistrez. Les nouveaux groupes se synchronisent une fois l'association enregistrée.






