Configurer un bot de texte AI Agents (Cognigy) dans Virtual Agent Hub
Utilisez cette page pour connecter un bot textuel AI Agents (Cognigy) à NiCE CXone via Virtual Agent Hub. Lorsque vous effectuez cette procédure, NiCE CXone achemine les messages du client provenant d'un canal numérique via Studio et Virtual Agent Hub vers votre bot AI Agents (Cognigy), et renvoie les réponses du bot au contact. Cette intégration prend en charge les digital channels textuels, y compris le clavardage numérique, WhatsApp, Apple Messages for Business, Facebook Messenger et SMS Messaging.
Cette page couvre uniquement les intégrations de bots textuels. Les intégrations de bots Voix utilisent une méthode de canal de retour SIP distincte et nécessitent l'assistance de votre représentant de compte NiCE CXone. N'utilisez pas cette procédure pour configurer un bot vocal.
Fonctionnement de l'Intégration Text Bot
Lorsqu'un contact envoie un message via un canal numérique, NiCE CXone achemine l'interaction vers un script Studio. Le script utilise l'action TextBotExchange pour transférer le message à AI Agents (Cognigy) via Virtual Agent Hub. AI Agents (Cognigy) traite le message, identifie l'intention du contact et renvoie une réponse ainsi qu'un signal de contrôle. Le script délivre ensuite la réponse au contact ou agit en fonction du signal de contrôle.
Flux Message
La séquence suivante décrit le flux de messages pour chaque tour de parole dans une conversation avec un bot textuel :
-
Le contact envoie un Message via un canal numérique.
-
Le canal numérique invoque l'action AskCaller pour transmettre le message au script Studio.
-
Le script Studio transmet le message à l'action TextBotExchange.
-
L'action TextBotExchange envoie le message à AI Agents (Cognigy) via le Virtual Agent Hub.
-
AI Agents (Cognigy) traite le message et génère une réponse.
-
Le Virtual Agent Hub transmet la réponse et le signal de contrôle de AI Agents (Cognigy) à l'action TextBotExchange.
-
L'TextBotExchange action transmet la réponse et le signal de contrôle au script Studio.
-
Le script Studio évalue le signal de contrôle et détermine la branche appropriée.
-
Si la conversation continue : le script Studio revient à l'action AskCaller, passez à l'étape 9.
-
Si la tâche est terminée ou si une escalade est nécessaire : le script Studio quitte la boucle du bot et se poursuit avec l'action suivante du script.
-
-
L'action AskCaller transmet la réponse au contact via le canal numérique et attend le prochain message. Le flux reprend à partir de l'étape 1.
Ceci s'applique uniquement à la branche OnPromptAndCollectNextResponse.
Contrôle des signaux renvoyés par AI Agents (Cognigy)
Après chaque tour, AI Agents (Cognigy) renvoie un des signaux de contrôle suivants à l'action TextBotExchange. Votre script Studio doit gérer chaque signal :
-
PromptAndCollectNextResponse : la conversation doit se poursuivre. Le script revient à l'action AskCaller pour attendre le prochain message du contact.
-
OnReturnControlToScript : l'agent virtuel a terminé sa tâche ou a déterminé qu'un agent en direct est nécessaire. Le contrôle revient au script Studio. AI Agents (Cognigy) transmet les données d'escalade via lecustomPayload, et le script Studio les lit pour déterminer la prochaine action de routage. La meilleure pratique consiste à utiliser une intention d'escalade qui commence par escalat afin que le script puisse détecter de manière fiable l'escalade entre différents noms d'intention de bot, comme « escalate » ou « escalation ».
-
En cas d'erreur : Une erreur inattendue s'est produite. Le script suit le chemin de gestion des erreurs. Vérifiez la variable _ERR et la propriété de sortie errorDetailsVarName pour plus de détails.
Conditions préalables
Vérifiez que tous les prérequis sont remplis avant de commencer cette procédure. Les prérequis manquants sont la cause la plus fréquente des échecs d'intégration.
Exigences pour NiCE CXone
-
activé pour votre unité commerciale ou locataire. Contactez votre TAM si Virtual Agent Hub n'est pas disponible dans votre système.
-
AI Agents (Cognigy) doit être activé pour votre locataire NiCE CXone. Cette application est activée par un TAM ou les Services Professionnels. Si l'option AI Agents (Cognigy) ne figure pas dans le menu de l'application, vérifiez que les rôles et autorisations appropriés sont attribués. Si les autorisations requises ne sont pas disponibles, votre organisation n'est pas configurée pour utiliser AI Agents (Cognigy) ; dans ce cas, contactez votre TAM.
-
Afficher, créer et modifier des Scripts - requis pour créer et modifier des scripts Studio.
-
Un digital channel configuré dans CXone Digital Experience (DX). Digital channels textuels pris en charge, notamment le clavardage numérique, WhatsApp, Apple Messages for Business, Facebook Messenger et SMS Messaging.
-
Un script Studio configuré pour un type DE support numérique (ou l'autorisation d'en créer un). Les types de scripts Voix ne prennent pas en charge l'Action TextBotExchange.
Exigences pour AI Agents (Cognigy)
-
Un projet AI Agents (Cognigy) avec un Flux entièrement configuré, entraîné et prêt pour le déploiement. La bonne pratique consiste à ce que le Flux inclue des réponses pour au moins l’intention DE bienvenue et une intention DE délai d’attente.
-
Autorisation Edit dans NiCE CXone pour AI Agents (Cognigy) (correspond au rôle Admin dans AI Agents (Cognigy)), ou autorisations AI Agents (Cognigy) suffisantes pour créer et gérer des Endpoints.
-
Une compréhension du nom de projet AI Agents (Cognigy) et du Flux que vous souhaitez utiliser.
Configurez l'Intégration du bot de texte AI Agents (Cognigy)
Effectuez les tâches suivantes dans l'ordre. Chaque tâche dépend des résultats de la tâche précédente.