Concepts

Un workflow est un graphe de blocs reliés de gauche à droite. Il commence par un seul déclencheur. Chaque bloc a des ports d'entrée et de sortie : une Condition a deux sorties (Vrai, Faux), un Aiguillage une sortie par règle, une Fusion plusieurs entrées.

Les blocs intégrés sont disponibles dans toutes les offres. Les nœuds d'applications (GitLab, Kubernetes, Stripe…) s'installent depuis la Marketplace. Les groupes et les notes du canevas servent à organiser et à expliquer : ils n'ont aucun effet sur l'exécution.

Les blocs s'échangent des listes d'éléments. Un élément porte un objet JSON (json) et, au besoin, des fichiers (binary, 2 Mo au plus par fichier). Un bloc qui reçoit dix éléments traite chacun d'eux : une Requête HTTP fait dix appels, un Envoi d'email envoie dix messages.

Pour regrouper des éléments, utilisez Agrégation ou Résumer ; pour séparer une liste en éléments, Séparer en éléments.

Un bloc s'exécute quand toutes ses entrées sont réglées. Un bloc qui ne reçoit aucun élément est ignoré, avec sa raison : « Branche non empruntée » après une condition, ou « Aucun élément reçu » après un filtre qui a tout écarté. Une Fusion attend chacune de ses entrées et ne reste jamais bloquée sur une branche qui ne s'exécute pas.

Seules les boucles passant par Boucle sur les éléments sont acceptées : la sortie « Boucle » mène aux blocs à répéter, et le dernier revient sur l'entrée du bloc.

Une exécution correspond à un déclenchement accepté : clic sur « Exécuter », appel de webhook, échéance de planification, relance. C'est elle qui est décomptée dans le quota de l'offre, quel que soit le nombre d'étapes.

Ne sont jamais décomptés : les nouvelles tentatives d'un bloc, les reprises après un redémarrage ou une attente, les tours de boucle, les appels de webhook répétés avec la même clé Idempotency-Key et les tests d'un bloc isolé depuis l'éditeur.

L'historique des exécutions garde l'entrée, la sortie, la durée et l'erreur de chaque étape ; une exécution peut être relancée.

Vous modifiez toujours un brouillon. Publier crée une version immuable : les déclencheurs de production l'utilisent, et republier ne modifie pas les exécutions en cours. Une exécution manuelle utilise un instantané du brouillon.

Chaque environnement (Développement, Préproduction, Production…) a sa propre version active : voir Environnements et publication.

Les blocs qui appellent l'extérieur (HTTP, e-mail, nœuds de la Marketplace) peuvent réessayer jusqu'à trois fois les erreurs temporaires : réseau, délai dépassé, HTTP 429 et 5xx. Après un redémarrage, l'exécution reprend où elle en était : les étapes déjà réussies sont relues, pas réexécutées.

Un workflow d'erreur, choisi dans les paramètres du workflow et commençant par un Déclencheur d'erreur, démarre une fois quand une exécution échoue.