Triggers et webhooks
Les triggers permettent à un événement dans l'un de vos outils — un message Slack, une pull request GitHub, une mise à jour de page Notion — de démarrer une exécution de workflow dans Studio. Vous enregistrez un webhook pour un fournisseur, collez son URL dans les paramètres du fournisseur, puis y attachez un ou plusieurs triggers. Chaque trigger indique les événements auxquels il réagit et ce qu'il exécute.
La plateforme gère la vérification des signatures, la déduplication, les nouvelles tentatives de livraison et le suivi du statut de chaque événement : vous choisissez seulement un webhook, un filtre facultatif et ce qu'il faut exécuter.
Comment fonctionnent les triggers
| Terme | Définition |
|---|---|
| Webhook | Un point de terminaison enregistré pour un fournisseur, avec son secret de signature. Son URL a la forme https://webhooks.mistral.ai/providers/{provider}/sources/{webhook_id}. |
| Trigger | Une règle attachée à un webhook : un filtre facultatif plus une action à exécuter quand un événement correspond. |
| Fournisseur | L'outil en amont qui envoie les événements : Slack, GitHub, Notion, Linear, Lucca ou Ashby. |
| Type d'événement | Une chaîne propre au fournisseur dérivée de chaque livraison, par exemple push pour GitHub ou app_mentioned pour Slack. Les filtres s'appuient généralement dessus. |
| Filtre | Une expression JMESPath évaluée sur le corps JSON de l'événement. Sans filtre, chaque événement correspond. |
| Type de propriétaire | workspace (visible dans tout l'espace de travail) ou user (visible uniquement par son créateur). Un trigger doit avoir le même type de propriétaire que son webhook. |
Un workflow déclenché s'exécute sous l'identité de l'utilisateur qui a créé le trigger. Les triggers ne peuvent pas démarrer de workflows on-behalf-of.
Chaque livraison est suivie comme un événement de trigger avec un statut — soumis, déclenché ou échoué — pour voir quels événements ont atteint leur cible.
Pour démarrer un workflow à partir d'un webhook, consultez Triggers et webhooks pour les workflows.
Bientôt disponible
Les triggers démarrent actuellement des exécutions de workflow. D'autres actions arrivent bientôt, comme le démarrage de sessions d'agent et le déploiement d'apps.