Vous pouvez agrandir toutes les captures d’écran en cliquant dessus. Elles montrent le nœud lui-même ainsi que le menu de paramètres correspondant.
Démarrer une conversation
Un workflow peut démarrer de cinq façons : lorsque le contact entame une conversation, par un déclencheur externe via un appel webhook (actuellement en version bêta), par un transfert depuis un Agent IA Connect, à partir d’une date enregistrée dans la fiche du contact ou manuellement, lorsqu’un opérateur lance le workflow pour un contact. Vous choisissez le mode de démarrage dans le nœud Démarrer, sous Type de déclencheur.
Démarrage par une nouvelle conversation, à l’initiative du contact
Supposons que vous exploitiez un site web sur lequel notre chat est intégré. Un contact entame une conversation via le bouton de chat. Un chatbot associé au workflow guide le client à travers le processus prédéfini
Ce nœud est inclus par défaut dans chaque workflow et ne peut pas être configuré davantage dans cet état.
Démarrage par un déclencheur externe
Supposons maintenant que vous utilisiez un système indépendant de Lime Connect et que vous souhaitiez déclencher un workflow automatisé dans Lime Connect à partir des données de ce système.
Dans ce cas, ce n’est pas le contact qui lance le workflow, mais un événement préalablement défini (programmé) dans votre système tiers, qui est transmis à Lime Connect via une interface.
Pour lancer le workflow à l’aide d’un déclencheur externe, vous devez avoir de l’expérience en programmation et dans l’utilisation d’interfaces.
Actuellement, le déclencheur webhook ne peut être utilisé qu’en combinaison avec des nœuds de modèle WhatsApp.
Vous configurez ici l’URL du webhook ainsi que l’en-tête d’autorisation. Vous précisez également les champs de données attendus qui seront transmis à votre système.
Exemple de cas d’utilisation (cliquez sur la flèche à gauche pour l’ouvrir)
Démarrage par un transfert depuis un Agent IA Connect
Vous pouvez également déclencher le transfert de la conversation en cours depuis votre Agent IA Connect vers un workflow. Pour cela, le nœud Démarrer doit être configuré avec le type correspondant.
Si nécessaire, vous pouvez également transmettre au workflow les données auxquelles votre Agent IA a accès. Ces données seront alors disponibles sous forme de variables dans le workflow.
Démarrage à partir d’une date dans un champ du contact
Un workflow peut également démarrer à un moment déjà enregistré dans la fiche du contact. Le cas typique est un message d’anniversaire envoyé chaque année à la date d’anniversaire du contact.
Dans le nœud Démarrer, définissez le Type de déclencheur sur Basé sur une date du contact. Les autres options sont Au démarrage d’une conversation, Lors d’un appel webhook, Lors d’un transfert de Connect AI et Démarré manuellement.
Avant de choisir un champ, vérifiez qu’il peut être utilisé. Seuls les champs du contact dont le type de saisie est Date ou Date et heure sont éligibles. Le type de saisie d’un champ enregistré ne peut pas être modifié par la suite. Une date d’anniversaire stockée dans un champ de texte doit donc être recréée avec le type de saisie Date, sous Paramètres > Outils de chat > Champs de données.
Sous Exécuter le, cliquez sur Sélectionner une variable du contact et choisissez le champ contenant la date. La sélection ne propose que les champs éligibles, et les onglets des variables de conversation et de workflow n’apparaissent pas.
Heure de la journée définit l’heure d’exécution du workflow : 9 h, sauf si vous la modifiez. Seuls des intervalles de 30 minutes peuvent être sélectionnés.
Décalage déplace l’exécution par rapport à la date elle-même. Conservez Aucun décalage pour exécuter le workflow à cette date. Choisissez Avant ou Après pour la décaler, puis indiquez une quantité et une unité. Un champ Date ne propose que des jours. Un champ Date et heure propose également des minutes et des heures, car il contient lui-même une heure.
Répéter chaque année exécute le workflow chaque année à cette date. Cette option est désactivée par défaut : vous devez donc l’activer pour un message d’anniversaire. Laissez-la désactivée pour une date qui ne doit déclencher le workflow qu’une seule fois, comme une date d’inscription.
Démarrage manuel par un opérateur
Avec le type de déclencheur Démarré manuellement, un opérateur lance manuellement le workflow pour un contact précis, directement depuis le profil du contact dans le Centre de messages. Utilisez-le pour les workflows qui ne doivent pas démarrer seuls, mais uniquement lorsqu’un membre de votre équipe le décide. Au démarrage, l’opérateur peut transmettre des valeurs, par exemple un numéro de commande que le workflow utilisera ensuite.
Les créateurs le configurent dans l’éditeur de workflows : d’abord le nœud Démarrer, puis l’activation du workflow et la connexion d’un chatbot. Les opérateurs le lancent ensuite depuis le profil d’un contact dans le Centre de messages.
Ne confondez pas ce déclencheur avec le démarrage par une nouvelle conversation décrit plus haut : dans ce cas, le contact entame la conversation ; ici, un opérateur lance le workflow.
Lorsque vous créez le workflow, placez Envoyer un message modèle WhatsApp avant chaque nœud nécessitant une conversation. Un workflow démarré manuellement s’exécute pour le contact et commence sans conversation. Seul ce nœud en ouvre une, en envoyant au contact un modèle WhatsApp approuvé via l’un de vos canaux WhatsApp. Il est décrit sur la page "Nœuds d’actions". Le nœud suivant s’exécute immédiatement, sans attendre de réponse.
Le modèle n’est envoyé que si vous disposez d’un canal WhatsApp avec un modèle approuvé et si le contact n’est pas bloqué et possède un numéro de mobile utilisant WhatsApp. Sans canal WhatsApp, un workflow démarré manuellement ne peut utiliser que des nœuds ne nécessitant pas de conversation.
Parmi les nœuds de cette page, Message et Déclencher une extension nécessitent une conversation. Écouteur de mots-clés attend un message du contact dans la conversation. Placez ces trois nœuds après le nœud de modèle. Condition ne nécessite pas de conversation, pas plus que les nœuds qui concernent uniquement le contact, comme Mise à jour du contact (page "Nœuds d’actions") ou Requête API (page "Nœuds de collecte d’informations").
Choisissez le type de déclencheur avant tout autre réglage dans le nœud Démarrer : le modifier ensuite réinitialise le nœud et efface tous les paramètres du type précédent, y compris les variables d’entrée.
Ouvrez le workflow dans l’éditeur, cliquez sur le nœud Démarrer et, sous Type de déclencheur, sélectionnez Démarré manuellement.
Sous Variables d’entrée, vous définissez les valeurs que l’opérateur saisit au démarrage ; si vous n’en avez pas besoin, laissez la section vide. Pour chaque valeur, cliquez sur Ajouter une variable et donnez-lui un nom, par exemple "order_number". Un nom ne peut contenir que les lettres latines de a à z et de A à Z, des chiffres, "-" et "_", et chaque nom ne peut être utilisé qu’une seule fois. Pour chaque variable, vous définissez également :
- Obligatoire : lorsque cette option est cochée, l’opérateur ne peut lancer le workflow qu’après avoir saisi une valeur. Les nouvelles variables sont obligatoires par défaut.
- Type : Chaîne de caractères pour du texte, ou Nombre. Un champ Nombre n’accepte que des nombres au démarrage, y compris les décimales et les nombres négatifs. Ce "Type" détermine ce que l’opérateur peut saisir ; le Type de déclencheur ci-dessus détermine comment le workflow démarre.
- Description : une indication pour l’opérateur sur la valeur à saisir. Elle s’affiche au démarrage via l’icône d’information à côté du nom du champ.
Si l’opérateur laisse un champ facultatif vide, la variable reste vide : un nœud Message n’affiche rien à sa place, et un nœud Envoyer un message modèle WhatsApp qui l’utilise comme espace réservé échoue. Rendez une variable obligatoire si un modèle en a besoin.
Dans les nœuds qui suivent le nœud Démarrer, vous retrouvez les variables d’entrée dans la sélection de variables, sous l’onglet Ce workflow, par exemple "order_number" comme espace réservé dans un modèle WhatsApp. Comme le workflow s’exécute pour un contact, vous pouvez également utiliser les champs de ce contact.
Lorsque le workflow est prêt, activez l’interrupteur Actif en haut de l’éditeur de workflows et confirmez avec Activer.
Associez ensuite le workflow à un chatbot, comme décrit sur la page Workflows, sous "Associer votre workflow à un chatbot" : ajoutez un chatbot avec le type de bot "WORKFLOW" ou ouvrez un chatbot existant. Un chatbot possède exactement un workflow connecté ; choisir ce workflow pour un chatbot existant remplace donc le précédent.
Sélectionnez le workflow sous Workflow connecté et cliquez sur Enregistrer. Seuls les workflows actifs peuvent y être sélectionnés, d’où la nécessité de les activer d’abord. Sans ce chatbot, le workflow ne peut pas être lancé, et les messages envoyés par le workflow apparaissent dans la conversation comme provenant de ce chatbot.
Les étapes suivantes s’adressent aux opérateurs ; la personne qui a créé le workflow peut les utiliser pour le tester. Tous les opérateurs voient le bouton Exécuter le workflow dès que la fonctionnalité Workflows est souscrite pour votre compte ; aucune autorisation distincte n’est nécessaire pour le lancement.
Ouvrez le profil du contact dans le Centre de messages, par exemple via Contacts dans la navigation. La rangée d’onglets affiche Profil, Conversations et, selon votre rôle, Workflows. À droite se trouve le bouton Exécuter le workflow.
Cliquez sur Exécuter le workflow. Dans la fenêtre du même nom, sélectionnez le workflow sous Workflow. La liste affiche tous les workflows actifs dont le type de déclencheur est Démarré manuellement. Si le workflow comporte des variables d’entrée, un champ portant le nom de chacune apparaît, et les champs obligatoires sont signalés.
Le lancement exécute réellement le workflow : le modèle WhatsApp est envoyé au contact. Pour tester, utilisez un contact avec votre propre numéro de mobile. Chaque clic sur Démarrer lance une nouvelle exécution. Une seule exécution ne peut pas être arrêtée depuis le profil du contact ; les exécutions ne peuvent être arrêtées que toutes ensemble, en désactivant le workflow avec "Arrêter les exécutions actives et désactiver".
Remplissez les champs et cliquez sur Démarrer. Les champs facultatifs laissés vides ne sont pas transmis.
Après le démarrage, vous voyez le message "Workflow démarré". Le contact ne remarque rien tant que le workflow ne lui envoie pas quelque chose, comme le modèle WhatsApp.
Pour vérifier que cela a fonctionné, ouvrez l’onglet Workflows du profil du contact. Seuls les opérateurs dont le rôle permet de consulter les workflows le voient ; si ce n’est pas votre cas, demandez à une personne qui y a accès. Chaque exécution est répertoriée avec son statut : Active, En attente, Terminée ou Erreur. Cliquez sur le nom du workflow pour ouvrir l’Activité du workflow avec son Journal d’exécution ; Afficher les détails sur une étape affiche le nœud et son erreur.
Si vous ne parvenez pas à lancer un workflow :
- Vous ne voyez pas "Exécuter le workflow" : la fonctionnalité Workflows n’est pas souscrite pour votre compte.
- "Aucun workflow actif ne possède de déclencheur manuel. Créez-en un et activez-le dans l’éditeur de workflows pour l’exécuter ici." : aucun workflow ne possède à la fois le type de déclencheur Démarré manuellement et le statut Actif. Demandez à la personne qui l’a créé de l’activer.
- "Pour exécuter ce workflow, connectez-lui un bot de workflow dans les paramètres du chatbot." après avoir cliqué sur Démarrer : aucun chatbot n’a ce workflow comme Workflow connecté. La personne qui l’a créé doit l’associer à un chatbot, comme décrit sur la page Workflows, sous "Associer votre workflow à un chatbot".
- "Démarrer" reste grisé : aucun workflow n’est encore sélectionné, ou un champ obligatoire est toujours vide.
- "Veuillez saisir un nombre." : le champ correspond à une variable de type Nombre. Saisissez uniquement un nombre.
Si une exécution affiche Erreur, le Journal d’exécution indique le nœud qui a échoué. Causes fréquentes et solutions :
- Un nœud Message ou Déclencher une extension a été placé avant le modèle : placez Envoyer un message modèle WhatsApp avant ce nœud.
- Le contact est bloqué : les modèles ne sont pas envoyés aux contacts bloqués.
- Le contact n’a pas de numéro de mobile : ajoutez-en un dans son profil et relancez le workflow.
- Le numéro de mobile n’utilise pas WhatsApp : vérifiez le numéro dans le profil du contact.
- Le canal WhatsApp est verrouillé ou invalide : vérifiez-le dans les paramètres de vos canaux.
- Le modèle choisi dans le nœud n’est pas approuvé sur son canal WhatsApp : choisissez un modèle approuvé dans le nœud.
- Un espace réservé du modèle est resté vide, par exemple à cause d’une variable d’entrée facultative vide : rendez la variable obligatoire ou remplissez le champ au démarrage.
- La conversation WhatsApp du contact comporte déjà un workflow actif : attendez la fin de ce workflow, puis relancez.
Si le nœud Démarrer affiche une erreur :
- "Ce champ ne doit contenir que des caractères alphanumériques, “-” ou “_”." : le nom de la variable contient un autre caractère, comme une espace ou "ä". Renommez la variable.
- "Ce nom de variable est déjà utilisé." : deux variables d’entrée portent le même nom. Renommez l’une d’elles.
Condition
Utilisez ce nœud lorsque vous souhaitez proposer différents parcours au contact en fonction d’une condition.
Dans notre exemple : tous les contacts dont l’adresse e-mail contient "company1" suivent le parcours A ; tous les autres suivent le parcours B.
Les conditions sont évaluées par le système de haut en bas jusqu’à ce qu’une condition soit remplie. Toutes les conditions suivantes ne sont alors plus évaluées.
Écouteur de mots-clés
Utilisez ce nœud lorsque vous souhaitez effectuer une action à partir de mots-clés que vous avez définis.
Dans notre exemple : dès que le contact envoie le mot-clé "Support", l’action connectée à la suite est déclenchée.
Dans un workflow démarré manuellement, ce nœud attend un message du contact dans la conversation. Placez-le donc après le nœud "Envoyer un message modèle WhatsApp" ; voir "Démarrage manuel par un opérateur".
Message
Utilisez ce nœud lorsque vous souhaitez afficher un ou plusieurs blocs de texte à vos contacts. Vous pouvez également ajouter des boutons ou des médias.
Dans notre exemple : après l’affichage du texte, le contact voit deux boutons cliquables qui le dirigent vers l’URL enregistrée.
Dans un workflow démarré manuellement, ce nœud ne fonctionne qu’après l’ouverture de la conversation par un modèle WhatsApp ; sinon, l’exécution se termine avec le statut "Erreur". Voir "Démarrage manuel par un opérateur".
Déclencher une extension
Utilisez ce nœud lorsque vous souhaitez déclencher une extension que nous proposons pendant la conversation.
Dans notre exemple : l’extension Lime CRM est déclenchée et la conversation est convertie en un objet Lime CRM. Cela se produit en arrière-plan.
Dans un workflow démarré manuellement, ce nœud ne fonctionne qu’après l’ouverture de la conversation par un modèle WhatsApp ; sinon, l’exécution se termine avec le statut "Erreur". Voir "Démarrage manuel par un opérateur".
Délai
Utilisez ce nœud lorsque le workflow doit attendre un certain temps avant l’exécution du nœud suivant. Sous Durée d’attente, saisissez un nombre entier et choisissez l’unité : secondes, minutes, heures ou jours.
Pour utiliser une variable comme durée d’attente, activez Utiliser une variable et sélectionnez une variable contenant la durée d’attente en secondes. Si la durée d’attente définie est supérieure à 24 heures et qu’un nœud qui envoie un message suit, l’éditeur affiche un avertissement : WhatsApp n’autorise pas l’envoi de messages libres plus de 24 heures après le dernier message du contact. Utilisez plutôt un modèle WhatsApp.