Configurer l'extension Signal et TMS API dans le Flux AI Agents (Cognigy)

Après avoir téléversé 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 de 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

  1. Dans AI Agents (Cognigy), ouvrez le Flux que vous avez configuré pour l'intégration du bot vocal.

  2. Sélectionnez Flux principal dans le sélecteur de flux en haut de l'éditeur de Flux si le projet contient plusieurs flux.

  3. Dans la branche Première fois du Flux, cliquez sur l'icône + et ajoutez un nœud Ajouter au Contexte.

  4. Configurez le nœud Ajouter au Contexte pour stocker la charge utile de la demande SIP entrante :

    1. Dans le champ clé Contexte, entrez : sipBody

    2. Dans le champ Valeur, entrez l'expression qui correspond au corps de la demande SIP entrante. Les Services Professionnels de NiCE CXone confirmeront l'expression exacte pour votre environnement.

  5. Cliquez sur Enregistrer le Nœud. La clé de contexte sipBody est maintenant disponible dans tout le Flux pour que le nœud Quitter l'interaction puisse la référencer.

Ajouter la logique du bot vocal

  1. Ajoutez ou vérifiez les nœuds de logique du bot dans le Flux, tels que les nœuds Dire, les nœuds Question, les gestionnaires d'intention et les solutions de repli en cas d'erreur.

  2. Assurez-vous que le Flux comprend un chemin clair vers la conclusion de l'interaction (escalade ou fin) qui se connecte au nœud Obtenir la transcription et au nœud Quitter l'interaction que vous ajouterez aux étapes suivantes.

Capturer la transcription de la Conversation

  1. Dans la branche Après du Flux (ou immédiatement avant le nœud Quitter l'interaction), cliquez sur + et ajoutez un nœud Obtenir la transcription.

  2. Configurez le nœud Obtenir la transcription avec les paramètres suivants :

    1. Emplacement de stockage

    2. Touche d'entrée

      Pour plus de détails, consultez le sujet nœud Obtenir la transcription.

    3. Limite : Entrez le nombre maximum de tours de Conversation à capturer. Une valeur de 25 convient à la plupart des déploiements.

  3. Cliquez sur Enregistrer le Nœud. Le nœud Obtenir la transcription capture la transcription et la stocke dans la saisir la variable de transcription. 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 tant que le nœud Quitter l'interaction ne s'exécute pas à l'étape suivante.

Configurer le Nœud Quitter l'interaction

  1. Après le nœud Obtenir la transcription, cliquez sur + et sélectionnez l'onglet Extensions .

  2. Sous la catégorie CXone, sélectionnez Quitter l'interaction. Le nœud est ajouté au Flux.

  3. Cliquez sur le nœud Quitter l'interaction, puis sélectionnez Modifier le Nœud.

  4. 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.

    Champs

    la description

    Impact si incorrect
    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 de région incorrecte entraîne l'échec silencieux des demandes 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 le paramètre Environnement est défini sur Other. Doit correspondre exactement à la région du locataire NiCE CXone.
    Action de transfert Sélectionnez Transmettre à l'Agent pour transférer le contact vers une file d'attente d'agents en direct, ou sélectionnez terminer la Conversation pour terminer l'interaction. Requis. Il s'agit du signal de contrôle primaire envoyé à NiCE CXone via l'API Signal.
    Numéro de l'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-BusNo"]}} Requis. 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 principal L'id du contact primaire NiCE CXone pour l'interaction. Mappé à partir des en-têtes sip. Par exemple, {{context.sipBody.headers["X-InContact-ContactId"]}} Requis. Identifie l'interaction voix spécifique à transmettre ou à terminer.
    Id du contact engendré L'id du contact engendré ou enfant pour le canal secondaire SIP. Mappé à partir des en-têtes sip. Par exemple, {{context.sipBody.headers["X-InContact-SpawnedId"]}} Requis. Identifie l'interaction du canal secondaire associée au contact principal.
    Connexion CXone Un objet de connexion préconfiguré dans AI Agents (Cognigy) qui contient les informations d'authentification NiCE CXone. Créé et configuré par les Services Professionnel de NiCE CXone. Obligatoire. Si la connexion est manquante ou mal configurée, toutes les demandes Signal API et TMS API sont rejetées.

  5. Cliquez sur Enregistrer le Nœud.

  6. Répétez cette configuration pour chaque chemin de sortie du Flux qui met fin à l'interaction ou qui l'escalade. Si vous avez à la fois un chemin escalade vers l'agent et un chemin Fin de la Conversation, ajoutez un nœud Sortie d'interaction distinct à chaque chemin et définissez le champ Action de transfert en conséquence.