Introduction

Le déclencheur webhook permet à tout système externe de lancer une automatisation Level via une requête HTTP. Lorsque vous enregistrez ce déclencheur, Level génère une URL unique. Envoyez une requête POST à cette URL et l'automatisation s'exécute.

Utilisez-le pour intégrer Level avec des outils prenant en charge les webhooks sortants — plateformes PSA, systèmes de surveillance, scripts externes, ou tout ce qui peut effectuer un appel HTTP.

ℹ️ REMARQUE : L'ajout de déclencheurs non manuels nécessite soit un statut d'administrateur, soit un rôle disposant de la permission Gérer les automatisations permission. Si vous pouvez voir l'automatisation mais ne pouvez pas ajouter de déclencheurs, vérifiez les permissions de votre rôle auprès de votre administrateur. Voir Espace de travail → Permissions pour plus de détails.

Déclencheur Webhook

Génération de l'URL du Webhook

L'URL du webhook est créée lorsque vous enregistrez le déclencheur — elle n'existe pas avant cela. Cliquez sur Enregistrer et Level génère un jeton unique lié à ce déclencheur.

⚠️ AVERTISSEMENT : La suppression de ce déclencheur supprime également le jeton unique. Tout système externe pointant vers cette URL cessera de fonctionner immédiatement. Si vous devez régénérer le jeton, supprimez et recréez le déclencheur, puis mettez à jour l'URL dans votre système externe.

Exiger un en-tête d'autorisation

Cochez Exiger un en-tête d'autorisation pour ajouter une authentification par jeton au point de terminaison. Lorsque cette option est activée, les requêtes doivent inclure la clé d'autorisation dans l'en-tête de la requête — les requêtes non authentifiées sont rejetées.

La commande cURL sous l'URL se met à jour automatiquement pour inclure l'en-tête -H "Authorization: ..." lorsque cette option est activée. Copiez la commande cURL complète pour l'utiliser comme référence lors de la configuration de votre système externe.

💡 CONSEIL : Activez l'en-tête d'autorisation pour tout point de terminaison webhook accessible depuis l'internet public. Cela garantit que seuls les systèmes disposant de la clé peuvent déclencher l'automatisation.

Mappage des paramètres

Mappez les clés du payload JSON entrant vers des variables d'automatisation afin que vos actions et scripts puissent utiliser ces données.

Chaque ligne de mappage comporte deux champs :

Clé de paramètre — Un nom de clé issu du payload JSON entrant (ex. : device_id, ticket_number)
Variables d'automatisation — Le nom de la variable à mapper dans le pipeline d'automatisation

Cliquez sur + Ajouter un nouveau paramètre pour ajouter autant de mappages que nécessaire. Chacun crée une variable nommée pouvant être référencée dans les actions et scripts en aval.

💡 CONSEIL : Mappez n'importe quelle valeur envoyée par votre système externe dans le payload du webhook — numéros de tickets, identifiants clients, métadonnées d'appareils, ou autre — et référencez-la dans les actions de script ou les messages de notification plus loin dans le pipeline.

Condition

Vous devez sélectionner une condition pour enregistrer le déclencheur. Choisissez Tous les appareils ou restreignez la portée pour cibler des appareils spécifiques lors du déclenchement du webhook.

Pour la référence complète des conditions, voir Conditions des déclencheurs.

Options supplémentaires

Développez Options supplémentaires pour définir un Nom du déclencheur et activez ou désactivez le déclencheur à l'aide du Activé le bouton bascule.

Nom du déclencheur — Remplace le libellé par défaut sur la carte du déclencheur dans le pipeline.
Activé — Lorsque désactivé, le déclencheur ne se déclenche pas même si l'URL reçoit une requête valide.

FAQ

Où puis-je trouver l'URL du webhook après avoir déjà enregistré le déclencheur ? Ouvrez l'automatisation en mode édition et cliquez sur la carte du déclencheur webhook. L'URL est affichée dans la section de configuration de l'étape avec un bouton Copier le bouton.
Quelle méthode HTTP le webhook attend-il ? GET et POST sont tous deux acceptés.
Puis-je utiliser la même URL webhook pour déclencher l'automatisation plusieurs fois ? Oui. L'URL est persistante tant que le déclencheur existe. Toute requête valide vers cette URL déclenche l'automatisation, à condition que l'appareil ne soit pas déjà dans une exécution active pour ce déclencheur.
Que se passe-t-il si le webhook se déclenche alors qu'un appareil est déjà dans une exécution active ? Un appareil ne peut être que dans une seule exécution active par déclencheur à la fois. Si le webhook se déclenche à nouveau alors que cet appareil est déjà en cours d'exécution, la nouvelle requête est ignorée pour cet appareil. Si l'appareil n'est pas en cours d'exécution, le déclenchement s'effectue normalement.
Dans quel format le payload du webhook doit-il être ? JSON. Envoyez un corps JSON avec les clés que vous souhaitez mapper vers des variables d'automatisation.
Qui peut ajouter ou modifier des déclencheurs sur une automatisation ? Les utilisateurs administrateurs peuvent toujours ajouter des déclencheurs. Les utilisateurs non administrateurs ont besoin de la permission Gérer les automatisations permission sur leur rôle, ainsi que l'accès au groupe de l'automatisation. Si une automatisation ne possède pas encore de déclencheurs, tout utilisateur ayant accès au groupe peut en ajouter le premier.