Introduction
AlgaPSA reflète votre configuration Level du côté PSA : les groupes Level correspondent aux clients AlgaPSA, les appareils des groupes mappés sont synchronisés dans les actifs, et les alertes Level ouvrent des tickets via les règles d'alerte d'AlgaPSA.
La configuration s'étend sur les deux plateformes. Dans Level, vous créez une clé API et configurez la livraison des alertes à l'aide de webhooks natifs ou d'une automatisation, selon votre version d'AlgaPSA. Dans AlgaPSA, vous collez la clé, mappez les groupes et exécutez la synchronisation des appareils.
ℹ️ REMARQUE : Cette intégration a été créée et est maintenue par Nine Minds, les concepteurs d'AlgaPSA. Pour la configuration côté AlgaPSA, consultez leur documentation : Intégration Level RMM. Il s'agit d'une fonctionnalité AlgaPSA Enterprise Edition.
⚙️ PRÉREQUIS
Accès administrateur Level (pour créer une clé API et configurer les webhooks ou une automatisation)
Un compte AlgaPSA Enterprise Edition avec accès aux paramètres d'administration
Votre instance AlgaPSA accessible à 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 de groupes, synchronisation des appareils, remplissage rétroactif des alertes) est une lecture, donc une clé en lecture seule suffit.
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 Connectée et affiche l'heure de connexion.
Mapper les groupes et synchroniser les appareils
Le mappage s'effectue entièrement dans AlgaPSA, sur la Synchronisation & Mappages de groupes carte.
Cliquez sur Découvrir les groupes. AlgaPSA importe votre hiérarchie de groupes Level dans le tableau de mappage.
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 Exécuter 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 mappage propre utilise le parent mappé le plus proche, donc mapper un groupe de niveau supérieur d'un client couvre généralement l'ensemble de son arborescence.
Les groupes non mappés sont ignorés. Les appareils d'un groupe sans mappage 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
Choisissez la méthode prise en charge par votre installation AlgaPSA. Si la page d'intégration Level affiche Webhook natif (recommandé) avec un Secret de signature, suivez les étapes du webhook natif ci-dessous. S'il affiche seulement un Webhook d'alerte avec un en-tête personnalisé et un modèle de charge utile, utilisez le mécanisme de secours par automatisation.
Disponibilité de la version, vérifiée le 30 octobre 2026 : La prise en charge des webhooks signés natifs a été fusionnée dans la branche principale d'AlgaPSA le 17 octobre 2026 dans PR #3761. La dernière version publiée, v1.6.0 (17 septembre 2026), ne l'inclut pas. Les déploiements hébergés et auto-hébergés peuvent différer. Confirmez que votre version prend en charge les webhooks natifs auprès de Nine Minds avant de changer ; une fusion dans la branche principale ne confirme pas la disponibilité sur votre installation.
Option 1 : Webhooks natifs pour les versions prises en charge
Dans les paramètres d'intégration Level d'AlgaPSA, ouvrez Webhook natif (recommandé).
Copiez le URL du webhook, y compris son paramètre de requête de locataire, et le Secret de signature affiché sur cette carte.
Dans Level, accédez à Paramètres → Webhooks et cliquez sur + Ajouter un webhook (ou + Créer un webhook si la liste est vide).
Collez l'URL AlgaPSA dans URL et son secret de signature dans Secret.
Sous Événements à envoyer, sélectionnez Alerte active (
alert_active) et Alerte résolue (alert_resolved).Laissez Activé activé et cliquez sur Ajouter un webhook.
Testez la création et la résolution d'alertes à l'aide des vérifications ci-dessous.
Level signe ces requêtes avec X-Level-Signature, qu'AlgaPSA vérifie. Les webhooks natifs utilisent la charge utile standard de Level, vous n'avez donc pas besoin d'ajouter un en-tête personnalisé, de coller un modèle de charge utile ou d'associer une automatisation HTTP à chaque moniteur. Les mappages de groupes et les règles d'alerte d'AlgaPSA contrôlent la façon dont les alertes entrantes sont traitées.
Voir Paramètres des webhooks pour la configuration et les journaux de livraison.
Option 2 : Mécanisme de secours par requête HTTP d'automatisation
Utilisez cette méthode pour v1.6.0, les installations plus anciennes ou lorsque les webhooks natifs ne sont pas disponibles. Elle envoie le modèle de charge utile d'AlgaPSA avec le X-Alga-Webhook-Secret en-tête.
Dans AlgaPSA, ouvrez la Webhook d'alerte carte (appelée Mécanisme de secours : requête HTTP d'automatisation sur les versions plus récentes) et copiez les trois valeurs qu'il vous fournit : le URL du webhook, le En-tête nom et secret (l'icône en forme d'œ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 Ajouter une action et sélectionnez Requête HTTP depuis la Autre catégorie.
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-Secretavec la valeur du secret
Cliquez sur Enregistrer dans le panneau latéral de l'action.
Maintenant, orientez les moniteurs qui doivent ouvrir des tickets vers cette automatisation :
Ouvrez la politique de moniteur qui génère 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.
L'automatisation s'exécute sur 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 auto-hébergez AlgaPSA sur une adresse privée ou de bouclage, l'action échoue avec «Requête bloquée : impossible d'effectuer des requêtes vers des adresses privées ou de bouclage.» Donnez à votre instance AlgaPSA un nom d'hôte HTTPS publiquement résolvable avant de configurer l'automatisation.
Passer d'une automatisation aux webhooks natifs
Confirmez d'abord la prise en charge des webhooks natifs sur votre installation AlgaPSA. Configurez le webhook, puis testez une nouvelle alerte et sa résolution sur un appareil mappé. Vérifiez les journaux de livraison et l'alerte et le ticket AlgaPSA résultants avant de basculer le reste de vos moniteurs.
Une fois la livraison native fonctionnelle, désactivez l'ancienne automatisation de transfert AlgaPSA ou supprimez cette automatisation des Remédiation sélections. Conservez toutes les actions de remédiation sans rapport. Évitez de laisser les deux méthodes de transfert activées pour les mêmes alertes, car elles peuvent créer des tickets en double.
Remplissage rétroactif des alertes existantes
Le webhook est le flux en direct. Pour récupérer des alertes qui existent déjà dans Level, ou pour rattraper un événement manqué, cliquez sur Remplissage rétroactif des alertes sur la carte de synchronisation d'AlgaPSA & carte de mappages de groupes. Il n'y a pas de sondage planifié des alertes Level ; ceci est distinct de tout calendrier de synchronisation des appareils disponible dans votre version d'AlgaPSA.
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 appareil d'un groupe mappé. Pour le mécanisme de secours par automatisation, utilisez un moniteur auquel l'automatisation de transfert est associée.
Confirmez que l'alerte atteint AlgaPSA et qu'un ticket est créé lorsqu'une règle d'alerte correspondante le requiert. Pour les webhooks natifs, résolvez l'alerte de test dans Level et confirmez que l'événement résolu atteint AlgaPSA.
Webhooks natifs : Ouvrez Paramètres → Webhooks → Requêtes dans Level. Inspectez l'URL de destination, le statut de livraison, la réponse HTTP et le corps de la réponse. En cas d'erreur de signature, assurez-vous que le Secret correspond au Secret de signature sur la carte native d'AlgaPSA.
En cas d'erreur d'URL, recopiez l'URL complète, y compris le paramètre de locataire. Confirmez que les deux événements d'alerte sont sélectionnés et que le point de terminaison est accessible publiquement. Après avoir corrigé une livraison échouée, utilisez Relancer la requête pour le renvoyer, puis confirmez qu'il n'a pas créé de ticket en double.
Résolution de ticket : La réception d'un alert_resolved L'événement ne garantit pas la fermeture d'un ticket. La fermeture automatique dépend du paramètre de résolution automatique de la règle d'alerte AlgaPSA et de l'existence d'une activité humaine sur le ticket. Confirmez le comportement pour vos règles et votre version auprès de Nine Minds.
Mécanisme de secours par automatisation : 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 mauvais secret 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-Secretet 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, donc faites-le dans cet ordre.
Ajouter des groupes ou des appareils : exécutez Découvrir les groupes après avoir ajouté des groupes dans Level, et Exécuter la synchronisation des appareils pour transférer les nouveaux appareils.
Suspendre le transfert des alertes : pour les webhooks natifs, désactivez Activé désactivé sur le webhook dans Level. Pour le mécanisme de secours, désactivez l'automatisation de transfert ou supprimez-la de la Remédiation champ.
Changer le secret : pour les webhooks natifs, régénérez le secret de signature dans AlgaPSA et mettez à jour le Secret dans Level, puis testez la livraison. Pour le mécanisme de secours, mettez à jour le
X-Alga-Webhook-Secreten-tête chaque fois que vous régénérez son secret partagé dans AlgaPSA. Utilisez le secret correspondant à la méthode que vous avez configurée.
FAQ
Dois-je activer AlgaPSA sur la page Intégrations de Level ? Non. AlgaPSA se connecte via l'API Level ainsi que via des webhooks natifs ou une automatisation, il n'y a donc pas de bascule AlgaPSA à activer sur la Paramètres → Intégrations page.
Lecture seule ou lecture et écriture pour la clé API ? La lecture seule est suffisante pour la découverte de groupes, la synchronisation des appareils, le remplissage rétroactif des alertes et la configuration des alertes entrantes décrite ici. Les fonctionnalités optionnelles d'AlgaPSA qui écrivent dans Level peuvent avoir des exigences différentes. Confirmez la fonctionnalité prise en charge et les autorisations requises auprès de Nine Minds avant d'élargir la clé.
Puis-je utiliser Paramètres → Webhooks à la place d'une automatisation ? Oui, lorsque votre version d'AlgaPSA prend en charge les webhooks signés natifs et affiche la Webhook natif (recommandé) carte. Suivez l'option 1 ci-dessus. Les récepteurs v1.6.0 et plus anciens nécessitent encore le mécanisme de secours par automatisation avec
X-Alga-Webhook-Secret.La fermeture d'un ticket dans AlgaPSA résout-elle l'alerte Level ? Ce guide configure la livraison des alertes de Level vers AlgaPSA. Les actions de fermeture de ticket qui écrivent dans Level dépendent de votre version d'AlgaPSA, de vos paramètres et des autorisations API. Demandez à Nine Minds comment activer et tester ce comportement pour votre installation.
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 pour savoir comment les actifs sont mis en correspondance et mis à jour.
Qui peut effectuer cette configuration ? Un administrateur Level (pour la clé API et les webhooks ou l'automatisation) et un utilisateur AlgaPSA avec accès aux paramètres d'administration.