Introduction

AlgaPSA reproduit votre configuration Level côté PSA : les groupes Level correspondent aux clients AlgaPSA, les appareils des groupes mappés sont synchronisés en tant qu'actifs, et les alertes Level ouvrent des tickets via les règles d'alerte d'AlgaPSA.

La configuration s'effectue sur les deux plateformes. Dans Level, vous créez une clé API et une automatisation qui envoie les alertes à AlgaPSA. Dans AlgaPSA, vous collez la clé, mappez les groupes et lancez la synchronisation des appareils.

ℹ️ REMARQUE : Cette intégration a été conçue et est maintenue par Nine Minds, les créateurs d'AlgaPSA. Pour la configuration côté AlgaPSA, consultez leur documentation : Intégration Level RMM. Il s'agit d'une fonctionnalité de l'édition Enterprise d'AlgaPSA.

⚙️ PRÉREQUIS

Accès administrateur Level (pour créer une clé API et construire une automatisation)
Un compte AlgaPSA Enterprise Edition avec accès aux paramètres d'administration
Votre instance AlgaPSA accessible via une adresse HTTPS publique (voir l'avertissement sous Envoyer des alertes à AlgaPSA)

Intégration AlgaPSA

Créer une clé API dans Level

AlgaPSA utilise une clé API Level pour lire vos groupes, appareils et alertes.

Dans Level, accédez à Paramètres → Clés API.
Cliquez sur + Créer une clé API.
Saisissez une Description tel que «Intégration AlgaPSA».
Sélectionnez Lecture seule. Tout ce qu'AlgaPSA récupère depuis Level (découverte des groupes, synchronisation des appareils, remplissage des alertes) est une lecture, une clé en lecture seule est donc suffisante.
Cliquez sur Créer la clé, puis utilisez le menu à trois points sur la nouvelle ligne et choisissez Copier la clé.

Voir Paramètres des clés API pour tous les détails sur la gestion des clés.

Connecter AlgaPSA à Level

Dans AlgaPSA, accédez à Paramètres → Général pour ouvrir les paramètres d'administration.
Sélectionnez Intégrations sous Données & Intégration, ouvrez l' RMM onglet, et sélectionnez Level.
Collez votre clé dans le Clé API champ sur la Connexion Level carte.
Cliquez sur Enregistrer la configuration, puis Tester la connexion.

Un test réussi marque l'intégration comme Connectée et affiche l'heure de connexion.

Mapper les groupes et synchroniser les appareils

Le mapping s'effectue entièrement dans AlgaPSA, sur la Synchronisation & Mappages de groupes carte.

Cliquez sur Découvrir les groupes. AlgaPSA importe la hiérarchie de vos groupes Level dans le tableau de mapping.
Pour chaque groupe que vous gérez, choisissez un client AlgaPSA dans la Client mappé liste déroulante. Définissez éventuellement un Contact par défaut, qui est associé aux tickets ouverts par les alertes de ce groupe.
Cliquez sur Lancer la synchronisation des appareils. Les appareils des groupes mappés deviennent des actifs AlgaPSA.

Deux comportements méritent d'être connus :

Les sous-groupes héritent. Un sous-groupe sans mapping propre utilise le parent mappé le plus proche, donc mapper le groupe de niveau supérieur d'un client couvre généralement tout son arbre.
Les groupes non mappés sont ignorés. Les appareils d'un groupe sans mapping et sans parent mappé ne sont pas synchronisés.

💡 CONSEIL : Mappez un groupe Level de niveau supérieur par client, puis laissez les sous-groupes hériter. C'est moins à maintenir que de mapper chaque sous-groupe manuellement.

Envoyer des alertes à AlgaPSA

AlgaPSA authentifie les alertes entrantes avec son propre X-Alga-Webhook-Secret en-tête et attend sa propre charge utile JSON. Les webhooks intégrés de Level (Paramètres → Webhooks) envoient une charge utile fixe et n'ajoutent qu'un X-Level-Signature en-tête, donc les alertes sont envoyées à AlgaPSA via une automatisation avec une Requête HTTP action à la place, qui vous permet de définir des en-têtes et un corps personnalisés.

Dans AlgaPSA, ouvrez la Webhook d'alerte carte et copiez les trois valeurs qu'elle vous fournit : le URL du webhook, le En-tête nom et secret (l'icône œil révèle le secret), et le Modèle de charge utile.

Dans Level :

Accédez à Automatisations et créez une nouvelle automatisation, par exemple «Ticket d'alerte AlgaPSA».
Dans le pipeline, cliquez sur + et sélectionnez Requête HTTP de la catégorie Autre.
Remplissez l'action :
- URL: l'URL du webhook AlgaPSA
- Méthode: POST
- Type de contenu: application/json
- Corps: le modèle de charge utile d'AlgaPSA, collé tel quel
- En-têtes: cliquez sur + Ajouter des en-têtes de requête et ajoutez X-Alga-Webhook-Secret avec la valeur du secret
Enregistrez l'automatisation.

An automation in edit mode with an HTTP request action panel open, showing the URL, Method POST, Content type application/json, Body, and a custom request header row

Pointez maintenant les moniteurs qui doivent ouvrir des tickets vers cette automatisation :

Ouvrez la politique de moniteur qui déclenche les alertes que vous souhaitez transformer en tickets (Politiques de moniteur dans la barre latérale).
Ouvrez un moniteur et trouvez la Remédiation section, «Exécuter les automatisations lorsque cette alerte se déclenche».
Sélectionnez votre automatisation AlgaPSA dans le Automatisation de remédiation sélecteur, puis enregistrez.
Répétez pour chaque moniteur dont les alertes doivent devenir des tickets.

A monitor in a monitor policy with the Remediation section visible

L'automatisation s'exécute contre l'appareil qui a déclenché l'alerte, de sorte que la requête contient les détails de cet appareil.

⚠️ AVERTISSEMENT : L'action de requête HTTP n'appelle que des adresses publiques. Si vous hébergez AlgaPSA sur une adresse privée ou de loopback, l'action échoue avec «Requête bloquée : impossible d'effectuer des requêtes vers des adresses privées ou de loopback.» Donnez à votre instance AlgaPSA un nom d'hôte HTTPS résolvable publiquement avant de connecter l'automatisation.

Remplissage des alertes existantes

Le webhook est le flux en direct. Pour récupérer les alertes qui existent déjà dans Level, ou pour rattraper un événement manqué, cliquez sur Remplir les alertes sur la carte Synchronisation & carte Mappages de groupes. Il n'y a pas d'interrogation planifiée.

Tester l'intégration

Confirmez que la carte Connexion Level dans AlgaPSA affiche Connectée avec un horodatage récent.
Vérifiez ponctuellement la liste des actifs d'un client dans AlgaPSA par rapport à son groupe Level.
Déclenchez une alerte de test dans Level sur un moniteur auquel vous avez attaché l'automatisation.
Confirmez qu'un ticket apparaît dans AlgaPSA et est acheminé via vos règles d'alerte.

Si aucun ticket n'apparaît, ouvrez l'exécution de l'automatisation pour cet appareil et lisez la sortie de l'action de requête HTTP. Elle enregistre la réponse, par exemple HTTP 401 - Unauthorized pour un secret incorrect ou HTTP 404 - Not Found pour une URL mal saisie. Vérifiez ensuite :

Le nom de l'en-tête est exactement X-Alga-Webhook-Secret et le secret ne contient pas d'espaces supplémentaires.
L'URL du webhook a été copiée en entier.
Le groupe de l'appareil en alerte est mappé à un client dans AlgaPSA.
Le moniteur liste bien votre automatisation sous Remédiation.

Gestion continue

Rotation de la clé : créez une nouvelle clé API dans Level, collez-la dans AlgaPSA, testez la connexion, puis supprimez l'ancienne clé. La suppression d'une clé prend effet immédiatement, effectuez donc les opérations dans cet ordre.
Ajouter des groupes ou des appareils : exécutez Découvrir les groupes après avoir ajouté des groupes dans Level, et Lancer la synchronisation des appareils pour transférer les nouveaux appareils.
Suspendre la création de tickets : désactivez l'automatisation Level, ou supprimez-la du champ Remédiation champ pour arrêter uniquement les alertes de ce moniteur.
Changer le secret : mettez à jour la valeur de l'en-tête dans l'automatisation Level chaque fois que vous le régénérez dans AlgaPSA.

FAQ

Dois-je activer AlgaPSA sur la page Intégrations de Level ? Non. Paramètres → Intégrations dans Level couvre ConnectWise PSA, HaloPSA, Zest, Hudu et DeskDay. AlgaPSA se connecte via l'API Level et une automatisation, il n'y a donc rien à activer là-bas.
La clé API est-elle en lecture seule ou en lecture et écriture ? Lecture seule. AlgaPSA lit les groupes, les appareils et les alertes depuis Level et n'écrit rien en retour. Si un test de connexion ou une synchronisation échoue avec une erreur de permissions, consultez Nine Minds avant d'élargir la clé.
Puis-je utiliser Paramètres → Webhooks à la place d'une automatisation ? Pas pour AlgaPSA. Les webhooks de Level ne peuvent pas ajouter un en-tête personnalisé, et AlgaPSA exige X-Alga-Webhook-Secret sur chaque requête. C'est l'action de requête HTTP à l'intérieur d'une automatisation qui l'envoie.
La clôture d'un ticket dans AlgaPSA résout-elle l'alerte Level ? La documentation d'AlgaPSA couvre le sens Level vers AlgaPSA (alertes ouvrant des tickets). Renseignez-vous auprès de Nine Minds concernant le comportement de clôture de tickets de leur côté.
Quels appareils sont synchronisés dans AlgaPSA ? Les appareils des groupes que vous avez mappés à un client, ainsi que les appareils des sous-groupes qui héritent d'un parent mappé. Les branches non mappées sont ignorées.
Les actifs AlgaPSA existants sont-ils écrasés ? La synchronisation des appareils est pilotée depuis AlgaPSA. Consultez leur Intégration Level RMM documentation et Fonctionnement des intégrations RMM dans AlgaPSA documentation sur la façon dont ils font correspondre et mettent à jour les actifs.
Qui peut effectuer cette configuration ? Un administrateur Level (pour la clé API et l'automatisation) et un utilisateur AlgaPSA avec accès aux paramètres d'administration.