Intégrer Google Dialogflow CX

Conditions préalables

Pour utiliser les Google Dialogflow CX agents virtuelsClosed A software application that handles customer interactions in place of a live human agent. avec NiCE CXone, vous devez disposer des éléments suivants :

  • Un compte sur la Plateforme Google Cloud

  • Un agent virtuel Google Dialogflow CX configuré et entraîné pour répondre aux demandes de vos contacts. Pour terminer l'intégration dans NiCE CXone, vous avez besoin du nom de l'agent virtuel à partir des paramètres de l'agent virtuel dans la console Google Dialogflow CX.

Alpha Visibility dans Google

Alpha Visibility est un programme Google qui permet aux Projets Google Cloud d’accéder à des fonctionnalités qui ne sont pas disponibles autrement. Alpha Visibility n’est pas requis pour utiliser Dialogflow CX avec NiCE CXone. Cependant, il existe certains cas où il peut être nécessaire d'avoir la visibilité alpha activée. La visibilité Alpha est requise si vous souhaitez :

  • Pour que le dernier énoncé utilisateur soit renvoyé par l'Dialogflow agent virtuel avec les informations sur l'intention. Ces informations sont accessibles depuis une trace de script. Si la variable lastUserUtterance est vide alors qu'elle devrait contenir des données, il est possible que la visibilité alpha ne soit pas activée pour votre projet. Si vous avez besoin de ces informations, la visibilité alpha doit être activée pour votre Google Cloud Project.

  • Pour que la page actuelle soit renvoyée dans le cadre de la charge utile personnalisée de la réponse.

  • Pour que le champ transcript Dialogflow soit renvoyé dans la charge utile de la réponse.

Créer un script

Autorisations requises : Studio script, Affichage, Création/Modification

Vous avez besoin d’au moins un script Studio pour acheminer les interactions à votre agent virtuel. Suivez les consignes relatives au script. Votre script doit avoir le type DE supportClosed A medium, such as voice, email, and chat, through which a contact connects with an intended recipient. téléphone pour un agent virtuel voix ou le type DE support digital pour un agent virtuel texte. Les actions de l'agent virtuel prises en charge pour ce fournisseur sont les suivantes :

Si vous configurez un agent virtuel voix et que vous utilisez un service NiCE CXone Text-to-Speech (Cloud TTS Hub), incluez l'action CLOUD TTS dans votre script.

Vous pouvez en savoir plus sur le scripting Studio dans les sections Fundamentals et Référence Technique Guide de l'aide en ligne.

  • Dialogflow CX n'utilise pas de contextes pour transmettre des données auxDialogflow intentionsClosed The meaning or purpose behind what a contact says/types; what the contact wants to communicate or accomplish. Dialogflow comme le fait Dialogflow ES.
  • Vous pouvez transmettre des données personnalisées à Dialogflow CX à l'aide de paires clé-valeur JSON. Dans un Snippet Action dans votre script, créez un objet customPayload dynamique et ajoutez-y les paires clé-valeur. Par exemple :

    DYNAMIC customPayload
    customPayload.ani = ani
    customPayload.contactID = contactId
    customPayload.masterContactId = masterId
    customPayloadJSON = "{customPayload.asJSON()}"	
  • Dans l'action Exchange de votre script, configurez la propriété customPayload avec une variable qui a la fonction asJSON() dans sa valeur. Vous trouverez cette variable dans l’objet customPayload.
  • Transmettez la JSON customPayload à l'agent virtuel à l'aide de la propriété Payload de QueryParameters. Consultez la documentation Google sur QueryParameters A square with an arrow pointing from the center out from the top right corner. pour Google Dialogflow CX.
  • Les données transmises par QueryParameters sont reçues par un webhook dans Dialogflow CX.Vous pouvez écrire du code dans la Dialogflow Console CX pour gérer les données transmises.
  • Ne imbriquez pas un objet dans l'objet customPayload. Les objets imbriqués sont envoyés sous forme de chaînes littérales.
  • Pour transmettre des données personnalisées depuis votre agent virtuel Dialogflow CX au script, utilisez le champ Charge utile personnalisée dans la console Dialogflow CX.Vérifiez que vous vous trouvez dans la console de l’agent virtuel que vous utilisez avec NiCE CXone. Mappez ceci sur votre script à l'aide de la variable customPayloadVarName (out) dans l'action VOICEBOT EXCHANGE ou TEXTBOT EXCHANGE Studio de votre script. Par exemple, vous pouvez l'utiliser pour définir le comportements du Prompt suivant.
  • Pour transmettre des données personnalisées à Dialogflow CX à partir du script, utilisez session_params dans l'objet customPayload au sein d'une action Snippet. Par exemple :

    DYNAMIC customPayload
    customPayload.session_params.name = "Winnie le Pooh" 
    customPayload.session_params.job = "Food critic" 
    customPayload.session_params.location = "Hundred Acre Wood"	

    Accédez aux paramètres de session dans l’intention de l’agent Dialogflow CX à l’aide de la syntaxe suivante :

    $session.params.name = Winnie Le Pooh
    $session.params.job = Food critic
    $session.params.location = 100 Acre Wood 

    Les paramètres de session sont uniquement utilisés avec les agents virtuels Dialogflow CX. Pour obtenir un résultat similaire avec Dialogflow ES, utilisez les contextes.

  • Configurer les indices de contexte de parole et un ID de conversation personnalisé pour transférer la conversation vers un autre agent virtuel CX Dialogflow dans l'extrait Charge utile personnalisée .

  • Pour configurer la durée d'attente de l'agent virtuel lorsque le contact fait une pause pendant qu'il parle, ajoutez paramètre maxPostEnergySilenceMS à l'action Next Prompt Behaviorsou Default Next Prompt Behaviors Extrait.

Ajouter une application à Virtual Agent Hub

Autorisations requises : Connections Hub > Lancer Connections Hub

L'ajout d'une application de configuration à Virtual Agent Hub établit la connexion entre NiCE CXone et votre fournisseur d'agents virtuels.

  1. Dans NiCE CXone, cliquez sur le sélecteur d'applications Icon of three-by-three grid of white squares on a blue background et sélectionnez Autre > Connection Hub, puis cliquez sur Virtual Agent Hub. Vous pouvez également double-cliquer sur l'Action agent virtuel dans votre script Studio pour lancer Virtual Agent Hub.
  2. Cliquez sur Ajouter un robot.
  3. Entrez un nom d'Agent virtuel (bot) et cliquez sur Dialogflow CX dans la liste des fournisseurs d'agents virtuels.

  4. Cliquez sur Prochain.

  5. Remplissez les champs du formulaire de configuration et cliquez sur Prochain. Vous trouverez plus d'informations sur ce formulaire dans la section Détail de la page de configuration de cette page.

  6. Cliquez sur Prochain.

  7. Si vous configurez un agent virtuel texte, sélectionnez Texte uniquement (sans Soutien vocal) sur la page Voice. Si vous configurez un agent virtuel Voix, consultez la section Configure Voice Integration Options de cette page.

  8. Sur la page Transcript, sélectionnez l'option permettant d'indiquer si vous souhaitez que la transcription de la conversation et les informations d'intention soient capturées. Si cet onglet n'est pas disponible, la fonctionnalité n'est pas activée pour votre locataireClosed High-level organizational grouping used to manage technical support, billing, and global settings for your NiCE CXone system.. Contactez votre représentant de compte pour obtenir plus d'informations sur cette fonctionnalité. Cette option est disponible uniquement pour les agents virtuels textuels et les agents virtuels vocaux basés sur des énoncés.

  9. Cliquez sur Prochain.

  10. Sur la page Tester + ajouter, vous pouvez tester la connexion de votre bot en envoyant des invites vocales ou textuelles. Si vos messages de test ne fonctionnent pas, cliquez sur Retour pour revenir à la page de configuration et vérifier les paramètres.

  11. Cliquez sur ajouter.

Google Dialogflow CX Détails de la page de configuration

Utilisez les informations présentées dans le tableau suivant lorsque vous remplissez la page Configuration. Vous voyez cette page lors de l'ajout d'une application dans Virtual Agent Hub

Champ

Détails

Version d’intégration

Sélectionnez le version de Virtual Agent Hub que vous souhaitez utiliser. Cette option vous permet d’utiliser une version précédente de Virtual Agent Hub jusqu’à ce que vous soyez prêt à passer à une nouvelle version. Les versions disponibles sont :

  • Version 1.0.0 : Il s'agit de la première version de Virtual Agent Hub. L'objet de charge utile personnalisée est renvoyé en tant que customPayload.payload.xxxx.Cette version n'est pas disponible pour ce fournisseur.
  • version 2.0.0 : Cette version a mis à jour les schémas utilisés avec Google Dialogflow CX. Cela a un impact sur la structure de l’objet customPayload. Cette version a mis à jour les schémas utilisés avec Google Dialogflow ES et CX. Cela a un impact sur la structure de l’objet customPayload.
  • Version 3.0.0 : Cette version a introduit StandardBot, qui standardise la manière dont NiCE CXone communique avec les fournisseurs d'agent virtuel. L'objet customPayload est renvoyé sous la forme d'un tableau, comme customPayloadscriptPayloads[n].xxxx. Cette version est disponible pour tous les fournisseurs.

Configuration SIP Ne pas activer cette option. NiCE CXone ne prend pas en charge une configuration de canal de retour SIP avec Google Dialogflow CX.
Compte de service JSON

Le fichier de clé de compte de service que vous avez créé et téléchargé depuis votre Console Google Cloud. Copiez et collez l'intégralité du contenu du fichier de clé dans ce champ, y compris les accolades entourant la clé. Ce champ est visible uniquement si vous utilisez votre propre compte Google Dialogflow CX. Si le champ n'est pas visible alors qu'il devrait l'être, demandez à votre représentant de compte NiCE CXone de revoir les paramètres de votre système.

La clé du compte de service est un objet JSON semblable à l'exemple suivant :

{

"type": "service_account",
"project_id": "ic-demo2-aai-gcp",
"private_key_id": "sdv80sdf08ssd9sdf0sdf8sdfsdf90sdf8",
"private_key": "-----BEGIN PRIVATE KEY-----
nMIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQCzgrS8vp
<private key has been truncated for this example>
----END PRIVATE KEY-----\n",
"client_email": "your@client_email-gcp.iam.gserviceaccount.com",
"client_id": "123456789",
"auth_uri": "https://accounts.google.com/o/oauth2/auth",
"token_uri": "https://oauth2.googleapis.com/token",
"auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
"client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/dialogflow-dthjop%40ic-demo2-aai-gcp.iam.gserviceaccount.com"
}

Le compte de service JSON doit disposer du rôle API Admin Dialogflow A square with an arrow point from the center out to the upper right corner..

Langue

La langue que vous souhaitez que cet agent virtuel utilise. C'est le langage que comprend l'agent virtuel. Ce champ est requis. Sélectionnez None pour supprimer le code de langue dans les demandes d'API. Utilisez cette option lorsque l'agent virtuel gère la détection de la langue par lui-même ou ne nécessite pas de code de langue.

Région

La région où le Google Dialogflow CX agent virtuel auquel vous ajoutezVirtual Agent Hub est situé. Ce champ est requis.

Agent

Le nom du Google Dialogflow CX agent virtuel auquel vous souhaitez ajouter Virtual Agent Hub. Vous pourrez trouver le nom dans la console Dialogflow CX de l’agent virtuel et cliquer sur Copier le nom pour le copier dans le presse-papiers. Ce champ est requis.

Environnement

Entrée du GUID de l'environnement que vous souhaitez que cette application Dialogflow utilise. Dans Dialogflow CX, différentes versions du même agent virtuel sont appelées « environnements ». Vous trouverez le GUID de vos environnements dans la console Google Dialogflow CX, dans les paramètres Agent.

Effectuer la Sortie TTS

Cliquez sur le curseur pour le basculer sur Activé si vous souhaitez utiliser le service de synthèse vocale Google Dialogflow CX (TTSClosed Allows users to enter recorded prompts as text and use a computer-generated voice to speak the content.). Configurez les options TTS pour Google.

Si vous ne souhaitez pas utiliser le service TTS Google Dialogflow CX, laissez ce champ défini sur Désactivé. Vous pouvez utiliser un service NiCE CXoneText-to-Speech (Cloud TTS Hub).

S'il s'agit d'un agent virtuel de type texte, laissez cette option désactivée.

Gestionnaire d’événement DE délai d’attente Nom du Google Dialogflow CX événement que vous souhaitez déclencher à l'expiration du délai.
Modèle de sortie en pause DTMF Si les caractères spécifiés sont enfoncés, le script passe directement à la branche SurDTMFBreakout.
Effectuer une analyse sentiment

Cliquez sur le curseur pour le mettre sur Activé si vous souhaitez recevoir les résultats de l'analyse des sentiments de Google. Cette option exige que vous ayez activé cette option dans votre projet Google Cloud. Vous êtes responsable de la configuration de l'utilisation des données d'analyse des sentiments avec votre agent virtuel.

Perform sentiment Analysis Google

Délai d’attente du fournisseur externe

Entrée le nombre de secondes pendant lesquelles vous souhaitez que le script attende une réponse de Dialogflow CX. Lorsque le délai d'attente est atteint, le contrôle revient au script, qui suit la branche d'erreur.

Profil Conversation

Entrez l'ID du profil de conversation Dialogflow CX que vous souhaitez que ce profil Virtual Agent Hub utilise. Si vous ne précisez pas d'ID, le système crée un nouveau profil. Vous pouvez trouver l'ID du profil de conversation dans votre console de gestion de projet Google.

Si vous modifiez les champs Agent ou Environnement, le champ Profil de conversation est effacé. Ceci est dû au fait que les profils de conversation sont spécifiques à l'agent et à l'environnement.

Configurer la Sortie TTS de Google Dialogflow CX

Autorisations requises : Connections Hub > Lancer Connections Hub

Complétez les étapes de cette section si vous souhaitez utiliser le service TTS Google. Les champs de l'image suivante apparaissent lorsque vous activez l'option Effectuer la Sortie TTS sur Dialogflow la page CX Configuration dans Virtual Agent Hub.

  1. Dans Virtual Agent Hub, ajoutez une nouvelle application de configuration et configurez-la selon les étapes de la section ajouter une application à Virtual Agent Hub sur cette page.
  2. Activezexécuter la Sortie TTS.
  3. Pour utiliser un modèle vocal personnalisé, activez Utiliser voix personnalisée et saisissez le nom du modèle AutoML que vous souhaitez utiliser dans le champ modèle de Voix personnalisé.

  4. Si vous souhaitez utiliser le modèle vocal Google, sélectionnez nom de la Voix TTS (synthèse vocale) dans la liste déroulante.

  5. Sélectionnez le modèle d'apprentissage automatique et la Variante DE modèle que vous souhaitez que les services TTS Google utilisent lors de la synthèse de la parole.

  6. Pour ajouter un silence au début de la réponse audio de l'agent virtuel, entrez le nombre de millisecondes de silence à ajouter dans le champ Add Leading Silence. La durée de silence recommandé est de 500 millisecondes.

  7. Entrée le Débit DE LA parole, le Ton et le Gain DE volume pour configurer le son de la Voix TTS selon vos préférences.

  8. Retournez à la Section Add an App to Virtual Agent Hub de cette page pour terminer l'ajout de l'application de configuration.

Configurer les options d'Intégration Voix

Autorisations requises : Connections Hub > Lancer Connections Hub

Si vous définissez un agent texte virtuel, vous pouvez ignorer cette section.

  1. Dans Virtual Agent Hub, ajoutez une nouvelle application de configuration et configurez-la selon les étapes de la section ajouter une application à Virtual Agent Hub sur cette page.
  2. Cliquez sur Suivant sur la page de configuration.

  3. Sur la page Voice, sous Options d'Intégration Voix, sélectionnez Turn by Turn Control (CXone Voicebot Gateway).
  4. Sous Transcription Options, sélectionnez l'option du service de transcription que vous souhaitez utiliser.

  5. Si vous choisissez d'utiliser un profil Turn-by-Turn Transcription, cliquez sur Turn-by-Turn Transcription Profil pour sélectionner celui que vous voulez utiliser. Cliquez sur ajouter un nouveau profil Turn by Turn Transcription pour créer un nouveau profil.
  6. Sous les options Transcription, sélectionnez un Profil Transcription ou cliquez sur ajouter un nouveau profil Transcription étape par étape pour créer un nouveau profil.
  7. Cliquez sur Prochain.
  8. Retournez à la Add an App to Virtual Agent Hub section sur cette Page pour terminer l'ajout de l'application de configuration.

Attribuer l'application Google Dialogflow CX à une Action

Autorisations requises : Studio script, Affichage, Création/Modification

Lorsque l'application agent virtuelClosed The meaning or purpose behind what a contact says/types; what the contact wants to communicate or accomplish. est installée et configurée dans Virtual Agent Hub, vous devez l'affecter à l'Action agent virtuel dans votre script. Cela permet de connecter l'action et le script à votre fournisseur d'agent virtuel.

  1. Dans Studio, ouvrez le script que vous souhaitez modifier.
  2. Si vous ne l'avez pas déjà fait, cliquez sur l'onglet Outils , développez la catégorie Automatisation et IA, puis ajoutez l'action d'agent virtuel que vous souhaitez utiliser. Veillez à la placer au bon endroit au sein de votre script. Si vous ne voyez pas l'action que vous attendez, vérifiez que votre type DE support du script est correct.Par exemple, si vous créez un script pour un agent virtuel voix, le script doit être un script téléphone.

  3. Cliquez sur Ouvrir l’éditeur sur l'action pour ouvrir Virtual Agent Hub.

  4. Dans la colonne de gauche, repérez le profil d'agent virtuel que vous souhaitez assigner à l'action, puis cliquez sur la coche Icône de cercle avec une marque à l’intérieur. à côté de celui-ci.

    Une autre solution que d'utiliser la coche consiste à créer une variable dans votre script Studio. Utilisez la variable pour transmettre le nom de l'application agent virtuel dans la propriété ID de l'Agent virtuel de l'action Virtual Agent Hub que vous utilisez.

  5. Cliquez sur Fermer.

Modifier le Profil Transcription

Autorisations requises : Connections Hub > Lancer Connections Hub

Un profil de transcription vous permet d'utiliser un service de transcription différent de celui proposé par le fournisseur d'agent virtuel. Chaque agent virtuel peut avoir un profil de transcription. Vous ne devez suivre les étapes de cette Section que si vous travaillez avec un agent virtuel vocal et que vous devez modifier le profil de transcription.

  1. Dans NiCE CXone, cliquez sur le sélecteur d'applications Icon of three-by-three grid of white squares on a blue background et sélectionnez Autre > Connection Hub, puis cliquez sur Virtual Agent Hub. Vous pouvez également double-cliquer sur l'Action agent virtuel dans votre script Studio pour lancer Virtual Agent Hub.
  2. Dans la liste des applications de configuration de l'agent virtuel située dans la partie gauche de la page Virtual Agent Hub, cliquez sur celle que vous souhaitez modifier.
  3. Dans le volet central de la page des propriétés de l'application agent virtuel, cliquez sur l'onglet Voix.
  4. Sous Transcription Options, sélectionnez Utiliser le Profil Turn-by-Turn Transcription si cette option n'est pas déjà sélectionnée.

  5. Sélectionnez le Profil TranscriptionTurn by Turn que vous voulez que cette intégration d'agent virtuel utilise. Si l'option que vous voulez utiliser ne figure pas dans la liste, vous pouvez l'ajouter.

  6. Cliquez sur enregistrer.
  7. Testez votre service de transcription en utilisant l'option microphone dans la Section Test de la Page des propriétés de l'application agent virtuel.

Test Votre Agent virtuel

Autorisations requises : Connections Hub > Lancer Connections Hub

Vous pouvez tester de nombreux aspects de votre agent virtuel pour vérifier que tout fonctionne comme prévu. Vous pouvez exécuter des tests depuis la page des propriétés de l'application agent virtuel dans Virtual Agent Hub. Lors des tests, vous pouvez :

  • Vérifiez que l'application de l'agent virtuel est configurée correctement pour communiquer avec le fournisseur d'agents virtuels.
  • Ajouter un JSON de charge utile personnalisée pour tester la manière dont l'agent virtuel traite les données de charge utile personnalisée ;
  • déclencher un événement d’intention DE bienvenue pour tester la manière dont l'agent virtuel commence une conversation ;
  • déclencher un événement d’intention personnalisée afin de tester les événements personnalisés que vous avez pu créer pour votre agent virtuel ;
  • déclencher un événement de dépassement DE délai pour tester la manière dont l'agent virtuel réagit lorsque le contact dépasse le délai imparti ;
  • tester la manière dont le robot traite les entrées DTMFClosed Signaling tones that are generated when a contact presses a key on the telephone keypad..

L'image suivante est un exemple de la page des propriétés d'une application d'agent virtuel dans Virtual Agent Hub (et non Dialogflow CX). Elle illustre les onglets Configuration et Voix, ainsi que le volet Test.

  1. Dans NiCE CXone, cliquez sur le sélecteur d'applications Icon of three-by-three grid of white squares on a blue background et sélectionnez Autre > Connection Hub, puis cliquez sur Virtual Agent Hub. Vous pouvez également double-cliquer sur l'Action agent virtuel dans votre script Studio pour lancer Virtual Agent Hub.
  2. Dans la liste située sur la gauche, cliquez sur l'application de configuration pour l'agent virtuel que vous voulez tester pour la sélectionner.
  3. Dans le volet Test, saisissez un message de test dans le champ Type a message et appuyez sur entrée pour l'envoyer. Vous pouvez également cliquer sur MicrophoneIcône en forme de microphone. et parler dans le microphone de votre ordinateur.

  4. Cliquez sur Commencez avec une intention DE bienvenue pour Démarrer une conversation test depuis le début. L'agent virtuel répond en utilisant son message de bienvenue par défaut. Vous pouvez entrer des messages de test.
  5. Cliquez sur Plus d’optionsIcône avec trois points empilés. pour tester d’autres aspects de votre agent virtuel.

  6. Cliquez sur Réinitialiser pour recommencer le test.
  7. Si vous devez effectuer des modifications en fonction des résultats de vos tests, vous pouvez :

    • modifier les scripts Studio de l'agent virtuel ;
    • Modifiez les paramètres de configuration dans l'application de l'agent virtuel dans Virtual Agent Hub.
    • Modifiez les paramètres de configuration de l'agent virtuel dans la console du fournisseur. Cliquez sur le bouton carré large sur la Page des propriétés de l'application dans Virtual Agent Hub. L'exemple au début de cette Section présente l'application Google Dialogflow CX avec le bouton du fournisseur. Elle comporte l'icône An icon that has a square with an arrow overlaid on top of it. The arrow points from the center of the square to the top right corner of the square. pour indiquer que le lien ouvre un site externe.
  8. Testez soigneusement l'agent virtuel après chaque modification de vos Scripts ou de tout paramètre de configuration.
  9. Lorsque vous avez terminé les tests, cliquez sur Fermer.