Configurer l'extension API Signal et TMS dans le Flux AI Agents (Cognigy)
Après avoir téléchargé l'extension, configurez le Flux AI Agents (Cognigy) pour capturer les métadonnées SIP et la transcription de la conversation, et pour envoyer le signal de contrôle correct à NiCE CXone à la fin de chaque interaction.
Lorsque vous utilisez les modèles de script Studio fournis par les Services Professionnels NiCE CXone, les champs Quitter l'interaction sont pré-remplis. Il est recommandé de revoir la valeur de chaque champ pour vérifier qu'elle correspond à votre environnement avant les tests.
Capturer les Métadonnées SIP
-
Dans AI Agents (Cognigy), ouvrez le Flux que vous avez configuré pour l'intégration du bot vocal.
-
Sélectionnez Main Flow dans le sélecteur de Flux en haut de l'éditeur de flux si le projet contient plusieurs Flux.
-
Dans la branche On First Time du Flux, cliquez sur l'icône + et ajoutez un nœud ajouter au Contexte.
-
Configurez le nœud Add to Context pour stocker la charge utile de la demande SIP entrante :
-
Dans le champ clé Contexte, entrez : sipBody
-
Dans le champ Valeur, entrée l'expression qui correspond au corps de la demande SIP entrante. NiCE CXone Les Services Professionnels confirmeront l'expression exact pour votre environnement.
-
-
Cliquez sur enregistrer le Nœud. La clé de contexte sipBody est désormais disponible dans l'ensemble du Flux pour que le nœud Quitter l'interaction puisse y faire référence.
Ajouter une logique de bot Voix
-
Ajoutez ou vérifiez les nœuds de logique du bot dans le Flux, tels que les nœuds Say, les nœuds question, les gestionnaires d'intentions et les repli en cas d'erreur.
-
Assurez-vous que le Flux inclut un chemin clair vers la conclusion de l'interaction (escalade ou fin) qui se connecte au nœud Get Transcript et au nœud Quitter l'interaction que vous ajouterez lors des étapes suivantes.
Capturer la transcription de la conversation
-
Dans la branche Ensuite du Flux (ou immédiatement avant le nœud Quitter l'interaction), cliquez sur + et ajoutez un nœud Obtenir la transcription.
-
Configurez le nœud Get Transcript avec les paramètres suivants :
-
Emplacement du magasin
-
Clé de saisie
Pour plus de détails, consultez le sujet Get Transcript node.
-
Limite : entrez le nombre maximum de tours de conversation à capturer. Une valeur de 25 convient à la plupart des déploiements.
-
-
Cliquez sur enregistrer le Nœud. Le nœud Obtenir la transcription capture la transcription et la stocke dans la saisir la variable transcript. Le nœud Quitter l'interaction lit cette variable et l'envoie à NiCE CXone TMS à l'étape suivante.
Le nœud Obtenir la transcription capture la transcription uniquement dans le Flux. La transcription n'est pas envoyée à NiCE CXone jusqu'à ce que le nœud Quitter l'interaction s'exécute à l'étape suivante.
Configurer le Nœud Quitter l'interaction
-
Après le nœud Get Transcript, cliquez sur + et sélectionnez l'onglet Extensions .
-
Dans la catégorie CXone, sélectionnez Quitter Interaction. Le nœud est ajouté au Flux.
-
Cliquez sur le nœud Exit Interaction et sélectionnez Edit Node.
-
Configurez les champs suivants. Utilisez le tableau ci-dessous pour connaître les descriptions des champs, les valeurs acceptables et l'impact des valeurs incorrectes.
Champ
description
Incidence en cas d'erreur
Environnement Sélectionnez la région d'environnement NiCE CXone qui correspond à votre locataire. Sélectionnez Autre si vous utilisez une URL de base NiCE CXone personnalisée. Obligatoire. Une sélection incorrecte de la région entraîne l'échec silencieux des demandes de l'API Signal. URL de base de l'environnement L'URL de base pour votre environnement API NiCE CXone. Par exemple, https://cognigy-na1.nicecxone.com Requis lorsque Environnement est défini sur Autre. Doit correspondre exactement à la région du locataire NiCE CXone. Action de transfert Sélectionnez Escalate to Agent pour transférer le contact à une file d'attente d'agents en direct, ou sélectionnez End Conversation pour terminer l'interaction. Obligatoire. Il s'agit du signal de contrôle primaire envoyé à NiCE CXone via l'API Signal. Numéro d'unité commerciale Votre ID d'unité commerciale NiCE CXone. Généralement mappé à partir des En-têtes SIP. Par exemple, {{context.sipBody.headers["X-InContact-BusNon"]}} Obligatoire. NiCE CXone utilise cette valeur pour identifier le locataire correct. Une valeur incorrecte entraîne l'échec de l'authentification de l'API Signal. Id du contact principale L'id du contact NiCE CXone primaire pour l'interaction. Mappé à partir des En-têtes SIP. Par exemple, {{context.sipBody.headers["X-InContact-ContactId"]}} Obligatoire. Identifie l'interaction voix spécifique à escalader ou à terminer. Id du contact généré L'id du contact généré ou enfant pour le canal de retour SIP. Mappé à partir des En-têtes SIP. Par exemple, {{context.sipBody.headers["X-InContact-SpawnedId"]}} Obligatoire. Identifie l'interaction de rétroaction associée au contact principal. CXone Connection Un objet de connexion préconfiguré dans AI Agents (Cognigy) qui contient les identifiants d'authentification NiCE CXone. Créé et configuré par les Services Professionnel NiCE CXone. Obligatoire. Si la connexion est manquante ou mal configurée, toutes les demandes Signal API et TMS API sont rejetées. -
Cliquez sur enregistrer le Nœud.
-
Répétez cette configuration pour chaque chemin de sortie du Flux qui met fin à l'interaction ou qui l'escalade. Si vous disposez à la fois d'un chemin Escalate to Agent et d'un chemin End Conversation, ajoutez un nœud Exit Interaction distinct à chaque chemin et définissez le champ Remettre Action en conséquence.