Construire un flux de travail
Ouvrir une automatisation occupe tout l'écran avec le constructeur : un canevas de nœuds à droite, une palette ou un inspecteur à gauche, et une barre d'outils en haut. Il reste ouvert par-dessus votre espace de travail ; il n'y a pas de page ni d'onglet séparé.
Aperçu rapide
- Créez ou ouvrez une automatisation pour entrer dans le constructeur.
- Faites glisser un nœud depuis la palette sur le canevas.
- Faites glisser du connecteur d'un nœud vers le nœud suivant pour les relier.
- Cliquez sur un nœud pour ouvrir ses réglages dans le panneau de gauche.
- Cliquez sur Validate, puis sur Test pour l'exécuter une fois, ou sur Activate pour le mettre en service.
Référence détaillée
Disposition
| Zone | Ce qu'elle contient |
|---|---|
| Barre d'icônes (tout à gauche) | Trois vues : Flow (le canevas), Settings (options par automatisation), Activity (historique des exécutions). |
| Panneau de gauche | La palette de nœuds quand rien n'est sélectionné, ou les réglages du nœud sélectionné le cas échéant. Les deux se remplacent au même endroit. |
| Canevas | Le graphe lui-même : un arrière-plan quadrillé, le déplacement et le zoom, une minicarte et des commandes de zoom. |
| Barre d'outils | Quitter, le nom de l'automatisation et son statut d'enregistrement automatique, annuler et rétablir, Validate, une pastille de statut, et Test / Activate / Pause. |
La palette de nœuds
La palette du panneau de gauche comporte un champ de recherche et trois onglets qui correspondent au catalogue de nœuds : Triggers, Actions et Rules, chacun regroupé en sous-catégories plus fines (par exemple Design, AI ou Notification sous Actions). Faites glisser n'importe quel nœud sur le canevas pour le placer ; voir Nœuds pour le catalogue complet.
Relier les nœuds
Faites glisser du connecteur inférieur d'un nœud vers le haut du nœud suivant pour les relier. Un déclencheur n'a pas d'entrée ; un nœud de sortie n'a pas de sortie. Les nœuds de type condition (comme If) exposent deux connecteurs, un pour chaque branche, ce qui vous permet de câbler séparément un chemin « oui » et un chemin « non ».
Configurer un nœud
Cliquez sur un nœud pour remplacer le panneau de gauche par son inspecteur : un titre, une brève description et ses champs.
| Type de champ | Rendu sous forme de |
|---|---|
| Text | Un champ sur une seule ligne |
| Textarea | Un champ sur plusieurs lignes, pour les invites et les contenus plus longs |
| Number | Un champ numérique, avec un minimum et un maximum le cas échéant |
| Select | Un menu déroulant ; certains (comme les dossiers) chargent les données réelles de votre espace de travail |
| Boolean | Un interrupteur |
| Part picker | Un bouton qui ouvre le sélecteur d'élément décrit ci-dessous |
Choisir un élément de projet
Certains nœuds d'action, à commencer par Pick a part, ont besoin d'un morceau précis d'un projet plutôt que d'un design entier. Le sélecteur est une surcouche en deux étapes au-dessus du constructeur : choisissez d'abord un projet, puis un élément à l'intérieur, une page, un cadre ou une diapositive, avec une vignette d'aperçu en direct par projet. Une fois l'élément choisi, un lien Open in editor mène directement à cet élément précis.
Gestion des erreurs par nœud
L'inspecteur de chaque nœud comporte deux onglets : Parameters, les champs présentés ci-dessus, et Settings, qui n'affiche des options que pour les nœuds de type action (les déclencheurs et les nœuds de logique n'ont rien à configurer ici, puisqu'ils n'ont aucun effet de bord à réessayer) :
| Réglage | Effet |
|---|---|
| On error | Continue avale l'échec et poursuit, Stop the run fait échouer toute l'exécution, Route to an error output ajoute un second connecteur rouge « Hata » en sortie du nœud, ce qui vous permet de câbler un chemin d'échec dédié |
| Retry (0-5) | Retente la même étape ce nombre de fois avant de basculer sur le comportement On error |
| Wait (ms) | La durée de pause entre les tentatives de réessai |
| Note | Une note libre sur le nœud, pour votre propre référence ; elle n'a aucun effet sur l'exécution |
Un nœud laissé sur la valeur par défaut Continue se contente de journaliser une étape error et fait avancer l'exécution comme si de rien n'était : un webhook injoignable ou un e-mail renvoyé n'arrête donc pas à lui seul le reste du graphe.
La vue Settings
La vue Settings de la barre d'icônes réunit les options de l'ensemble de l'automatisation, enregistrées avec le brouillon :
| Groupe | Réglage | Effet |
|---|---|---|
| Execution | Concurrency | Free (plusieurs exécutions à la fois), Single at a time, Skip if busy, ou Queue jusqu'à un plafond |
| Execution | Max concurrent | Le plafond de la file, affiché uniquement en mode Queue |
| Execution | Max run duration | Une exécution plus ancienne que ce nombre de secondes est mise en échec automatiquement, même en pleine temporisation |
| Execution | Priority | Les exécutions des automatisations prioritaires passent en premier quand le moteur a du retard |
| Error | Default on-error behavior | Continue ou Stop, utilisé par tout nœud qui n'a pas défini son propre On error |
| Error | Error notifications | In-app, e-mail et/ou Slack, envoyées quand une exécution échoue |
| Error | Error automation | Une autre automatisation à démarrer (sans attente de retour) chaque fois que celle-ci échoue |
| Error | Circuit breaker | Met l'automatisation en pause automatiquement après ce nombre d'échecs consécutifs |
| Scheduling | Quiet hours | Une plage horaire de début et de fin (dans le fuseau de l'automatisation) durant laquelle les déclencheurs sont différés plutôt que déclenchés |
| Scheduling | Debounce | Un écart minimal imposé entre deux déclenchements, en plus de tout anti-rebond défini sur le nœud déclencheur lui-même |
| Data & retention | Save execution data | Tous les journaux d'étapes, les erreurs seulement, ou aucun, un compromis entre confidentialité et stockage |
| Data & retention | Run history retention | Les exécutions terminées plus anciennes que ce nombre de jours sont supprimées automatiquement ; laisser vide conserve tout |
Rien de tout cela n'est vérifié par Validate, qui ne contrôle que le graphe lui-même ; un réglage absurde (comme un plafond de file à 0) se contente d'un comportement prudent plutôt que de bloquer Activate.
Commandes de la barre d'outils
| Commande | Effet |
|---|---|
| Exit | Ferme le constructeur et revient à la vue d'ensemble. |
| Nom + texte de statut | Affiche le nom de l'automatisation et indique si elle est enregistrée, en cours d'enregistrement ou en échec d'enregistrement. |
| Undo / Redo | Recule et avance dans vos modifications du graphe. |
| Validate | Vérifie le graphe et liste les erreurs et avertissements en ligne, sous la barre d'outils. |
| Status pill | Draft, Active, Paused ou Error, en un coup d'œil. |
| Test | Enregistre, puis exécute le graphe une fois immédiatement. Voir Exécuter et surveiller. |
| Activate / Pause | Publie et met en service, ou cesse d'écouter sans perdre le brouillon. |
Raccourcis clavier
| Raccourci | Action |
|---|---|
Delete / Backspace | Supprimer le nœud sélectionné (et ses arêtes reliées) |
Ctrl/Cmd + Z | Annuler |
Ctrl/Cmd + Shift + Z (ou Ctrl+Y) | Rétablir |
Ctrl/Cmd + C / V | Copier et coller le nœud sélectionné |
Ctrl/Cmd + D | Dupliquer le nœud sélectionné |
Les nœuds déplacés s'alignent sur une grille, et faire glisser sur le canevas vide crée une sélection encadrée de plusieurs nœuds à la fois.
Pas à pas
Ces exemples construisent des automatisations complètes et réelles à partir de nœuds qui s'exécutent réellement aujourd'hui (voir Nœuds pour savoir lesquels). Les ancres ci-dessous sont référencées depuis d'autres pages.
Guide : un condensé IA planifié, par e-mail
- Faites glisser un déclencheur Scheduled sur le canevas (onglet Triggers, groupe Zaman). Ouvrez son inspecteur et définissez la fréquence : choisissez Weekly pour un jour fixe, Interval plus une valeur « Every (minutes) » pour une cadence serrée, ou Cron avec une expression cron brute et un fuseau horaire pour un contrôle précis (voir Déclencheurs).
- Faites glisser un nœud Generate copy depuis Actions > AI et reliez-y le connecteur du déclencheur. Ouvrez son inspecteur et rédigez une invite, par exemple « Write 3 short social post ideas for this week, one line each. » Cette étape passe par la clé du fournisseur d'IA que vous avez connectée sous Settings > AI ; sans clé, elle journalise une étape ignorée au lieu de faire échouer l'exécution.
- Faites glisser un nœud Send email depuis Actions > Notification et reliez-y Generate copy. Réglez To sur votre adresse, Subject sur quelque chose comme « This week's post ideas », et Body sur
{{ context.__aiText }}pour qu'il transporte la sortie de l'étape IA. - Cliquez sur Validate, corrigez ce qu'il signale (une erreur fréquente : To ou Subject laissé vide), puis cliquez sur Test. Ouvrez la vue Activity et vérifiez que l'étape IA a produit du texte et que l'étape e-mail affiche
ok(ou une raison d'omission claire si aucune connexion SMTP ni clé IA n'est encore configurée). - Cliquez sur Activate. L'automatisation s'exécute désormais d'elle-même selon la planification que vous avez configurée ; vous n'avez pas besoin de garder l'application ouverte.
Guide : réception par webhook avec une réponse IA
- Faites glisser un déclencheur Incoming webhook sur le canevas. Son URL entrante est construite à partir de l'identifiant propre de l'automatisation (
/api/workflow/hook/<automation id>) ; il n'y a pas encore de bouton de copie d'URL dans le constructeur, alors trouvez l'identifiant dans les requêtes réseau que la page émet déjà (par exemple les outils de développement du navigateur pendant que le constructeur est ouvert) plutôt que de vous attendre à le voir imprimé sur le nœud. Définissez éventuellement un secret HMAC pour n'accepter que les requêtes porteuses d'une signature valide. - Pointez un outil de formulaire externe, un CRM ou un widget de chat vers cette URL comme cible de webhook, avec un corps JSON tel que
{ "email": "...", "message": "..." }. - Faites glisser un nœud Set a variable après le déclencheur pour normaliser un champ que vous réutiliserez, par exemple la clé
customerEmail, valeur{{ context.email }}. - Faites glisser un nœud Generate copy après lui avec une invite comme
Write a short, friendly reply to: {{ context.message }}. - Faites glisser un nœud Slack / Discord, collez l'URL de webhook entrant de votre canal, et réglez le message sur
New submission from {{ context.customerEmail }}: {{ context.__aiText }}. - Validez, puis testez avec un corps JSON d'exemple (n'importe quel client HTTP, ou le bouton « send test event » de votre outil convient, puisqu'il suffit d'un
POSTvers l'URL du webhook). Vérifiez Activity, puis activez.
Guide : brancher sur une condition après un enregistrement
- Partez d'un déclencheur Design updated ; parmi les déclencheurs d'événements design/espace de travail, c'est celui que l'application déclenche automatiquement aujourd'hui, chaque fois qu'un design est enregistré (voir Déclencheurs).
- Faites glisser un nœud Pick a part pour que les étapes suivantes aient quelque chose de concret sur quoi agir ; ouvrez le sélecteur d'élément et choisissez un projet, puis une page, un cadre ou une diapositive à l'intérieur.
- Faites glisser un nœud Condition (yes/no). Son inspecteur construit une règle (un champ, une comparaison telle que égal à ou contient, et une valeur) plutôt qu'une expression saisie brute ; chaque côté de la règle peut puiser dans le contexte de l'exécution.
- Sur la branche yes, ajoutez une In-app notification qui indique à votre équipe que l'élément est prêt à être relu. Sur la branche no, ajoutez une étape Write an audit entry pour que le cas de passage direct soit tout de même consigné.
- Validez, puis testez ; Test s'exécute immédiatement, indépendamment du déclencheur, ce qui vous permet d'essayer les deux branches sans réellement enregistrer un design. Vérifiez que les deux chemins apparaissent correctement dans Activity, puis activez.
Dépannage
- L'onglet Settings d'un nœud semble vide. Seuls les nœuds de type action ont un onglet On error / Retry / Note. Les déclencheurs et les nœuds de logique (Condition, Filter, Delay, Set a variable, et similaires) n'ont aucun effet de bord à réessayer, donc leur onglet Settings ne contient rien d'autre que le champ Note.
- J'ai réglé « Route to an error output » mais il n'y a nulle part où relier le chemin d'échec. Un second connecteur rouge n'apparaît sur le nœud lui-même qu'après avoir activé ce réglage ; regardez à nouveau le bas du nœud : la nouvelle poignée « Hata » se trouve à côté de la sortie normale.
- Le copier-coller (
Ctrl/Cmd+C/V) semble n'avoir rien fait. La copie collée atterrit légèrement décalée par rapport à l'original, avec un petit décalage aléatoire, pas exactement par-dessus ; regardez juste en dessous et à droite du nœud source. - Validate est propre mais Activate échoue quand même. Activate revalide et publie en une seule étape ; si un champ dépend de données en direct (comme un dossier supprimé depuis), il peut échouer à ce moment-là même si Validate semblait correct une minute plus tôt. Rouvrez l'inspecteur du nœud fautif et choisissez à nouveau la valeur.
- Un champ obligatoire affiche une erreur que je ne trouve pas. Le message de Validate nomme le nœud et le champ, mais l'inspecteur n'affiche que les champs dont la condition
displayIfest actuellement remplie ; un champ peut être obligatoire tout en restant masqué si un autre champ contrôle sa visibilité (par exemple, le corps du nœud HTTP n'apparaît qu'une fois choisie une méthode capable de transporter un corps).
Astuces
Validez avant d'activer
La validation détecte un graphe vide, plus d'un déclencheur, un champ obligatoire laissé vide, une connexion pendante ou une branche non câblée, avant que vous ne tentiez la mise en service.
Les modifications s'enregistrent d'elles-mêmes
Les modifications sont enregistrées automatiquement un instant après que vous avez cessé de taper ou de déplacer un élément ; le texte de statut de la barre d'outils le confirme. Il n'y a pas de bouton d'enregistrement séparé.
Supprimer un nœud supprime ses arêtes
Il n'y a pas d'étape distincte pour nettoyer les connexions ; supprimer un nœud emporte avec lui toute arête qui le touche.