AI Agents (Cognigy) Extension API Signal et TMS pour escalader ou terminer la Voix Interactions

L'extension API Signal et TMS AI Agents (Cognigy) permet à votre bot voix AI Agents (Cognigy) de coordonner la transition des interactions et le traitement des transcriptions au sein de CXone. L'extension fournit deux fonctionnalités clés :

  • Signal : Envoie une demande API Signal CXone qui demande à CXone soit d'escalader l'interaction vers un Agent en direct, soit de mettre fin à la conversation.

  • TMS API : envoie la transcription de la conversation au service de Gestion des transcriptions (TMS) CXone afin que CXone puisse générer des résumés en self-service et prendre en charge le reporting et l'analyse en aval.

Ensemble, ces fonctionnalités garantissent que les interactions voix passent de manière fluide du bot à CXone et que les données de transcription sont conservées pour le traitement par CXone.

L'extension actuelle, distribuée sous forme de fichier .gz, sera remplacée par un nœud AI Agents (Cognigy) natif afin de simplifier le déploiement. Lorsque le nœud natif sera disponible, suivez les instructions de migration fournies dans ce sujet.

Si vous utilisez déjà l'extension, vous devez prévoir de supprimer l'extension et de basculer vers le nœud natif dès sa sortie. La mise à jour n'est pas urgente, mais elle est recommandée dans le cadre de la maintenance standard et pour garantir la compatibilité avec les futures fonctionnalités.

Ce sujet explique comment activer l'accès, charger l'extension et la configurer dans un Flux Cognigy AI.

Conditions préalables

Avant de commencer, assurez-vous des points suivants :

  • Vous devez avoir activé Cognigy AI pour votre locataire. Pour savoir comment activer l'application et y accéder via SSO, consultez Activer l'application AI Agents (Cognigy) et l'accès SSO.

  • Un projet AI Agents (Cognigy) avec des autorisations pour charger des extensions

  • Un canal voix connecté à CXone au moyen du backchannel SIP

  • Accès au progiciel d'extension API Signal et TMS (.gz) auprès des Services Professionnels.

  • CXone Studio scripts configurés :

    • Script backchannel SIP principal

    • Script de canal secondaire généré

    • CXone jeton / script Integration Hub

    • La génération de token CXone est un script recommandé, mais non obligatoire. Une licence Integration Hub est requise pour générer un token CXone chiffré. Sans cette licence, le token CXone peut toujours être généré ; cependant, il restera en texte brut, ce qui est moins sécurisé et non recommandé pour les environnements de production.

    • Contactez Services Professionnel pour obtenir les modèles de script Studio complets. Les scripts Démo sont simplifiés et ne sont pas destinés à la production.

  • Les en-têtes SIP sont disponibles dans la charge utile de la demande CXone → AI Agents (Cognigy)

  • Integration Hub et configuration de CXone Studio terminée.

    Integration Hub et la configuration de CXone Studio sont en dehors de la portée de cette tâche et sont fournis séparément par les Services Professionnel.

Charger Signal et l'extension API TMS dans un Flux

  1. Ouvrez votre projet AI Agents (Cognigy).

  2. Dans la navigation de gauche, sélectionnez Manage > Extensions.

  3. Sélectionnez Upload Extension.

  4. Accédez au fichier .gz de l'extension Signal et TMS API et sélectionnez-le. Sélectionnez Ouvrir.

    Un message de réussite confirme que l'extension est installée et apparaît sous (par exemple, Signal CXone).

Utiliser l'extension API Signal et TMS dans un Flux

  1. Dans AI Agents (Cognigy), sélectionnez Build > Flux.

  2. Dans la liste, sélectionnez le Flux que vous souhaitez modifier, par exemple SayHelloAndHandover.

  3. Si le projet contient plusieurs flux, sélectionnez Main Flow dans le sélecteur de Flux en haut. Le flux s'ouvre dans la vue Chart, où vous pouvez ajouter et configurer des nœuds.

    L'extension nécessite des métadonnées SIP pour identifier l'interaction CXone.

  4. Dans la branche On First Time du Flux, ajoutez un nœud Add to Context.

  5. Stockez la charge utile de la demande SIP entrante dans le contexte, par exemple :

    1. Clé de contexte : sipBody

    2. Valeur : corps de la demande SIP Entrant

    Ces données SIP sont réutilisées ultérieurement lors de l'envoi de signaux à CXone.

  6. Ajoutez la logique de bot requise, comme des nœuds Say ou la gestion des intentions.

  7. Vérifiez que le bot se comporte comme attendu avant l'escalade ou la fin.

    Cette étape n'est pas spécifique à l'extension, mais elle est nécessaire pour une interaction voix complète.

  8. Dans la branche Afterwards du Flux, ajoutez un nœud Get Transcript. Le nœud Get Transcript collecte la transcription et la stocke dans la variable transcript que vous avez définie.

  9. Configurez le nœud Get Transcript :

    1. Saisie

    2. Clé de saisie : transcription

    3. Limiter : Selon les besoins (par exemple, 25 tours)

    Le nœud Obtenir la transcription capture uniquement la transcription dans le flux. La transcription est envoyée à CXone TMS par le nœud Quitter l'interaction à l'étape suivante.

  10. Ajoutez un nœud d'extension Quitter l'interaction après le nœud Obtenir la transcription.

    1. Dans l'éditeur de Flux, sélectionnez l'icône plus (+) à l'endroit où le nœud doit être ajouté.

    2. Sélectionnez l'onglet Extensions > catégorie CXone > Exit Interaction. Le nœud d'extension est ajouté à votre flux.

  11. Ouvrez le nœud d'extension Quitter l'interaction et sélectionnez Modifier le Nœud, configurez les champs suivants :

    Nom du champ

    Description

    Environnement Environnement CXone. Sélectionnez Other si vous utilisez une URL de base CXone personnalisée.
    URL de base de l'environnement L'URL de base de l'API CXone (par exemple, https://cognigy-na1.nicecxone.com

    Action Remettre

    Sélectionnez Escalate to Agent ou terminer la conversation.

    Numéro de l'unité commerciale

    ID de l'unité commerciale CXone. Généralement mappé à partir des En-têtes SIP, par exemple : {{context.sipBody.headers["X-InContact-BusNo"]}}.

    Id du contact principale

    Id du contact CXone primaire à partir des En-têtes SIP.

    Id du contact généré

    Id du contact généré ou enfant extrait des En-têtes SIP.

    CXone Connection Connexion cxone préconfigurée utilisée pour authentifier les demandes API de Signal et TMS.

    Lorsque vous utilisez le modèle fourni par l'équipe Services Professionnels, les champs obligatoires Quitter l'interaction – tels que le Numéro d'Unité commerciale, l'Id du contact principal, l'Id du contact généré et la connexion cxone – sont pré-remplis dans le modèle. Vous devez néanmoins vérifier les valeurs pour vous assurer qu'elles correspondent à votre environnement et à votre configuration d'intégration.

  12. Le nœud Quitter l'interaction envoie la Variable de transcription à CXone à l'aide de l'API TMS.

  13. CXone traite la transcription et la met à disposition des applications en aval. La génération d'un résumé en libre-service est en option et, si elle est activée, elle est créée en fonction du contenu de la transcription. Les variables basées sur la transcription sont stockées dans CXone pour les rapports et les analyses en aval.

  14. Sélectionnez enregistrer le Nœud.

Fonctionnement de l'extension API Signal et TMS

Les extensions Signal et TMS API fonctionnent ensemble pour garantir qu'une interaction est correctement finalisée dans CXone et que les données de transcription sont disponibles pour une utilisation ultérieure.

Avant que ce processus ne commence, les métadonnées SIP et la transcription doivent déjà être disponibles. une fois celles-ci en place, le flux principal fonctionne comme suit :

  1. Le nœud Quitter l'interaction déclenche les deux API dans une séquence définie :

    1. TMS API

      1. Envoie la transcription à CXone.

      2. Stocke les données basées sur les transcriptions pour le reporting et l'analytique.

      3. Génère éventuellement un résumé du self-service si cette fonctionnalité est activée.

    2. Signal API

      1. Envoie une demande à CXone pour escalader l'interaction ou y mettre fin.

      2. Utilise les métadonnées SIP capturées précédemment pour identifier l'interaction CXone correcte.

Scripts démo

Script de canal secondaire SIP principale

script backchannel généré

Jeton CXone ou Integration Hub script