Configurer l'Action TextBotExchange

L'action TextBotExchange envoie les messages du contact à AI Agents (Cognigy) et reçoit les réponses du bot. Elle fournit également des variables de sortie et des conditions de branchement que votre script utilise pour déterminer ce qui se passe ensuite. Configurez les propriétés de l'action comme décrit dans cette tâche.

Autorisations requises : Studio Script, Affichage, Créer/Modifier

Dans le script Studio, cliquez sur Actions dans le panneau de droite.
Développer la catégorie Web Editor URL.
Faire glisser l'Action TextBotExchange sur le canevas du script. Placez-la après l'Action qui recueille la saisie du contact.
Si votre script nécessite plus d'un tour, ajoutez une seconde Action TextBotExchange et connectez-la dans la boucle de conversation. Un minimum de deux Actions TextBotExchange est requis pour la plupart des implémentations.
Avant la première TextBotExchange Action, ajoutez une Extrait Action et configurez-la avec le Bot Session State code d'extrait. Cet extrait initialise la variable botSessionState qui conserve le contexte de la conversation entre les tours.

Propriétés de saisie

Sélectionnez l'action TextBotExchange et configurez les propriétés de saisie suivantes dans le panneau Propriétés. Utilisez le tableau ci-dessous pour comprendre chaque propriété :

Propriété	Valeur ou FORMAT acceptable	Description
	Étiquette courte et descriptive. Exemple : TextBotExchange_CognigyStart	Identifie cette action spécifique sur le canevas Studio. La valeur par défaut est « Échange textbot ». Entrée un intitulé unique lorsque votre script contient plus qu'une TextBotExchange action.
Id de l’agent virtuel	Renseigné automatiquement après avoir attribué le bot dans le Virtual Agent Hub. La valeur correspond au Virtual Agent (Bot) Name de Virtual Agent Hub.	Identifie la configuration Virtual Agent Hub à utiliser. Ce champ est renseigné automatiquement lorsque vous affectez le bot à l'action dans Virtual Agent Hub. Vous pouvez remplacer cette valeur en utilisant une variable Studio, par exemple {virtualAgentId}, si vous devez sélectionner dynamiquement la configuration du bot au moment de l'exécution. Cette approche est couramment utilisée lors du basculement entre plusieurs configurations de bot.
Intention automatisée	Chaîne Standard : Bienvenue. Utilisée uniquement lors du premier tour.	Appelle une intention spécifique dans AI Agents (Cognigy) au lieu d’envoyer la saisie tapée par le contact. Ce champ peut être utilisé pour appeler des intentions prédéfinies telles que Welcome ou toute autre intention prise en charge dans le bot. Bien qu’il soit couramment utilisé lors du premier tour pour déclencher un message de bienvenue, il peut également être utilisé lors des tours suivants pour appeler dynamiquement d’autres intentions. Laissez ce champ vide lorsque vous souhaitez transmettre le message réel du contact à la place.
Saisie utilisateur	Studio variable qui contient le message saisi par le contact. Exemple : {customerMessage}	Le message texte saisi par le contact, transmis à AI Agents (Cognigy) pour la reconnaissance d'intention et la génération de réponse. Lors du premier tour, ce champ peut être vide si AutomatedIntent est défini sur Welcome. À chaque tour suivant, ce champ doit contenir le dernier énoncé du contact.
Charge utile personnalisée	Objet JSON converti en chaîne. Exemple : {customPayload.asJSON()}. En option.	Transmet des données contextuelles personnalisées du script Studio à AI Agents (Cognigy). Exemples : nom du contact, ID de compte ou données CRM. Vous devez définir l'objet de charge utile personnalisée dans une action Snippet. N'utilisez pas cette propriété si vous devez traiter des données que l’agent virtuel renvoie au script. Utilisez plutôt la variable customPayloadVarName (sortie).
État de session du robot	Variable renseignée par botSessionStateVarName (out) du tour précédent. Exemple : {botState}	Maintient le contexte de la conversation entre les tours en renvoyant un identifiant de session à AI Agents (Cognigy) à chaque demande. AI Agents (Cognigy) crée cet identifiant lors du premier tour. À tous les tours suivants, le script doit transmettre la valeur stockée dans N'utilisez pas cette propriété si vous devez traiter des données que l'agent virtuel renvoie au script. Utilisez plutôt la variable customPayloadVarName (sortant) dans ce champ. Si vous ne configurez pas cela correctement, AI Agents (Cognigy) crée une nouvelle session à chaque tour et perd le contexte.

Propriétés de sortie

Les propriétés de sortie suivantes sont disponibles après l'exécution de l'TextBotExchange action. Référencez ces variables dans les actions suivantes de votre script.

Propriété	Valeur ou FORMAT acceptable
Nom de la variable Prompt suivante (sortie)	Contient les paramètres de comportement qui contrôlent la manière dont NiCE CXone invite le contact lors du prochain tour de la conversation. Cette variable peut être modifiée dans une action Snippet avant le prochain appel TextBotExchange afin de personnaliser le comportement pour chaque tour.
Nom DE variable charge utile personnalisée (sortie)	Renvoie des données JSON personnalisées de AI Agents (Cognigy) vers le script Studio. Utilisez cette propriété pour traiter les données de traitement ou les instructions de routage envoyées par AI Agents (Cognigy). Les valeurs courantes incluent : escalat ou toute intention commençant par escalat, telle que « escalate » ou « escalation » — Achemine le contact vers un agent en direct. Le script Studio détecte ce préfixe afin de gérer l'escalade de manière fiable, quels que soient les noms d'intentions de bot utilisés. end — L'interaction se termine. Le script Studio utilise cette valeur pour terminer proprement la session de contact. Ne confondez pas cela avec la propriété de saisie customPayload.
Nom DE variable Détails de l'erreur (sortie)	Contient des informations sur l'erreur lorsque la branche En cas d'erreur est empruntée. Examinez cette variable dans la branche En cas d'erreur pour enregistrer ou traiter l'erreur. La variable système _ERR est également renseignée avec une description condensée de l'erreur.
Nom DE variable des informations sur l'intention (sortie)	Contient des détails sur l'intention identifiée par AI Agents (Cognigy) pour le tour actuel. Utilisez cette Variable dans votre script pour enregistrer les données d'intention ou prendre des décisions de routage basées sur l'intention identifiée.
Nom de la variable d'état de session du bot (sortie)	Contient l'identifiant d'état de session renvoyé par AI Agents (Cognigy) après chaque tour. Vous devez transmettre la valeur de cette variable dans la propriété de saisie botSessionState au tour suivant afin de maintenir le contexte de la conversation. Cette propriété est requise pour un fonctionnement correct.