Déclencheurs

Chaque exécution de workflow démarre depuis un déclencheur. Choisissez le bon déclencheur pour la situation et le reste du workflow peut rester identique.

Déclencheurs intégrés

Déclencheurs spécifiques aux vendeurs

Au-delà des déclencheurs intégrés, de nombreuses intégrations contribuent les leurs :

• GitHub — pull request ouverte, commentaire sur une issue, push, exécution de workflow terminée.
• Microsoft Graph — e-mail reçu, événement de calendrier, modification de fichier SharePoint.
• Atlassian — issue Jira créée ou mise à jour, page Confluence modifiée.
• Google — message Gmail reçu, événement Google Calendar créé.

Les options de déclenchement de chaque vendeur apparaissent dans le sélecteur de déclencheurs une fois que l'intégration du vendeur est installée. Consultez Vendeurs pour le catalogue complet.

Choisir un déclencheur

Payload du déclencheur

Chaque déclencheur produit un payload d'entrée accessible via des références de variables dans les blocs en aval :

Le préfixe de variable (start, webhook1, voice1, etc.) correspond au nom de bloc que vous assignez dans l'éditeur de workflow.

<start> désigne le déclencheur qui s'est activé

<start> désigne toujours le déclencheur qui a démarré cette exécution, quel que soit le nom de ce déclencheur. C'est la forme portable, et la seule qui fonctionne dans un workflow comportant plusieurs déclencheurs.

C'est important, car une exécution a exactement un déclencheur. Si un workflow a quatre déclencheurs et qu'une alerte arrive sur l'un d'eux, seul celui-ci a un nom pendant la durée de l'exécution. Une référence à l'un des trois autres ne se résout en rien :

// ❌ Breaks whenever a different trigger fires — and they take turns.
const raw = <claudestatus.body> || <signoz.body> || <generic.body>;

// ✅ One reference, correct for every trigger.
const start = <start>;
const raw = start.body !== undefined ? start.body : start.payload;

Ne nommez un déclencheur directement que lorsque le workflow n'en a qu'un, ou lorsque vous voulez délibérément une valeur présente pour un déclencheur et absente pour les autres. Dans du code, une référence qui ne se résout en rien devient undefined, de sorte que <a.body> || <b.body> || {} choisit celui qui s'est activé. Dans du texte, elle reste visible telle qu'écrite afin que vous puissiez voir qu'elle ne s'est pas résolue.

Environnements et tests

Les workflows vivent dans un environnement d'espace de travail. Les noms d'environnements sont définis par les utilisateurs et chaque environnement est configuré comme modifiable ou en lecture seule. Développement, Staging et Production constituent une convention fréquente, mais ces noms n'ont aucun comportement intégré.

Les déclencheurs s'activent dans chaque environnement — ce qui change, c'est quelle version du workflow s'exécute :

Cela signifie que vous pouvez appeler un webhook (ou le déclencheur API/chat) sur un workflow dans tout environnement modifiable pour le tester de bout en bout avant de le promouvoir. Dans un environnement en lecture seule, le même déclencheur exécute l'instantané déployé plutôt que le brouillon. Chaque environnement possède sa propre URL de déclenchement.

La promotion d'un workflow crée toujours un instantané de déploiement dans l'environnement cible, de sorte qu'un workflow promu est prêt à s'exécuter, que l'environnement soit modifiable ou en lecture seule.

Passer un environnement en lecture seule

Passer un environnement en lecture seule change la version qu'exécute chaque workflow qu'il contient : du brouillon live à l'instantané déployé. Un workflow qui n'a aucune version de déploiement à ce moment-là — par exemple un workflow créé directement dans l'environnement alors qu'il était encore modifiable — cesse de répondre aux déclencheurs avec 403 et le code WORKFLOW_NOT_DEPLOYED.

La colonne Exécution de la page Monitor l'indique pour chaque workflow : Live (brouillon) dans un environnement modifiable, Déployé lorsqu'un instantané existe, et Non déployé — déclencheurs bloqués lorsqu'il manque. Utilisez l'action Déployer de la ligne pour créer l'instantané sur place ; les URL de webhook ne changent pas.

Liens connexes

• Exécution — ce qui se passe une fois le déclencheur activé.
• Automatisations — jobs mono-agent avec déclencheurs de planification ou webhook.
• Vendeurs — le catalogue des intégrations installables et leurs déclencheurs.