Déclencheurs web

Un déclencheur web lance une consigne quand un autre service effectue une requête sur l’URL fournie. Contrairement à une tâche planifiée, il réagit à un événement : nouvelle commande, formulaire reçu ou changement de statut.

Créer un déclencheur

1. Ouvrez Agent → Tâches → Déclencheurs (événements).
2. Donnez-lui un nom stable, par exemple Nouvelle commande.
3. Rédigez la consigne que l’agent devra exécuter.
4. Si utile, indiquez les noms d’événements attendus, séparés par des virgules.
5. Choisissez une livraison dans le portail ou sur Telegram.
6. Enregistrez.

Diadems affiche alors une URL et un secret propres au déclencheur.

Connecter le service émetteur

Configurez le service externe pour envoyer une requête POST à l’URL affichée. Pour une intégration générique :

1. calculez le HMAC-SHA256 du corps brut avec le secret ;
2. encodez le résultat en hexadécimal ;
3. placez-le dans l’en-tête X-Webhook-Signature ;
4. envoyez le même corps, sans le modifier après le calcul.

X-Webhook-Signature: <empreinte HMAC-SHA256 hexadécimale>
Content-Type: application/json

Les intégrations GitHub, GitLab ou Svix peuvent utiliser leurs en-têtes de signature natifs.

Le secret est confidentiel

Ne placez jamais le secret dans une page publique, un ticket ou une capture d’écran. Une personne qui le possède peut tenter de déclencher votre agent.

Tester et exploiter

Le bouton Tester envoie un événement signé de contrôle. Vérifiez ensuite le résultat dans Sessions ou sur Telegram, selon la livraison choisie.

La charge utile de l’événement donne à l’agent le contexte de l’action. La consigne reste la règle principale : soyez explicite sur les contrôles à faire et sur le résultat attendu.

Supprimez un déclencheur qui n’est plus utilisé. Son URL et son secret cessent alors d’être valides.