Comment configurer les étapes Action d'intégration et Appel d'outil ?

À quoi servent-elles ?

Les deux étapes effectuent un travail dans un système externe à un point de l'agent ; les visiteurs ne voient ni l'une ni l'autre.

• « Action d'intégration » exécute une action prête à l'emploi d'une intégration connectée (par exemple créer une carte Trello ou prévenir Slack ou Teams).
• « Appel d'outil » appelle un outil que vous avez défini pour votre propre système sur la page « Outils » (par exemple consulter le statut d'une commande).

Les deux ont les sorties « Une fois terminé » et « En cas d'échec », et « Réessayer en cas d'échec » fonctionne de la même façon.

Action d'intégration

Les visiteurs ne voient pas cette étape : le flux exécute ici une action d'une intégration connectée (par exemple créer une carte Trello ou prévenir Slack ou Teams) et continue.

1. Ouvrez la catégorie « Intégrations » de la palette « Ajouter une étape », cliquez sur l'intégration, puis sur l'action ; l'étape est ajoutée au canevas.
2. Dans le panneau d'étape, vérifiez l'« Action » et remplissez ses champs. Choisissez des valeurs dans une liste (« Choisir dans la liste ») ou saisissez-les (« Je la saisis ») ; utilisez {variable} pour les réponses précédentes.
3. Pour utiliser le résultat dans les étapes suivantes, donnez-lui un nom de variable sous « Enregistrer dans des variables ». Les variables résident dans le navigateur du visiteur : ne choisissez pas de valeurs qui doivent rester privées.

L'étape a deux sorties : « Une fois terminé » et « En cas d'échec ». Si l'intégration n'est pas connectée ou si le fournisseur renvoie une erreur, le flux prend « En cas d'échec ». Si « En cas d'échec » est vide, la conversation se ferme avec un message indiquant qu'un problème est survenu. Si vous voulez que l'agent continue aussi après un échec, reliez « En cas d'échec » à la même étape que « Une fois terminé ». Si un champ obligatoire est vide, le fournisseur n'est pas appelé du tout et l'étape prend « En cas d'échec ». La « Note d'étape » est pour vous seul ; les visiteurs ne la voient pas.

Une action qui modifie des données ne se relance pas quand le visiteur appuie sur le bouton retour ou renvoie un message. Si la conversation repasse par cette étape (par exemple en revenant par un menu), elle se relance.

Pendant que l'étape s'exécute, le visiteur voit ce qui se passe au lieu de « Réflexion » : un texte adapté (« Traitement de votre demande… », « Vérification des détails… ») ; pour un travail interne comme prévenir votre équipe, simplement « Un instant… ». Vous pouvez écrire votre propre texte dans « Texte affiché pendant l'attente » (par exemple « Création de votre rendez-vous… ») ; il est traduit dans vos autres langues.

Les actions qui suppriment ou annulent définitivement quelque chose ne s'exécutent pas tant que vous n'avez pas coché « Je comprends que cette étape fait quelque chose d'irréversible » ; celles qui envoient depuis votre compte demandent « Je comprends que cette étape envoie depuis mon compte ». Les suppressions s'exécutent au plus 20 fois et les envois au plus 100 fois par heure et par espace de travail. L'enregistrement à supprimer ne peut pas venir d'une réponse du visiteur.

Appel d'outil

Appelle un outil défini sur la page « Outils » à ce point précis de l'agent, sans IA. Les visiteurs ne voient pas cette étape ; son texte n'est qu'une note pour vous.

1. Ajoutez une étape Appel d'outil et choisissez l'outil dans la liste.
2. Donnez une valeur aux champs de l'outil : une valeur fixe, une variable d'une réponse précédente (par exemple {order_no}) ou le chemin vers un champ d'une réponse précédente (par exemple {order.no}).
3. Sous « Enregistrer dans des variables », enregistrez la réponse complète ou le code d'erreur dans une variable ; utilisez-la ensuite sous la forme {variable}.
4. Reliez les branches « Une fois terminé » et « En cas d'échec ». Si l'outil ne répond pas ou renvoie une erreur, le flux prend la branche « En cas d'échec ». Si elle est vide, la conversation se ferme avec un message indiquant qu'un problème est survenu. Si vous voulez que l'agent continue aussi après un échec, reliez « En cas d'échec » à la même étape que « Une fois terminé ».

Pendant l'exécution de l'outil, le visiteur voit un texte comme « Vérification des détails… » ou « Traitement de votre demande… » (pour les outils de boutique, le travail lui-même, comme « Recherche de produits… »). Vous pouvez écrire votre propre texte dans « Texte affiché pendant l'attente ».

Les sous-champs des champs Objet d'un outil se remplissent dans des zones séparées. Pour une liste dont les éléments sont des Objets, saisissez d'abord une variable de liste dans « Source de la liste » (par exemple la liste d'une action ou le résultat d'une étape Modifier la liste), puis associez les champs de l'élément sous « Champs de chaque élément », comme {item.sku}. Chaque élément de la source devient une ligne de la liste ; si vous laissez l'association vide, les éléments sont envoyés tels quels.

Un outil qui modifie des données ne se relance pas quand le visiteur appuie sur le bouton retour ou renvoie un message. Si la conversation repasse par cette étape (par exemple en revenant par un menu), il se relance. Un outil qui lit des données est appelé chaque fois que le visiteur atteint l'étape.

Si un champ obligatoire est vide ou si une valeur ne correspond pas au type de son champ, l'outil n'est pas appelé et l'étape prend « En cas d'échec ». L'éditeur affiche sur l'étape une alerte pour une valeur fixe qui ne correspond pas à son type. Les appels apparaissent sur la page « Outils » › « Statistiques d'appels ».

Réessayer en cas d'échec

Si vous activez « Réessayer en cas d'échec » dans une étape Action d'intégration ou Appel d'outil, l'étape se relance en cas d'erreur temporaire. Une fois les essais épuisés, le flux continue depuis « En cas d'échec » ; si cette branche est vide, la conversation se ferme avec un message indiquant qu'un problème est survenu.

• « Essais max. » : 2 à 5 ; 3 par défaut.
• « Attente entre les essais (s) » : 0 à 5 secondes ; 1 par défaut.

L'ensemble des essais dure au plus 18 secondes ; si le temps est écoulé, les essais restants sont ignorés.

Seules les erreurs temporaires sont réessayées : délais dépassés, erreurs de connexion, pannes du fournisseur et limites de débit. Pour des erreurs comme une autorisation manquante ou un champ vide, l'étape va directement à « En cas d'échec ».

Utilisez cette option avec prudence sur les étapes qui créent un enregistrement ou envoient un message : en cas de délai dépassé, la requête a pu atteindre le fournisseur, et le même enregistrement ou message peut être créé deux fois.