Comment configurer l'étape Boucle ?

À quoi sert-elle ?

« Boucle » exécute les mêmes étapes pour chaque élément d'une liste. L'étape a deux sorties : « Pour chaque élément » et « Une fois terminé ».

Les visiteurs ne voient pas cette étape et l'avatar ne dit rien ; l'agent continue sans attendre le visiteur.

Pour l'ajouter, cliquez sur « Ajouter une étape » dans l'onglet « Éditeur », puis sur « Boucle » dans la catégorie « Logique » ; l'étape est ajoutée au milieu du canevas. Ses réglages sont dans l'onglet « Contenu » du panneau d'étape, qui s'ouvre à droite quand vous cliquez sur l'étape.

Cette étape n'a pas de « Texte à l'écran » ; à la place, il y a une « Note d'étape » en bas du panneau. La note est pour vous seul : les visiteurs ne la voient pas, et elle n'est ni dite ni traduite.

Dans les valeurs, vous utilisez des variables des étapes précédentes, comme {city}. Pour un champ à l'intérieur d'une réponse, ajoutez son nom après un point : {order.status}. Le bouton « Insérer une variable » dans les champs liste les variables utilisables à cet endroit. Une variable pas encore remplie compte comme un texte vide.

Configurer l'étape

1. Choisissez une source dans « D'où viennent les éléments » et saisissez les éléments (voir ci-dessous).
2. Saisissez un « Nom de la variable » (par exemple service). À chaque tour, l'élément du tour est écrit dans cette variable.
3. Reliez les étapes à exécuter pour chaque élément à la sortie « Pour chaque élément ». Laissez vide la sortie de la dernière étape de la branche : quand la branche se termine, l'élément suivant commence. Vous pouvez aussi relier vous-même la dernière étape à l'étape Boucle.
4. Reliez à la sortie « Une fois terminé » l'étape où aller une fois les éléments épuisés.

D'où viennent les éléments

• « Liste dans une variable » : écrivez une variable de liste dans « Liste » : une réponse à choix multiple, la liste d'un outil ou d'une action, ou un résultat de Modifier la liste.
• « Éléments saisis » : un tour par ligne ; ajoutez des lignes avec « Ajouter un élément ». Les lignes peuvent aussi contenir des variables.
• « Plage de nombres » : « Début », « Fin » et « Étape » (1 si vide). La fin est incluse ; utilisez une étape négative (-1) pour compter à rebours. Les valeurs peuvent aussi être des variables : {guests}.
• « Texte découpé » : le « Texte » est découpé au « Séparateur » : « Virgule », « Point-virgule », « Chaque ligne », « Barre verticale (|) » ou « Autre » (un caractère de votre choix). Chaque partie est un tour ; les parties vides sont ignorées. « Retirer les espaces » enlève les espaces au début et à la fin de chaque partie.

Variables écrites à chaque tour

Si le nom de variable est service, chaque tour écrit : {service} l'élément, {service.field} un champ de l'élément, {service_index} le numéro du tour, {service_total} le nombre d'éléments, {service_last} s'il s'agit du dernier tour (true/false). Ces variables sont retirées à la fin de la boucle. « Le compteur commence à » définit la valeur de {service_index} au premier tour (1 par défaut), et « Tours maximum » le nombre maximal d'éléments traités ; une plage de nombres n'a aucun de ces réglages.

Les tours et les étapes de la branche

Une boucle fait au plus 100 tours ; le reste d'une liste plus longue n'est pas traité. Si la liste est vide, l'agent va directement à « Une fois terminé ». Si vous reliez une étape de la branche à une étape après « Une fois terminé », l'agent quitte la boucle plus tôt ; une étape Fin dans la branche termine la conversation. Les boucles peuvent s'imbriquer : si la sortie « Une fois terminé » de la boucle interne est vide, la boucle externe passe à son élément suivant.

Vous pouvez aussi placer dans la branche des étapes visibles par le visiteur (Message, Question, Formulaire). Une Action d'intégration ou un Appel d'outil dans la branche s'exécute à chaque tour : « créer une carte pour chaque élément » crée une carte par élément. La réponse à une question de la branche est écrite dans la même variable à chaque tour ; chaque nouvelle réponse remplace la précédente.

Exemple

Dans une étape Sélection « Multiple », le visiteur a coché les services qui l'intéressent, et la réponse est dans {services}. Dans la Boucle, « D'où viennent les éléments » vaut « Liste dans une variable », « Liste » vaut {services} et « Nom de la variable » vaut service. Une Action d'intégration sur la sortie « Pour chaque élément » envoie à votre équipe une notification distincte pour chaque service (« Nouvelle candidature pour {service} ») ; la sortie « Une fois terminé » mène à une étape Message de remerciement.

Points d'attention

L'éditeur vous avertit quand : les éléments ne sont pas définis ; la plage de nombres est invalide (début, fin et étape doivent être des nombres, et l'étape ne peut pas valoir 0) ; le nom de variable est invalide (jusqu'à 50 caractères) ; « Pour chaque élément » n'est pas relié (la boucle n'exécutera rien) ; ou « Une fois terminé » n'est pas relié (le flux se termine une fois les éléments épuisés). Les sorties vides des étapes de la branche ne déclenchent pas d'alerte : elles ramènent à la boucle.

Les noms de variables ne peuvent utiliser que les lettres a–z, les chiffres et les tirets bas (_) ; les lettres accentuées et les espaces disparaissent à la saisie. « system » est réservé aux variables système : choisissez un autre nom.

Les étapes logiques n'attendent pas le visiteur. Si vous les reliez (ou d'autres étapes qui n'attendent pas, comme Message, Appel d'outil ou Action d'intégration) en boucle, l'agent tourne sans fin : l'éditeur avertit « Dans une boucle qui n'attend jamais le visiteur ; le flux reste bloqué ici. », et dans la conversation l'agent se termine par une erreur. Pour répéter quelque chose, utilisez l'étape Boucle, ou placez dans la boucle une étape qui attend le visiteur (Question, Sélection, Formulaire).

Les problèmes n'empêchent pas d'enregistrer : l'agent est enregistré, mais l'étape incomplète ne fonctionnera pas comme prévu dans la conversation. Corrigez les étapes signalées, puis testez l'agent avec « Aperçu ». Pour trouver les étapes signalées, voir l'éditeur de flux.