Votre premier workflow
En dix minutes : un workflow qui lit des contacts sur une API, garde ceux qui ont une adresse e-mail et vous envoie un récapitulatif.
Créer le workflow
- Ouvrez l'application et choisissez votre organisation.
- Dans Workflows, cliquez sur Nouveau workflow. Partez d'une page vierge ou d'un modèle.
- Donnez-lui un nom en haut de l'éditeur.
Ctrl Senregistre le brouillon à tout moment.
Choisir un déclencheur
Le déclencheur décide quand le workflow démarre. Un workflow en a un seul. Sur un canevas vide, cliquez sur Ajouter un déclencheur.
- Déclencheur manuel : au clic sur « Exécuter », idéal pour commencer.
- Webhook : à chaque appel HTTP d'un autre service.
- Planification : à heure fixe, à intervalle régulier ou selon une expression cron.
- Formulaire, E-mail reçu, Déclencheur de chat et d'autres : voir la catégorie Déclencheurs.
Pour cet exemple, choisissez Déclencheur manuel.
Ajouter et relier des blocs
- Survolez le déclencheur et cliquez sur le + de sa sortie, ou appuyez sur
Ctrl K, puis choisissez Requête HTTP. Le nouveau bloc est relié automatiquement. - Dans le panneau de droite, renseignez la méthode
GETet l'URL de votre API. Le champ « Séparer la réponse en éléments » transforme une liste reçue en un élément par contact. - Ajoutez un Filtre avec la condition « e-mail existe ». Dans un champ, l'onglet Entrée montre les données de l'étape précédente : cliquez sur un champ pour insérer l'expression
{{ $json.email }}. - Terminez par un Envoi d'email, avec une connexion SMTP créée depuis Connexions.
Les liaisons vont de gauche à droite : chaque sortie transmet ses éléments au bloc suivant. Un bloc qui reçoit plusieurs éléments s'exécute pour chacun d'eux.
Exécuter et lire le résultat
Cliquez sur Exécuter (Ctrl Entrée). Le brouillon est enregistré, puis exécuté dans l'environnement choisi. Chaque bloc affiche son état : en cours, réussi avec le nombre d'éléments, ignoré ou en échec.
Le panneau du bas regroupe les Résultats (entrée et sortie de chaque étape), le Journal en direct et les Problèmes à corriger. Cliquez sur une étape en échec pour ouvrir le bloc sur le champ en cause.
À savoir. Une exécution manuelle compte dans le quota de l'offre, comme une exécution déclenchée. Les nouvelles tentatives et les tours de boucle ne comptent pas.
Publier
Tant que vous modifiez, vous travaillez sur un brouillon. Publier crée une version immuable et l'active dans l'environnement choisi : les déclencheurs (webhook, planification…) utilisent toujours la version publiée, jamais le brouillon. Vous pouvez revenir à une version précédente depuis l'historique.