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 à 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 le statut d'administrateur, soit un rôle disposant de la 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.
Utilisez une clé API avec droits d'écriture disposant d'un accès Lecture et écriture l'accès depuis la même organisation Level que le déclencheur webhook. Une clé en lecture seule est rejetée avec HTTP 403 : This API key does not have write permissions.
Si vous ne disposez pas d'une clé avec droits d'écriture, créez-en une ou modifiez une clé existante sous Paramètres → Clés API. Voir Paramètres des clés API.
La commande cURL sous l'URL se met à jour automatiquement pour inclure l' -H "Authorization: ..." en-tête 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 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 et scripts en aval.
💡 CONSEIL : Mappez toute 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 restreindre la portée pour cibler des appareils spécifiques lorsque le webhook se déclenche.
Pour la référence complète des conditions, voir Conditions de déclenchement.
Options supplémentaires
Développez Options supplémentaires pour définir un Nom du déclencheur et activez ou désactivez le déclencheur avec le Activé bouton.
Nom du déclencheur — Remplace le libellé par défaut sur la carte du déclencheur dans le pipeline.
Activé — Lorsqu'il est désactivé, le déclencheur ne se lance 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 le Pipeline, sélectionnez le déclencheur webhook enregistré, puis cliquez sur Modifier le déclencheur. Dans le formulaire de configuration, cliquez sur Copier à côté de l'URL du webhook.
Quelle méthode HTTP le webhook attend-il ? GET et POST sont tous deux acceptés.
Puis-je utiliser la même URL de 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 se trouver 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, il se déclenche 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 administrateurs peuvent toujours ajouter des déclencheurs. Les utilisateurs non administrateurs ont besoin de la Gérer les automatisations permission sur leur rôle, ainsi que l'accès au groupe de l'automatisation. Si une automatisation n'a pas encore de déclencheurs, tout utilisateur ayant accès au groupe peut en ajouter le premier.