Déclencheurs
Comment les workflows démarrent — manuellement, via le chat, l'API, un planning, un webhook, la voix ou un déclencheur spécifique à un vendeur issu d'une intégration installée.
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
Le point d'entrée par défaut. Exécutez manuellement depuis l'éditeur, exposez une interface de chat ou appelez via API depuis un bloc unifié.
Exécutez selon une expression cron ou un intervalle simple (toutes les N minutes, toutes les heures, quotidien, hebdomadaire, mensuel).
Exécutez lorsqu'un système externe poste une requête POST sur une URL générée par Scrydon.
Enregistrez de l'audio, transcrivez avec un modèle de reconnaissance vocale (speech-to-text) et exposez le contexte pertinent de la base de connaissances.
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
| Question | Déclencheur à utiliser |
|---|---|
| Un utilisateur démarre-t-il le workflow explicitement ? | Démarrer (manuel ou chat) |
| S'exécute-t-il selon une horloge ? | Planification |
| Un système externe signale-t-il « lancez-moi » ? | Webhook (générique) ou déclencheur vendeur |
| L'utilisateur interagit-il avec le workflow de façon conversationnelle ? | Démarrer en mode chat |
| L'utilisateur parle-t-il au workflow ? | Voix |
| Un visiteur remplit-il un formulaire ou discute-t-il sur une page ? | Form ou Chat |
| Le workflow est-il appelé par un autre workflow ? | Bloc Workflow dans le parent (aucun déclencheur distinct nécessaire) |
Plusieurs déclencheurs dans un workflow
Un workflow peut avoir autant de déclencheurs que vous voulez, de n'importe quel type : plusieurs déclencheurs Start, plusieurs déclencheurs API, et des déclencheurs Chat ou Form à côté de déclencheurs Schedule, Webhook ou API. Deux règles demeurent :
- Un déclencheur ne peut pas se trouver dans un bloc Loop ou Parallel.
- L'ancien bloc Starter ne peut pas cohabiter avec les déclencheurs actuels. Remplacez-le d'abord par un déclencheur Start.
Chaque exécution part d'un seul déclencheur et n'exécute que la branche de ce déclencheur. Les blocs qui n'en sont pas atteignables ne s'exécutent pas, et <start> est ce déclencheur. Dans l'éditeur, Run part du déclencheur que vous choisissez :
- Le bouton Run porte le nom du déclencheur sélectionné, par exemple Run: Webhook.
- Le chevron à côté du bouton ouvre un groupe Trigger pour en choisir un autre. Le choix est mémorisé pour le workflow.
- La fenêtre d'exécution a une liste Trigger en haut.
- Un déclencheur sans connexion sortante affiche Not connected et ne peut pas être exécuté.
- Avec un seul déclencheur, rien ne change : Run part de lui.
Les versions précédentes exécutaient les branches de tous les déclencheurs quand vous appuyiez sur Run ou appeliez l'API sans en désigner un, et prenaient l'entrée du premier déclencheur du canevas. Un workflow construit sur ce comportement n'exécute désormais que la branche du déclencheur choisi. Reliez les branches voulues à un seul déclencheur, ou choisissez chaque déclencheur à tour de rôle.
Un appel d'API désigne son déclencheur avec triggerBlockId. Voir choisir le déclencheur. Une réexécution d'une exécution passée garde le déclencheur de l'exécution d'origine.
Un déclencheur Chat ou Form ne démarre une exécution que par son propre lien ou sa propre page : on le teste donc depuis le menu Run, par son lien de test (voir Chat et Form). Un appel d'API peut démarrer un déclencheur Start, API, Manual ou Schedule, mais jamais un Webhook, un déclencheur de fournisseur, un Chat ni un Form.
Un Chat ou un Form en production s'exécute avec le compte de service Run as du workflow, jamais avec une personne. Dès qu'un workflow a un déclencheur Chat ou Form, il a besoin de ce compte, et les autres déclencheurs du workflow (Schedule, Webhook, API) s'exécutent eux aussi avec ce compte. L'éditeur l'indique dans les paramètres de l'interface.
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 :
| Déclencheur | Variables |
|---|---|
| Démarrer (manuel / API) | <start.input>, <start.fieldName> (champs d'entrée personnalisés) |
| Démarrer (chat) | <start.input> (message utilisateur), <start.conversationId>, <start.files> |
| Planification | Pas de variables de sortie — utilisez les sorties des blocs suivants |
| Webhook | <webhook1.body>, <webhook1.headers>, <webhook1.method>, <webhook1.query> |
| Voix | <voice1.transcript>, <voice1.audioUrl>, <voice1.language>, <voice1.duration> |
| Déclencheur vendeur | Champs d'événement spécifiques au vendeur, entièrement typés |
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 :
| Environnement | Le déclencheur s'exécute contre | Déploiement requis ? |
|---|---|---|
| Tout environnement modifiable | Le workflow live/brouillon — exactement ce qui est sur le canevas | Non — testez les webhooks, appels API et chat au fil de la construction |
| Tout environnement en lecture seule | L'instantané déployé — la version de déploiement active | Oui — une version de déploiement active |
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.