Introduction
Le déclencheur webhook permet à n'importe quel système externe de déclencher 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 qui prennent en charge les webhooks sortants — plates-formes PSA, systèmes de surveillance, scripts externes ou n'importe quoi qui peut faire un appel HTTP.
ℹ️ REMARQUE : L'ajout de déclencheurs non manuels nécessite soit le statut d'administrateur, soit un rôle avec la permission Gérer les automations . 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 Workspace → Permissions pour les détails.
Déclencheur Webhook
Génération de l'URL Webhook
L'URL webhook est créée quand vous enregistrez le déclencheur — elle n'existe pas avant. Cliquez sur Enregistrer et Level génère un jeton unique lié à ce déclencheur.
⚠️ AVERTISSEMENT : Supprimer ce déclencheur supprime également le jeton unique. N'importe quel système externe pointant vers cette URL cessera de fonctionner immédiatement. Si vous avez besoin de 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 basée sur un jeton au point de terminaison. Quand activé, 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 ci-dessous l'URL se met à jour automatiquement pour inclure l'en-tête -H "Authorization: ..." quand 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.
💡 ASTUCE : Activez l'en-tête d'autorisation pour n'importe quel point de terminaison webhook accessible depuis l'internet public. Cela garantit que seuls les systèmes avec la clé peuvent déclencher l'automatisation.
Mappage des Paramètres
Mapez les clés de la charge JSON entrante aux variables d'automatisation afin que vos actions et scripts puissent utiliser ces données.
Chaque ligne de mappage a deux champs :
Clé de paramètre — Un nom de clé de la charge JSON entrante (par exemple,
device_id,ticket_number)Variables d'automatisation — Le nom de 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 qui peut être référencée dans les actions en aval et les scripts.
💡 ASTUCE : Mapez n'importe quelle valeur que votre système externe envoie dans la charge webhook — numéros de ticket, identifiants client, métadonnées de l'appareil, n'importe quoi — et référencez-le 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 limitez la portée pour cibler des appareils spécifiques quand le webhook se déclenche.
Pour la référence de condition complète, voir Conditions de Déclencheur .
Options Supplémentaires
Développez Options supplémentaires pour définir un Nom du déclencheur optionnel et basculer le déclencheur activé ou désactivé avec le commutateur Activé .
Nom du déclencheur — Remplace l'étiquette par défaut sur la carte de déclencheur du pipeline.
Activé — Quand désactivé, le déclencheur ne se déclenchera pas même si l'URL reçoit une requête valide.
FAQ
Où puis-je trouver l'URL webhook après avoir déjà enregistré le déclencheur ? Ouvrez l'automatisation en mode édition et cliquez sur la carte de déclencheur webhook. L'URL s'affiche dans la section de configuration des étapes avec un bouton Copier .
Quelle méthode HTTP le webhook attend-il ? GET et POST sont tous les 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. N'importe quelle requête valide à 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 pendant qu'un appareil est déjà dans une exécution active ? Un appareil ne peut être que dans une exécution active par déclencheur à la fois. Si le webhook se déclenche à nouveau pendant que cet appareil s'exécute déjà, la nouvelle requête est ignorée pour cet appareil. Si l'appareil n'est pas actuellement dans une exécution, il se déclenche normalement.
Quel format la charge webhook doit-elle avoir ? JSON. Envoyez un corps JSON avec les clés que vous voulez mapper à des variables d'automatisation.
Qui peut ajouter ou modifier les 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 automations sur leur rôle, plus l'accès au groupe de l'automatisation. Si une automatisation n'a pas encore de déclencheurs, n'importe quel utilisateur ayant accès au groupe peut ajouter le premier.