Le déclencheur webhook permet à tout 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 les outils qui prennent en charge les webhooks sortants — plates-formes PSA, systèmes de surveillance, scripts externes, ou tout ce 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 automatisations. Si vous pouvez voir l'automatisation mais ne pouvez pas ajouter de déclencheurs, vérifiez les permissions du rôle auprès de votre administrateur. Consultez Espace de travail → Permissions pour plus de détails.
Déclencheur Webhook
Génération de l'URL Webhook
L'URL 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 : Supprimer 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 l'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 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: ..." quand cette option est activée. Copiez la commande cURL complète à 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 possédant la clé peuvent déclencher l'automatisation.
Mappage des paramètres
Mappez les clés de la charge utile 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 utile JSON entrante (par exemple,
device_id,ticket_number)Variables d'automatisation — Le nom de la variable à mapper dans la canalisation 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 que votre système externe envoie dans la charge utile webhook — numéros de ticket, identifiants de client, métadonnées d'appareil, n'importe quoi — et référencez-la dans les actions de script ou les messages de notification plus loin dans la canalisation.
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 lorsque le webhook se déclenche.
Pour la référence complète des conditions, consultez Conditions de déclenchement.
Options supplémentaires
Développez Options supplémentaires pour définir un Nom du déclencheur optionnel et basculer le déclencheur avec le commutateur Activé.
Nom du déclencheur — Remplace l'étiquette par défaut sur la carte de déclenchement de la canalisation.
Activé — Quand 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 webhook après avoir enregistré le déclencheur ? Ouvrez l'automatisation en mode édition et cliquez sur la carte de déclenchement webhook. L'URL s'affiche dans la section Configuration des étapes avec un bouton Copier.
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 à 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 exécution active par déclencheur à la fois. Si le webhook se déclenche à nouveau alors que cet appareil s'exécute déjà, la nouvelle requête est ignorée pour cet appareil. Si l'appareil n'est actuellement pas dans une exécution, il se déclenche normalement.
Quel format la charge utile du webhook doit-elle avoir ? JSON. Envoyez un corps JSON avec les clés que vous souhaitez mapper aux 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 sur leur rôle, plus l'accès au groupe d'automatisation. Si une automatisation n'a pas encore de déclencheurs, tout utilisateur ayant accès au groupe peut ajouter le premier.