Nœuds de collecte d'informations

💡
Vous pouvez agrandir toutes les captures d’écran en cliquant dessus. Elles montrent le nœud lui-même ainsi que son menu de paramètres.

API request

Utilisez ce nœud pour échanger des données avec des systèmes externes au moyen de requêtes API. Utilisez les méthodes GET, POST, PUT ou DELETE. Vous pouvez également ajouter des en-têtes et un corps de requête. Enregistrez le résultat de la requête dans une variable pour l’utiliser plus tard dans la conversation.
Image without caption
Au lieu d’un corps de requête, vous pouvez également envoyer un fichier au système externe, par exemple un fichier que le contact a envoyé auparavant au moyen du nœud « Capture media » (décrit ci-dessous). Pour cela, cliquez sur « Add file ».
Une requête envoie soit un corps, soit un fichier, jamais les deux : le fichier remplace le corps. Si « Add file » n’est pas disponible, le nœud possède déjà un corps. Supprimez d’abord le corps, puis ajoutez le fichier.
Sous « File upload type », choisissez la façon dont le fichier est transféré :
  • Form data with file : choisissez cette option lorsque le système externe attend un fichier téléversé comme depuis un formulaire web. Le fichier est envoyé comme un champ du formulaire. Sous « Field name », indiquez le nom de ce champ. Si vous ne saisissez pas de nom, le champ est nommé « file ».
  • Raw file content : choisissez cette option lorsque le système externe attend le fichier lui-même comme corps de la requête. Le type du fichier est envoyé avec celui-ci.
Sous « File », saisissez le lien vers un fichier externe ou cliquez sur « Insert variable » dans le champ et sélectionnez la variable dans laquelle le nœud « Capture media » a enregistré le fichier. Il s’agit du même sélecteur de variables que dans les autres champs du workflow. Si le fichier ne peut pas être récupéré lors de l’exécution du workflow, par exemple parce que la variable est vide, la requête n’est pas envoyée et le workflow suit la sortie « If request failed ».
Image without caption
La zone « Body » du nœud dans le canevas du workflow indique alors ce qui est envoyé : « JSON Body », « Form data file » ou « Raw file ».

Capture carousel

Utilisez ce nœud pour permettre au contact de choisir parmi un nombre prédéfini d’options (avec image et description) et enregistrer temporairement son choix dans une variable afin de l’utiliser plus tard dans la conversation. Prévoyez un texte de remplacement au cas où les options ne pourraient pas être affichées.
Dans notre exemple : le contact est invité à choisir parmi trois options. Son choix est enregistré temporairement dans la variable « option ». Si les boutons ne peuvent pas être affichés, le texte de remplacement est diffusé.
Image without caption

Capture regex

Utilisez ce nœud pour vérifier que la saisie du client respecte un format spécifique prédéfini. Vous trouverez des exemples en développant la section suivante :
Image without caption
Exemples de regex :

Capture buttons

Utilisez ce nœud pour permettre au contact de choisir parmi un nombre prédéfini d’options et enregistrer temporairement son choix dans une variable afin de l’utiliser plus tard dans la conversation. Prévoyez un texte de remplacement au cas où les boutons ne pourraient pas être affichés.
Dans notre exemple : le contact est invité à choisir parmi trois options. Son choix est enregistré temporairement dans la variable « option ». Si les boutons ne peuvent pas être affichés, le texte de remplacement est diffusé.
Image without caption

Capture email

Utilisez ce nœud pour demander l’adresse e-mail du contact et l’enregistrer temporairement dans une variable afin de l’utiliser plus tard dans la conversation. Choisissez si vous souhaitez vérifier si la variable contient déjà des données et si vous souhaitez permettre au contact d’ignorer la saisie.
Dans notre exemple : le contact est invité à saisir son adresse e-mail. Sa saisie est enregistrée temporairement dans la variable « email ». Le système vérifie si la variable existe déjà et si elle est renseignée dans les champs de contact. Le contact ne peut pas ignorer la saisie.

Capture media

Image without caption
Utilisez ce nœud pour demander au contact d’envoyer un document dans un workflow. Choisissez le type de document (Image, Video, Audio, Document ou tout type).
Dans notre exemple : le contact est invité à fournir un document de type Image.
Utilisez ce nœud pour demander au contact d’envoyer un document dans un workflow. Choisissez le type de document (Image, Video, Audio, Document ou tout type).
Si vous souhaitez utiliser le fichier plus tard dans le workflow, saisissez un nom sous « Variable », par exemple « photo ». Le nœud enregistre alors un lien vers le fichier reçu dans cette variable. Cette étape est facultative.
Vous pouvez ensuite utiliser la variable dans deux nœuds. Dans les deux champs, insérez-la à l’aide de « Insert variable », où vous la trouverez sous « This Workflow » :
  • Message : cliquez sur « Add media » et insérez la variable dans le champ « URL » pour renvoyer le fichier au contact. Le nœud « Message » est décrit dans [Nœuds généraux](https://docs.lime-connect.com/general-nodes-2c482b4dcc478116a022c5e7f0dda78e).
  • API request : insérez la variable sous « File » pour envoyer le fichier à un système externe (voir la section « API request » ci-dessus).
Dans notre exemple : le contact est invité à fournir un document de type Image.
L’image est enregistrée dans la variable « photo » afin de pouvoir être renvoyée ou transmise plus tard dans le workflow.
Image without caption

Capture text

Utilisez ce nœud pour demander un texte quelconque au contact et l’enregistrer temporairement dans une variable afin de l’utiliser plus tard dans la conversation. Choisissez si vous souhaitez vérifier si la variable contient déjà des données et si vous souhaitez permettre au contact d’ignorer la saisie.
Dans notre exemple : le contact est invité à saisir le nom de son animal de compagnie. Sa saisie est enregistrée temporairement dans la variable « pet-name ». Le système vérifie si la variable existe déjà et si elle est renseignée dans les champs de contact personnalisés. Le contact peut ignorer la saisie.
Image without caption
Les nœuds Capture text, Capture email, Capture regex et Capture media partagent le même paramètre permettant d’ignorer l’étape. Activez « Optional » pour permettre aux contacts de passer l’étape. Sous « Skip button label », saisissez le texte du bouton, par exemple « Skip ». Le libellé peut comporter jusqu’à 20 caractères ; « Skip » est renseigné lorsque vous activez « Optional ».
Image without caption
Le contact voit alors le bouton sous votre message et peut cliquer dessus pour passer l’étape. Le workflow suit la sortie « When the input is skipped ». Si vous laissez « Skip button label » vide, aucun bouton ne s’affiche et les contacts ne peuvent passer l’étape qu’en saisissant un mot-clé prévu à cet effet, si votre workflow en comporte.
Le bouton s’affiche dans Website Messenger, WhatsApp et Facebook Messenger. Dans tous les autres canaux, le contact ne voit que votre message et ne peut passer l’étape qu’en saisissant un mot-clé prévu à cet effet. La saisie d’un tel mot-clé permet aussi de passer l’étape lorsque le bouton s’affiche. Tout autre texte, y compris « 1 », est traité comme la réponse à la question.

WhatsApp list

Utilisez ce nœud pour permettre à vos contacts de choisir parmi une liste prédéfinie d’options dans les canaux WhatsApp. Il peut afficher jusqu’à 10 options sous forme de liste.

WhatsApp quick response

Ce nœud s’utilise de la même manière que le nœud « Capture buttons » lorsque vous souhaitez utiliser le chatbot dans les canaux WhatsApp. Il peut afficher jusqu’à 3 boutons ou options.

Que se passe-t-il lorsqu’un contact répond par un message vocal ?

Un contact peut également répondre à un nœud en attente par un message vocal ou un fichier audio. Lime Connect transcrit l’enregistrement et le workflow utilise le texte comme si le contact l’avait saisi. La transcription est activée dans chaque organisation, sauf si elle a été désactivée. La section « Voice messages » du Message Center explique comment la désactiver et quelle quantité d’audio est transcrite par jour.
Voici comment chaque nœud traite le texte d’un message vocal :
  • Capture text, Capture email et Capture regex : le texte est vérifié comme une réponse saisie. S’il est valide, le workflow suit la sortie « If contact provided valid value » et enregistre le texte dans la variable du nœud. Sinon, il suit la sortie « If contact provided invalid value ». Cela se produit par exemple lorsque le contact dicte une adresse e-mail et que la transcription indique « nom arobase exemple point com » au lieu de « name@example.com ».
  • Capture buttons, Capture carousel, WhatsApp list et WhatsApp quick response : un message vocal ne sélectionne jamais une option, même si le contact en prononce le nom. Le workflow suit la sortie « If the contact does not respond or types any message ».
  • Capture media : le texte n’est pas utilisé et ne permet pas de passer ce nœud. L’enregistrement lui-même est considéré comme un fichier : le workflow suit la sortie « If contact provided valid media » si le nœud accepte les fichiers audio, et « If contact provided invalid media » s’il n’accepte qu’un autre type de fichier.
Si un enregistrement ne peut pas être transcrit, par exemple parce que la transcription a échoué ou que le quota quotidien est épuisé, Capture text, Capture email et Capture regex suivent la sortie « If contact provided invalid value » et n’enregistrent rien. Si cette sortie n’est pas connectée, le nœud reste en attente. Les nœuds proposant des options restent toujours en attente. Si la transcription est désactivée pour votre organisation, un message vocal ne répond pas du tout à ces nœuds et le nœud reste en attente.
Le texte ne répond qu’à un nœud qui était déjà en attente lorsque le contact a envoyé le message vocal. Si le workflow a avancé entre-temps, par exemple parce que le contact a saisi une réponse avant que la transcription soit prête, le texte du message vocal n’est pas utilisé.