Déclencheurs

Chaque graphe commence par exactement un nœud déclencheur. Un déclencheur n'exécute lui-même aucune logique, il décide seulement quand le reste du graphe reçoit une nouvelle exécution.

Aperçu rapide

1. Faites glisser un seul nœud déclencheur sur le canevas ; c'est le premier nœud et il n'a pas de connecteur d'entrée.
2. Configurez-le, s'il prend des champs (la cadence d'un calendrier, un dossier à surveiller).
3. Activez l'automatisation pour qu'elle commence à écouter ce déclencheur.
4. Ou sautez tout cela et appuyez sur Test à tout moment pour exécuter le graphe une fois, quel que soit le déclencheur.

Référence détaillée

Manuel

Manual start n'a aucun champ. C'est ce qu'utilise le bouton Test du constructeur : publier le brouillon actuel, puis mettre en file une exécution immédiatement.

Planifié

Scheduled se déclenche selon une cadence que vous définissez.

Champ	Options
Frequency	Interval, Daily, Weekly ou Cron
Every (minutes)	Utilisé uniquement en mode Interval
Cron expression	Utilisé uniquement en mode Cron ; une expression standard à 5 champs (minute heure jour-du-mois mois jour-de-la-semaine), par exemple 0 9 * * 1-5 pour les jours de semaine à 09:00
Timezone	Utilisé uniquement en mode Cron ; un nom IANA comme Europe/Istanbul. Laissé vide, l'expression est comparée à l'horloge propre du serveur

Une automatisation planifiée active est vérifiée selon un cycle récurrent en arrière-plan ; vous n'avez pas besoin de garder l'application ouverte. Les modes Interval, Daily et Weekly se déclenchent par rapport à la dernière date de déclenchement de l'automatisation. Le mode Cron conserve un pointeur « prochaine échéance » et rattrape une minute manquée (un déploiement, un redémarrage, un tick lent) en se déclenchant une fois dès qu'il s'en aperçoit, au lieu de perdre silencieusement cette occurrence ; il ne se déclenche jamais deux fois pour la même fenêtre manquée.

Webhook entrant

Incoming webhook donne à chaque automatisation une URL entrante unique, /api/workflow/hook/<automation id>, qui démarre une exécution lorsqu'elle est appelée par une requête GET ou POST. Elle ne se déclenche que tant que le statut de l'automatisation est Active.

Le constructeur n'affiche ni ne copie actuellement cette URL pour vous ; l'inspecteur du nœud ne comporte que le champ du secret HMAC. Pour l'utiliser, vous (ou un développeur de votre équipe) avez besoin de l'id de l'automatisation, que vous pouvez lire dans les requêtes réseau que l'application émet déjà pendant que le constructeur est ouvert, et le combiner vous-même avec le chemin fixe /api/workflow/hook/.

Événements de conception et d'espace de travail

Ceux-ci se déclenchent quand quelque chose se produit ailleurs dans l'application. Aujourd'hui, Design updated est raccordé pour se déclencher automatiquement chaque fois qu'une conception est enregistrée. Les autres sont disponibles à la configuration dès maintenant ; d'autres actions de l'application y seront reliées à mesure que ces surfaces seront développées.

Nœud	Se déclenche quand
Design created	Une nouvelle conception est créée
Design updated	Une conception est enregistrée
Design shared	Une conception est partagée ou publiée
Design downloaded	Une conception est téléchargée
Part tagged	Une étiquette est ajoutée à un élément (avec un filtre facultatif sur une seule étiquette)
Brand applied	Un kit de marque est appliqué à une conception
Asset uploaded	Un fichier est ajouté à la médiathèque
AI generation done	Une génération IA se termine
New work in folder	Un projet est ajouté à un dossier que vous choisissez

Le pont d'événements

N'importe quel type de déclencheur peut aussi être démarré via un appel API générique et authentifié, limité à votre espace de travail : un triggerType et une charge utile facultative. C'est ainsi que le hook de mise à jour de conception ci-dessus se déclenche en coulisses, et il est disponible pour que vos propres intégrations l'appellent de la même façon.

Plusieurs automatisations, un même type de déclencheur

Plusieurs automatisations actives peuvent utiliser le même type de déclencheur. L'enregistrement d'une conception, par exemple, peut démarrer d'un coup chaque automatisation active « Design updated » de votre espace de travail, chacune s'exécutant indépendamment avec son propre historique.

Comment l'utiliser

Pas à pas : un calendrier cron du matin en semaine

1. Faites glisser un déclencheur Scheduled sur un graphe vide ; ce doit être le seul déclencheur du graphe.
2. Réglez Frequency sur Cron.
3. Tapez 0 9 * * 1-5 (09:00, du lundi au vendredi) dans le champ d'expression cron.
4. Réglez Timezone sur le vôtre, par exemple Europe/Istanbul, pour que 09:00 corresponde à votre matinée locale plutôt qu'à l'horloge du serveur.
5. Ajoutez au moins un nœud d'action après lui (un déclencheur seul échoue à Validate), puis faites Validate et Activate.
6. La première activation arme la prochaine occurrence du calendrier plutôt que de se déclencher immédiatement ; à partir de là, il se déclenche chaque matin correspondant sans que vous ayez à y toucher.

Pas à pas : un webhook à signature vérifiée

1. Faites glisser un déclencheur Incoming webhook, renseignez une longue chaîne aléatoire comme secret HMAC, et gardez-en une copie en lieu sûr ; il n'y a aucun moyen de révéler un secret oublié ensuite, seulement de l'écraser par un nouveau.
2. Ajoutez au moins une action après lui, faites Validate, puis Activate ; l'URL entrante n'accepte les appels qu'une fois le statut de l'automatisation passé à Active.
3. Trouvez l'id de l'automatisation (voyez ci-dessus) et donnez au système émetteur l'URL /api/workflow/hook/<id>, avec pour instruction de signer le corps JSON brut de la requête avec votre secret et de l'envoyer sous la forme X-Signature: sha256=<hex hmac>.
4. Si le système émetteur dispose d'une fonction « send test event », utilisez-la ; sinon, envoyez une requête à la main et vérifiez la vue Activity pour une nouvelle exécution plutôt que d'attendre un événement réel.

Pas à pas : déclencher un déclencheur depuis votre propre code

1. N'importe quel type de déclencheur peut être démarré via le pont d'événements générique : un POST authentifié vers /api/workflow/events avec un corps comme { "triggerType": "trigger.asset_uploaded", "payload": { "assetId": "..." } }.
2. C'est le même chemin que le hook Design updated de l'application utilise en interne, donc c'est une manière éprouvée de câbler un événement que l'éditeur intégré ne déclenche pas encore automatiquement.
3. Un seul appel déclenche chaque automatisation ACTIVE de votre espace de travail dont le déclencheur correspond à ce type, chacune obtenant sa propre exécution indépendante amorcée avec votre charge utile comme contexte de départ.

Dépannage

• L'événement de mon déclencheur s'est produit mais aucune exécution n'a démarré. Seul Design updated est raccordé pour se déclencher automatiquement depuis l'application elle-même aujourd'hui. Les autres déclencheurs d'événements de conception et d'espace de travail sont pleinement fonctionnels une fois déclenchés, mais rien dans l'application ne les appelle encore en dehors de votre propre intégration via le pont d'événements ci-dessus. Utilisez Test pour exécuter le graphe indépendamment du déclencheur en attendant ce câblage.
• L'automatisation est Active mais un appel webhook renvoie un 404. Confirmez que le statut est bien Active, pas Paused ni Draft, car seule une automatisation Active résout son URL de webhook, et revérifiez que l'id dans l'URL est exact.
• Un appel webhook renvoie un 401. Le déclencheur a un secret HMAC configuré et la signature de l'appel n'a pas été envoyée ou ne correspondait pas. La signature est calculée sur le corps brut exact de la requête, donc reformater ou re-sérialiser le JSON avant de le signer casse la vérification même si le contenu semble identique.
• L'événement se déclenche mais une exécution ne démarre pas à chaque fois. Vérifiez la fenêtre Debounce dans les Settings de l'automatisation, et le champ debounce propre au nœud déclencheur (sur les déclencheurs d'événements) ; l'un ou l'autre écarte silencieusement un déclenchement qui tombe dans le temps de récupération suivant le précédent.
• Une automatisation planifiée devient silencieuse à certaines heures. Vérifiez les Quiet hours dans les Settings ; un déclenchement qui se produirait autrement à l'intérieur de cette fenêtre (dans le fuseau horaire propre de l'automatisation) est reporté plutôt qu'abandonné ou mis en file, si bien qu'il ne se déclenchera pas rétroactivement une fois la fenêtre terminée.
• Deux automatisations partagent un type de déclencheur et une seule s'est exécutée. C'est attendu si une seule était Active, ou si le filtre d'étiquette/dossier propre à l'autre sur le nœud déclencheur ne correspondait pas à cet événement précis.

Astuces

Un seul déclencheur par graphe

La validation signale un graphe avec zéro déclencheur ou avec plus d'un ; gardez-en exactement un.

Les webhooks ne se déclenchent que pendant qu'elle est active

Un appel de webhook entrant vers une automatisation Paused ou Draft est ignoré. Activez-la d'abord.

Voir aussi

• Construire un flux de travail
• Nœuds
• Exécution et suivi