L'éditeur est l'endroit où vous construisez ce que fait une automatisation. Vous placez un déclencheur sur un canevas, ajoutez les étapes qui suivent, les reliez par des lignes et remplissez chaque étape. Cet article parcourt l'éditeur, du premier déclencheur jusqu'à une version publiée.
Ouvrir l'éditeur
Dans la liste des automatisations, cliquez sur une automatisation ou choisissez Modifier dans son menu. Pour partir de zéro, créez une nouvelle automatisation et choisissez Automatisation vierge.
Une nouvelle automatisation démarre avec un nœud de remplacement appelé Sélectionnez un déclencheur pour commencer et le nom Automatisation sans titre. Cliquez sur le nom en haut pour le modifier. Il vous faut un nom avant de pouvoir enregistrer.
L'éditeur comporte quatre zones :
- La barre du haut avec le nom, l'interrupteur Actif, les outils, Enregistrer et un menu avec d'autres actions.
- La bibliothèque à gauche avec tout ce que vous pouvez ajouter.
- Le canevas au centre avec votre flux.
- L'inspecteur à droite, qui s'ouvre quand vous sélectionnez un nœud.
Cliquez sur Automatisations en haut à gauche pour revenir à la liste. Avec des modifications non enregistrées, on vous demande si vous voulez quand même quitter la page.
Vue d'ensemble des automatisations
La bibliothèque
La bibliothèque a deux onglets : Déclencheurs et Actions.
- Déclencheurs liste ce qui peut démarrer une automatisation, par exemple un nouveau membre, une commande payée ou une leçon terminée.
- Actions liste ce que fait l'automatisation. La section Contrôle vient en premier : ce sont les briques qui façonnent le flux, comme les conditions, les délais, les branches et les boucles. Viennent ensuite les actions proprement dites.
Les deux onglets sont regroupés par source. La première source contient les briques intégrées de votre plateforme, et les intégrations suivent par ordre alphabétique. Le nombre à côté d'une source compte ses briques. Cliquez sur une source pour l'ouvrir ; les sources plus grandes sont découpées en catégories comme Membres, Paiements ou Cours. La flèche en haut vous ramène en arrière.
La section Récents affiche les quatre dernières briques que vous avez placées depuis l'onglet ouvert, pour que celles dont vous avez le plus besoin soient toujours à portée de main.
Pour trouver rapidement une brique, tapez dans le champ de recherche au-dessus des onglets. Il cherche dans les noms et descriptions de toutes les sources de l'onglet ouvert.
La flèche à côté du titre de la bibliothèque la replie en une bande étroite pour laisser plus de place au canevas. Cliquez sur l'icône de la bande pour la rouvrir. Sur un téléphone, la bibliothèque démarre repliée.
Ajouter et relier des nœuds
Il y a deux façons d'ajouter une brique :
- Faites-la glisser depuis la bibliothèque sur le canevas et déposez-la où vous voulez.
- Cliquez ou appuyez dessus. L'éditeur la place à droite de votre flux.
Le premier déclencheur que vous ajoutez remplace le nœud Sélectionnez un déclencheur pour commencer et prend sa place. Vous pouvez aussi sélectionner ce nœud et choisir l'événement sous Type de déclencheur dans l'inspecteur. Une automatisation peut avoir plusieurs déclencheurs ; chacun démarre les nœuds qui lui sont reliés.
Chaque nœud a un point à gauche pour la ligne entrante et un ou plusieurs points à droite pour les lignes sortantes. Pour relier deux nœuds, faites glisser depuis un point à droite du premier nœud jusqu'au point à gauche du suivant. Quelques règles s'appliquent :
- Un déclencheur n'a pas de ligne entrante, et rien ne peut suivre un nœud Fin.
- Un nœud ne peut pas se relier à lui-même.
- Une ligne ne peut pas revenir vers un nœud situé plus tôt dans le flux. L'éditeur ne vous laisse pas la tracer. Pour répéter des étapes, utilisez Boucle.
- Une entrée accepte une seule ligne. Si vous tracez une deuxième ligne vers la même entrée, elle remplace la première. Seuls les déclencheurs peuvent partager une entrée.
Pour déplacer une ligne, faites glisser l'une de ses extrémités sur un autre point. Les mêmes règles s'appliquent, et si vous relâchez ailleurs, la ligne reste où elle était.
Pour supprimer une ligne ou un nœud, cliquez dessus et appuyez sur la touche Retour arrière. Ctrl+Z annule votre dernière modification, et Ctrl+Maj+Z la rétablit. Sur un Mac, utilisez Cmd au lieu de Ctrl.
Conditions, branches et délais
Ranger et se déplacer
Mise en page automatique dans la barre du haut aligne tous les nœuds de gauche à droite le long de leurs connexions et ajuste le flux à la vue. C'est le moyen le plus rapide de ranger un flux après avoir ajouté plusieurs étapes.
Le point d'interrogation à côté ouvre Aide, un petit guide pour se déplacer sur le canevas, avec un onglet pour la souris et un pour le pavé tactile :
- Se déplacer : faites glisser le canevas avec le bouton gauche de la souris ou un doigt.
- Zoomer : faites tourner la molette ou pincez sur le pavé tactile.
- Sélectionner plusieurs nœuds : maintenez Ctrl (Cmd sur un Mac) et cliquez dessus.
Sur un écran plus petit, Mise en page automatique et les autres outils passent dans le menu à côté d'Enregistrer.
Les intégrations pas encore connectées
Les briques d'une intégration que vous n'avez pas encore connectée apparaissent estompées dans la bibliothèque avec la puce Connecter. Vous ne pouvez pas les faire glisser. Cliquez sur l'une d'elles, et la boîte de dialogue de connexion de ce service s'ouvre. Une fois la connexion établie, la brique est ajoutée au canevas aussitôt.
Ajouter une intégration en bas de la bibliothèque ouvre la même boîte de dialogue sans brique, par exemple pour connecter un service avant de commencer à construire.
Si un nœud du canevas appartient à une intégration qui n'est pas connectée, son inspecteur affiche Non connectée avec un lien Connecter, et le nœud compte comme un problème (voir ci-dessous). Pour les actions qui ont besoin d'un compte, choisissez-le sous Intégration dans l'inspecteur. S'il n'y en a pas encore, le bouton Ajouter une intégration en connecte un.
Configurer un nœud dans l'inspecteur
Cliquez sur un nœud pour ouvrir l'inspecteur à droite. Son en-tête affiche le type de nœud, par exemple Déclencheur ou Action, et son nom. En dessous, vous remplissez les paramètres de ce nœud. Les champs obligatoires sont marqués d'un astérisque. Les nœuds sans paramètres, comme Fin, affichent « Aucun champ à configurer ».
En bas de l'inspecteur :
- Supprimer retire le nœud et ses lignes.
- L'icône de copie (Dupliquer) place une copie du nœud avec les mêmes paramètres, légèrement décalée sur le canevas.
- Enregistrer enregistre toute l'automatisation.
Appuyez sur Échap ou sur la croix de l'en-tête pour fermer l'inspecteur. Sur un téléphone, l'inspecteur s'arrête au-dessus de la barre de navigation, pour que ces boutons restent à portée.
Un déclencheur a ses propres champs dans l'inspecteur. Certains le restreignent à un élément, par exemple Cours ou Jours d'inactivité. Ils se trouvent juste sous Type de déclencheur, avant Conditions.
Les champs de texte de nombreuses actions, par exemple l'objet et le corps d'un
e-mail, acceptent des variables comme ou [|First Name|]. Quand
l'automatisation s'exécute, elles sont remplacées par les données du membre.
Les nœuds de contrôle travaillent avec des valeurs du déclencheur, écrites
{{key}}. Les champs de chaque déclencheur et de chaque action, ainsi que la
liste complète des variables, se trouvent dans l'article sur les déclencheurs
et les actions.
L'onglet Exécution
Quand vous ouvrez une exécution depuis Exécutions, le canevas passe en relecture en lecture seule de cette exécution. L'inspecteur a alors deux onglets : Paramètres affiche les paramètres du nœud tels qu'ils étaient, et Exécution affiche son statut, ses horaires et les données entrées et sorties.
Tests et historique d'exécution
Corriger les problèmes
L'éditeur vérifie votre flux pendant que vous travaillez. Un nœud qui pose problème reçoit un signe d'avertissement, et un triangle jaune avec le nombre de problèmes apparaît dans la barre du haut. Survolez le triangle pour voir la liste ; cliquez dessus pour aller au premier nœud qui pose problème. L'inspecteur de ce nœud liste ses problèmes en haut.
Problèmes typiques :
- « Aucun type d'événement n'est sélectionné pour le déclencheur. »
- « « Jours d'inactivité » doit être au moins 1. »
- « Aucun type n'est sélectionné pour l'action. »
- « L’intégration requise n’est pas connectée. »
- « Le délai n'a pas de durée. »
- « Aucun workflow n'est sélectionné dans "Exécuter le workflow". »
- « Aucune connexion entrante. Ce nœud est inaccessible. »
La liste complète, avec ce qu'il faut faire, se trouve dans Tests et historique d'exécution.
L'enregistrement fonctionne même avec des problèmes ouverts, vous pouvez donc vous arrêter à mi-chemin et revenir plus tard. L'automatisation risque toutefois de ne pas fonctionner comme prévu tant qu'ils ne sont pas corrigés. Si le flux contient une erreur de structure, par exemple quand vous avez supprimé tous les déclencheurs, l'enregistrement s'arrête avec « Le flux contient une erreur de structure et n'a pas pu être enregistré. »
Enregistrer et activer
Cliquez sur Enregistrer ou appuyez sur Ctrl+S (⌘S sur un Mac). L'infobulle du bouton et la visite guidée indiquent le raccourci de votre appareil. Le bouton affiche Enregistré un instant. Tant que vous avez des modifications non enregistrées, le bouton est mis en évidence, et votre navigateur demande confirmation avant de fermer l'onglet.
L'interrupteur Actif dans la barre du haut décide si l'automatisation s'exécute. Une nouvelle automatisation démarre désactivée. L'interrupteur prend effet à l'enregistrement.
Si vous l'activez alors que des problèmes sont ouverts, on vous demande de confirmer et vous voyez la liste des problèmes. Activer l'active quand même. L'enregistrement avec l'interrupteur activé s'arrête avec un message si un nœud a besoin d'une intégration qui n'est pas connectée, ou si l'automatisation est archivée.
Vue d'ensemble des automatisations
Versions, publication et retour arrière
Chaque enregistrement crée une nouvelle version. Une seule version est en ligne à la fois : la version publiée. Vous pouvez ainsi travailler sur un flux sans changer ce qui se passe pour vos membres tant que vous n'êtes pas prêt.
- Le premier enregistrement d'une automatisation est publié aussitôt.
- Chaque enregistrement suivant est un brouillon. Une note en haut du canevas indique « Enregistré comme brouillon. Ces modifications ne sont pas encore en ligne. » Cliquez sur Publier dans cette note pour mettre le brouillon en ligne. La note apparaît après un enregistrement, après un retour arrière et chaque fois que vous ouvrez une automatisation dont la dernière version n'est pas publiée.
- Dans la liste des automatisations, une icône de crayon jaune signale une automatisation avec Modifications non publiées.
Une exécution de test utilise toujours votre dernière version enregistrée, vous pouvez donc essayer un brouillon avant de le publier.
Le panneau Versions
Versions dans la barre du haut liste jusqu'aux 100 dernières versions, de la plus récente à la plus ancienne, avec l'heure et le membre de l'équipe qui l'a enregistrée. Des étiquettes indiquent quelle version est laquelle :
- En cours de modification : la version que vous voyez dans l'éditeur.
- Publié : la version qui s'exécute.
- Brouillon : une version qui n'a jamais été publiée.
Sélectionnez une version pour la comparer avec ce qui se trouve actuellement sur le canevas. La comparaison liste ce que changerait un retour à cette version, classé en Bloc ajouté, Bloc supprimé, Type de bloc modifié, Bloc reconfiguré, Connexion ajoutée et Connexion supprimée. Si rien ne diffère, vous voyez « Ces versions sont identiques. »
Deux boutons se trouvent sous la comparaison :
- Publier met en ligne la version sélectionnée. Il manque quand la version est déjà la version publiée. La publication s'arrête avec un message si la version utilise une intégration qui n'est pas connectée.
- Revenir à cette version copie la version sélectionnée dans une nouvelle version et la charge dans l'éditeur. Pour la version que vous modifiez, le bouton indique Version actuelle et ne peut pas être cliqué.
Un retour arrière remplace le canevas. Si vous avez des modifications non enregistrées, on vous le demande d'abord : « Vous avez des modifications non enregistrées. Revenir à cette version les remplace. Revenir quand même ? » La nouvelle version est un brouillon et ne passe pas en ligne d'elle-même. Cliquez sur Publier dans la note en haut du canevas, ou rouvrez Versions, sélectionnez la version marquée En cours de modification et cliquez sur Publier.
Dupliquer et supprimer
Le menu à côté d'Enregistrer contient deux autres actions :
- Dupliquer crée une copie de l'automatisation à partir de sa dernière version enregistrée et l'ouvre dans l'éditeur. La copie reçoit « (Copie) » après son nom, démarre désactivée et a déjà cette version publiée. Les modifications non enregistrées ne sont pas copiées, enregistrez donc d'abord.
- Supprimer demande « Supprimer cette automatisation ? Elle sera déplacée dans la corbeille. Vous pouvez la restaurer sous Paramètres, Corbeille. » Après confirmation, vous revenez à la liste. Vous pouvez restaurer l'automatisation sous Paramètres > Corbeille.
Les deux sont disponibles dès que l'automatisation a été enregistrée.
Vue d'ensemble des automatisations
La visite guidée
La première fois que vous ouvrez l'éditeur, une petite carte en bas du canevas appelée Visite de l'éditeur vous guide en quatre étapes : faire glisser un déclencheur, faire glisser une action, les relier et enregistrer. La carte avance d'elle-même à mesure que vous terminez chaque étape et se ferme peu après la dernière. Ignorer la masque aussitôt. Dans les deux cas, elle reste masquée dans ce navigateur par la suite.
Sur un téléphone, la carte se place à droite de la bande de la bibliothèque et au-dessus de la barre de navigation, pour que chaque étape reste lisible.