Configurer un AI Agents (Cognigy) bot Voix

Utilisez ce sujet pour connecter un bot vocal AI Agents (Cognigy) à NiCE CXone pour les canaux vocaux. Lorsque vous effectuez cette procédure, les appels sont acheminés par le biais d'un script de canal de retour SIP Studio vers AI Agents (Cognigy), où le bot vocal gère l'interaction à l'aide du traitement de reconnaissance vocale (STT) et de synthèse vocale (TTS). À la fin de l'interaction, le bot envoie un signal de contrôle à NiCE CXone à l'aide de l'API Signal afin d'escalader l'appel vers un agent en direct ou de mettre fin à la conversation.

La configuration d'un bot vocal nécessite une action coordonnée entre NiCE CXone Services Professionnels, votre NiCE CXone représentant de compte, et votre AI Agents (Cognigy) administrateur. Contrairement à l'intégration des bots texte, l'intégration des bots vocaux ne peut pas être entièrement réalisée par un NiCE CXone Administrateur travaillant seul. Cette Page décrit chaque tâche et étape afin que toutes les parties disposent d'une référence complète de leurs responsabilités.

Comment fonctionne l'Intégration Voix Bot

Lorsqu'un contact lance ou reçoit un appel via un numéro DE téléphone attribué à un bot vocal AI Agents (Cognigy), NiCE CXone achemine l'appel vers un bot AI Agents (Cognigy) à l'aide d'une connexion de voie de retour SIP script Studio. AI Agents (Cognigy) gère la reconnaissance de la parole, le traitement des intentions et la génération de réponses en synthèse vocale entièrement au sein de sa plateforme.

À la fin de la conversation, AI Agents (Cognigy) utilise l'extension API Signal et TMS pour envoyer un signal de contrôle à NiCE CXone lui demandant d'escalader l'appel ou de mettre fin à l'interaction. L'extension envoie également la transcription de la conversation au service CXone Transcript Management Service (TMS) à des fins de Reporting, de résumés en self-service et d'analyses en aval.

Flux d'Appel du bot voix

  1. Un contact lance ou reçoit un appel en utilisant un numéro DE téléphone (soit un numéro de Numérotation directe vers l'intérieur (DID) pour les appels entrants, soit un ANI pour les appels sortants) attribué au bot vocal AI Agents (Cognigy) dans NiCE CXone.

  2. NiCE CXone achemine l'appel vers le script Studio Principale associé au flux d'appel.

  3. Le script principal génère un script enfant (canal de retour) et établit la connexion SIP de canal de retour vers AI Agents (Cognigy). NiCE CXone transmet les En-têtes SIP, y compris le numéro d'Unité commerciale, l'Id du contact principal et l'Id du contact engendré — à AI Agents (Cognigy) dans la charge utile de la demande SIP.

  4. AI Agents (Cognigy) reçoit l'appel et exécute le Flux configuré. Le Flux traite chaque énoncé vocal à l'aide de la fonction STT, identifie l'intention du contact et génère une réponse vocale à l'aide de la fonction TTS.

  5. À la fin de l'interaction, le Flux AI Agents (Cognigy) capture la transcription de la conversation à l'aide du nœud Get Transcript. AI Agents (Cognigy) exécute ensuite le nœud d'extension Exit Interaction, qui :

    1. Envoie la transcription à NiCE CXone TMS via l'API TMS.

    2. Envoie un signal Escalate to Agent ou End Conversation à NiCE CXone via l'API Signal.

  6. NiCE CXone agit en fonction du signal : il transfère l'appel à une file d'attente d'agents en direct ou met fin à l'interaction. Les tâches post-interaction, telles que la génération de résumé en self-service et le reporting, peuvent être effectuées par NiCE CXone après réception de la transcription, selon la configuration.

    L'action Échange voicebot Studio n'est pas utilisée pour les intégrations de bot vocal AI Agents (Cognigy). Le bot vocal AI Agents (Cognigy) utilise la méthode de canal secondaire SIP, qui repose sur le script de canal secondaire SIP principal et le script de canal secondaire généré fourni par les Services Professionnel.

Signal et extension API TMS

L'extension Signal et TMS API est une extension AI Agents (Cognigy) qui permet au bot vocal de communiquer les résultats de l'interaction à NiCE CXone. Elle fournit deux fonctionnalités qui s'exécutent en séquence à la fin de chaque interaction :

  • TMS API : Envoie la transcription de la conversation au CXone Transcript Management Service. NiCE CXone stocke la transcription à des fins de reporting et d'analyse. Si la fonctionnalité de résumés en libre-service est activée pour votre locataire, CXone peut générer un résumé à partir de la transcription. Pour activer les résumés en libre-service, vous devez avoir Copilot for Agents configuré et paramétré pour votre organisation ; consultez Configuration de Copilot for Agents et l'action AGENT ASSIST Studio pour plus de détails.

  • Signal API : envoie une demande à NiCE CXone lui demandant d'escalader l'interaction avec un agent en direct ou de mettre fin à la conversation. L'API Signal utilise les métadonnées SIP transmises à AI Agents (Cognigy) au début de l'appel pour identifier la bonne interaction NiCE CXone.

L'extension Signal et TMS API est actuellement distribuée sous la forme d'un fichier .gz obtenu auprès des Services Professionnels. Un nœud natif AI Agents (Cognigy) remplacera cette extension dans une prochaine version. Lorsque le nœud natif sera disponible, migrez vos Flows pour garantir la compatibilité et la prise en charge des fonctionnalités futures.

Conditions préalables

Vérifiez que tous les prérequis sont satisfaits avant de commencer cette procédure. Les prérequis manquants constituent la cause la plus fréquente des échecs d'intégration.

Exigences pour NiCE CXone

  • AI Agents (Cognigy) doit être activé pour votre locataire NiCE CXone. Cette application est activée par un TAM ou par les Services Professionnels. Si vous ne voyez pas l'option AI Agents (Cognigy) 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.

  • Un canal voix configuré dans NiCE CXone avec un numéro DE téléphone attribué au bot vocal (un numéro de Numérotation directe vers l'intérieur (DID) pour les appels entrants ou un ANI pour les appels sortants).

  • Une connexion de canal de retour SIP établie entre NiCE CXone et AI Agents (Cognigy) à l'aide de la convention de numérotation établie. Cette connexion est configurée par votre représentant de compte NiCE CXone ou par les Services Professionnels.

  • Studio scripts configurés pour la connexion de backchannel SIP. Contactez NiCE CXone Services Professionnels pour obtenir les modèles de scripts requis. Consultez le sujet Configurer les Scripts studio pour la connexion de backchannel SIP pour plus de détails.

  • Les NiCE CXone autorisations suivantes sont attribuées à votre rôle :

    • Voir Scripts

    • Créer/Modifier des Scripts (requis pour revoir et publier les scripts Studio)

Exigences pour AI Agents (Cognigy)

  • Un compte AI Agents (Cognigy) actif avec l'autorisation Modifier dans NiCE CXone (correspond au rôle Admin dans AI Agents (Cognigy)).

  • Un projet AI Agents (Cognigy) avec un Flux configuré et entraîné pour les interactions vocales. Le Flux doit inclure la fonctionnalité Voice Gateway et être capable de gérer l'interaction vocale, du message d'accueil jusqu'à la fin.

  • Un objet de connexion NiCE CXone configuré dans AI Agents (Cognigy). Cette connexion contient les identifiants utilisés par l'extension Signal et TMS API pour authentifier les demandes auprès de NiCE CXone. Cette configuration est effectuée par les Services Professionnel NiCE CXone.

  • Le progiciel d'extension Signal et TMS API (fichier .gz) obtenu auprès de NiCE CXone Services Professionnel. Vous devez disposer des autorisations nécessaires pour charger des extensions dans votre projet AI Agents (Cognigy).

  • En-têtes SIP transférés de NiCE CXone à AI Agents (Cognigy) dans la charge utile de la demande. Ceci est confirmé et configuré par les Services Professionnels NiCE CXone.

Configurer l'Intégration du bot vocal AI Agents (Cognigy)

Complete the following tasks in order. Each task depends on the results of the previous task.

  1. Activez AI Agents (Cognigy) pour votre locataire.

  2. Configurez le Flux AI Agents (Cognigy) pour la voix. Pour plus de détails, reportez-vous aux sujets AI Agents (Cognigy) Prise en main Guide et Référence du point de terminaison de la passerelle vocale.

    Le Flux doit inclure la fonctionnalité Voice Gateway pour gérer la reconnaissance vocale et la lecture TTS. Si votre Flux a été conçu à l'origine pour les interactions textuelles, il nécessite une modification importante avant de pouvoir prendre en charge la Voix.

  3. Téléchargez l'extension API Signal et TMS dans AI Agents (Cognigy).

  4. Configurez l'extension API Signal et TMS dans le Flux AI Agents (Cognigy).

  5. Configurer les Scripts Studio pour la connexion de backchannel SIP

  6. Obtenir, revoir et publier des scripts Studio

  7. Attribuez le script Studio au point de contact du canal voix

  8. Tester l'intégration du bot vocal