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 un 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 accès en écriture disposant de 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 accès en é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'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é provenant 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 toute valeur envoyée par votre système externe dans le payload du webhook — numéros de ticket, identifiants client, métadonnées d'appareil, 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 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 commutateur Activé le commutateur.
Nom du déclencheur — Remplace l'étiquette par défaut sur la carte de déclencheur du pipeline.
Activé — Lorsque 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 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 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 envoyée à 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 actuellement dans une 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 encore aucun déclencheur, tout utilisateur ayant accès au groupe peut ajouter le premier.