Intégrer Google Dialogflow CX

Conditions préalables

Pour utiliser les agents virtuelsClosed Une application logicielle qui traite les interactions avec les clients à la place d’un agent humain en direct. Google Dialogflow CX avec NiCE CXone, vous avez besoin des éléments suivants :

  • Un compte sur la plateforme Google Cloud.

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

Visibilité Alpha dans Google

La visibilité alpha est un programme Google qui donne aux Projets Cloud Google accès à des fonctionnalités qui ne sont pas disponibles autrement. La visibilité alpha n’est pas requise pour utiliser Dialogflow CX avec NiCE CXone. Toutefois, il existe certains cas où vous devrez peut-être activer la visibilité alpha. La visibilité alpha est requise si vous souhaitez :

  • Pour que le dernier énoncé de l’utilisateur soit retourné par l’agent virtuel Dialogflow avec les informations d’intention. Vous pouvez consulter ces informations dans 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 Projet Cloud Google.

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

  • Pour que le champ de transcription Dialogflow soit retourné dans le cadre de la charge utile de la réponse.

Créer un script

autorisations requises : Studio Script View, Create/Edit

Vous avez besoin d’au moins un script Studio pour acheminer les interactions vers votre agent virtuel. Suivez les directives de script. Votre script doit avoir le type de supportClosed Un moyen, tel que la voix, les courriels et les clavardages, à travers lequel un contact se connecte au destinataire voulu. téléphone pour un agent virtuel voix ou le type de support numérique pour un agent virtuel texte. Les actions d’agent virtuel prises en charge pour ce fournisseur sont :

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

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

  • Dialogflow CX n'utilise pas de contextes pour transmettre des données aux intentionsClosed La signification ou le but derrière ce qu’un contact dit/tape ; ce que le contact veut communiquer ou accomplir. de Dialogflow comme le fait Dialogflow ES.
  • Vous pouvez transmettre des données personnalisées à Dialogflow CX à l'aide de paires clé-valeur JSON. Dans une Snippet action de 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 pouvez trouver cette variable dans l'objet customPayload.
  • Transmettez le customPayload JSON à l'agent virtuel à l'aide de la propriété Payload de QueryParameters. Consultez la documentation de 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 console Dialogflow CX pour traiter les données transmises.
  • N'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 de votre agent virtuel Dialogflow CX au script, utilisez le champ Charge utile personnalisée dans la console Dialogflow CX. Assurez-vous d'être dans la console de l'agent virtuel que vous utilisez avec NiCE CXone. Associez ceci à 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 utiliser ceci pour définir les comportements de la prochaine invite.
  • Pour transmettre des données personnalisées à Dialogflow CX à partir du script, utilisez session_params dans l'objet customPayload dans 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 CX Dialogflow à 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 utilisés uniquement avec les agents virtuels Dialogflow CX. Pour obtenir un résultat similaire avec Dialogflow ES, utilisez des contextes.

  • Configurez les indices de contexte de la Parole et un ID de conversation personnalisé pour transférer la conversation à un agent virtuel Dialogflow CX différent dans l'extrait Charge utile personnalisée .

  • Pour configurer la durée pendant laquelle l'agent virtuel attend lorsque le contact fait une pause en parlant, ajoutez the maxPostEnergySilenceMSparamètre à l'action Next Prompt Behaviors ou Default Next Prompt BehaviorsSnippet.

Ajouter une application à Virtual Agent Hub

autorisations requises : Connections Hub > Launch Connections Hub

L’ajout d’une application de configuration à Virtual Agent Hub établit la connexion entre NiCE CXone et votre fournisseur d’agent virtuel.

  1. Dans NiCE CXone, cliquez sur le sélecteur d'applications et sélectionnez Autre > Connection Hub et cliquez ensuite sur Virtual Agent Hub. Vous pouvez également faire un double-clic sur l'Action agent virtuel dans votre script Studio pour lancer Virtual Agent Hub.
  2. Cliquez sur Ajouter un robot.
  3. Entrez un Nom de l’Agent virtuel (bot) et cliquez sur Dialogflow CX dans la liste des fournisseurs d’agents virtuels.

  4. Cliquez sur Suivant.

  5. Remplissez les champs du formulaire de configuration et cliquez sur Suivant. Vous pouvez trouver des détails sur ce formulaire dans la section Détails de la page de configuration de cette page.

  6. Cliquez sur Suivant.

  7. Si vous configurez un agent virtuel texte, sélectionnez Texte seulement (aucune prise en charge de la Voix) sur la page Voix. Si vous configurez un agent virtuel voix, consultez la section Configurer les options d’Intégration vocale de cette page.

  8. Sur la page Transcript, sélectionnez l'option indiquant si vous souhaitez que la transcription de la Conversation et les informations sur l'intention soient capturées. Si cet onglet n'est pas disponible, la fonctionnalité n'est pas activée pour votre locataireClosed Regroupement organisationnel de haut niveau utilisé pour gérer le soutien technique, la facturation et les paramètres globaux de votre système NiCE CXone.. Communiquez avec votre représentant de compte pour 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 Suivant.

  10. Sur la page Test + Add, vous pouvez tester la connexion de votre bot en envoyant des invites vocales ou textuelles. Si vos messages Test ne fonctionnent pas, cliquez sur Retour pour retourner à 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 du tableau suivant lorsque vous remplissez la Page Configuration. Vous voyez cette page lorsque vous ajoutez une application dans Virtual Agent Hub

Champ

Détails

Version d'intégration

Sélectionnez la version de Virtual Agent Hub que vous voulez utiliser. Cette option vous permet d'utiliser une version précédente de Virtual Agent Hub jusqu'à ce que vous soyez prêt à basculer vers une version nouvellement publiée. Les versions disponibles sont :

  • Version 1.0.0 : Ceci est la première version de Virtual Agent Hub. L'objet charge utile personnalisée est retourné comme customPayload.payload.xxxx.
  • Version 2.0.0 : Cette version a mis à jour les schémas utilisés avec Google Dialogflow CX. Cela a une incidence sur la structure de l'objet customPayload.
  • Version 3.0.0 : Cette version a introduit StandardBot, qui normalise la façon dont NiCE CXone communique avec les fournisseurs d'agent virtuel. L'objet customPayload est retourné comme un tableau, comme customPayloadscriptPayloads[n].xxxx. Cette version est disponible pour tous les fournisseurs.

SIP configuré 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é à partir de votre Console Google Cloud. Copiez et collez tout le contenu du fichier 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 avoir le rôle Admin de l'API 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. Il s'agit de la langue que l'agent virtuel comprend. Ce champ est requis. Sélectionnez None (Aucun) pour supprimer le code de langue dans les demandes API. Utilisez cette option lorsque l'agent virtuel gère lui-même la détection de la langue ou qu'il ne nécessite pas de code de langue.

Région

La région où se trouve l'agent virtuel Google Dialogflow CX que vous ajoutez à Virtual Agent Hub. Ce champ est requis.

Agent

Le nom de l'agent virtuel Google Dialogflow CX que vous voulez ajouter à Virtual Agent Hub. Vous pouvez trouver le nom dans la console CX Dialogflow de l'agent virtuel et cliquez sur Copy Name pour le copier dans le presse-papiers. Il s'agit d'un champ requis.

Environnement

Entrez le GUID de l'environnement que vous souhaitez que cette application Dialogflow utilise. Dans Dialogflow CX, les différentes versions d'un même agent virtuel sont appelées environnements. Vous pouvez trouver le GUID de vos environnements dans la console Google Dialogflow CX, dans les paramètres de l'agent.

Effectuer la Sortie TTS

Cliquez sur le curseur pour le mettre sur Activé si vous voulez utiliser le service de synthèse vocale (TTSClosed Permet aux utilisateurs d’entrer des invites enregistrées sous forme de texte et d’utiliser une voix générée par ordinateur pour prononcer le contenu.) de Google Dialogflow CX. Configurez les options TTS pour Google.

Si vous ne voulez pas utiliser le service TTS de 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 textuel, laissez cette option désactivée.

Gestionnaire d'Événement de délai d'attente Nom de l'événement Google Dialogflow CX que vous souhaitez déclencher à l'expiration du délai.
Modèle de rupture DTMF Si les caractères spécifiés sont enfoncés, le script passe directement à la OnDTMFBreakout branche.
Effectuer une analyse des sentiments

Cliquez sur le curseur pour le régler à Activé si vous souhaitez recevoir les résultats de l'analyse de Sentiment provenant 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 de Sentiment avec votre agent virtuel.

Dépassement de délai de fournisseur externe

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

Profil de Conversation

Entrée de l'ID du profil de conversation CX Dialogflow que vous voulez 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 vidé. En effet, les profils de conversation sont propres à l'agent et à l'environnement.

Configurer la Sortie TTS de Google Dialogflow CX

autorisations requises : Connections Hub > Launch Connections Hub

Suivez les étapes de cette section si vous voulez utiliser le service TTS Google. Les champs de l'image suivante s'affichent lorsque vous activez l'option Effectuer la Sortie TTS sur la page de configuration CX Dialogflow 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 de cette page.
  2. Activez exécuter la Sortie TTS.
  3. Pour utiliser un modèle vocal personnalisé, activez Utiliser une voix personnalisée et saisissez le nom du modèle AutoML que vous souhaitez utiliser dans le champ modèle de Voix personnalisée.

  4. Si vous souhaitez utiliser un modèle vocal Google, sélectionnez le Nom de la voix tts dans la liste déroulante.

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

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

  7. Saisissez les paramètres Débit de parole, Hauteur de la voix et Gain de volume pour configurer la façon dont vous voulez que la voix tts sonne.

  8. Retournez à la section Ajouter une application à Virtual Agent Hub de cette page pour terminer l'ajout de l'application de configuration.

Configurer les Options d’Intégration vocale

autorisations requises : Connections Hub > Launch Connections Hub

Si vous configurez un agent virtuel textuel, vous pouvez sauter 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 Configuration.

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

  5. Si vous choisissez d’utiliser un profil Turn-by-Turn Transcription, cliquez sur Profil Turn-by-Turn Transcription pour sélectionner celui que vous souhaitez 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 de transcription ou cliquez sur Ajouter un nouveau Profil de transcription Turn by Turn pour créer un nouveau profil.
  7. Cliquez sur Suivant.
  8. Retournez à la section Ajouter une application à Virtual Agent Hub sur cette page pour terminer l’ajout de l’application de configuration.

Assigner l’application Google Dialogflow CX à une action

autorisations requises : Studio Script View, Create/Edit

Lorsque l’application agent virtuelClosed La signification ou le but derrière ce qu’un contact dit/tape ; ce que le contact veut communiquer ou accomplir. est configurée dans Virtual Agent Hub, vous devez l’assigner à l’action d’agent virtuel dans votre script. Cela relie 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 encore fait, cliquez sur l’onglet Outils, développez la catégorie Automatisation et AI, puis ajoutez l’action d’agent virtuel que vous souhaitez utiliser. Assurez-vous de la placer au bon endroit dans votre script. Si vous ne voyez pas l’action attendue, vérifiez que votre type de support de script est correct. Par exemple, si vous créez un script pour un agent virtuel vocal, le script doit être un script téléphonique.

  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 Une icône représentant un cercle avec une coche à l’intérieur. à côté de celui-ci.

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

  5. Cliquez sur Fermer.

Modifier le Profil Transcription

autorisations requises : Connections Hub > Launch Connections Hub

Un profil de transcription vous permet d'utiliser un service de transcription différent de celui offert par le fournisseur de l'agent virtuel. Chaque agent virtuel peut avoir un profil de transcription. Vous devez uniquement suivre les étapes de cette section si vous travaillez avec un agent virtuel voix et devez changer le profil de transcription.

  1. Dans NiCE CXone, cliquez sur le sélecteur d'applications et sélectionnez Autre > Connection Hub et cliquez ensuite sur Virtual Agent Hub. Vous pouvez également faire un double-clic 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 sur le côté gauche de la page Virtual Agent Hub, cliquez sur celle que vous voulez modifier.
  3. Au centre de la page des propriétés de l'application de l'agent virtuel, cliquez sur l'onglet Voix.
  4. Sous Transcription Options, sélectionnez Utiliser le Profil Turn-by-Turn Transcription si elle n'est pas déjà sélectionnée.

  5. Sélectionnez le Turn by Turn Transcription Profil que vous voulez que cette intégration de l'agent virtuel utilise. Si l'option que vous voulez utiliser n'est pas là, 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 de l'agent virtuel.

Testez votre Agent virtuel

autorisations requises : Connections Hub > Launch Connections Hub

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

  • Vérifier que l’application d’agent virtuel est correctement configurée pour communiquer avec le fournisseur d’agent virtuel.
  • Ajouter des données JSON personnalisées pour tester la gestion des données personnalisées par l’agent virtuel.
  • Déclencher un événement de bienvenue pour tester la façon dont l’agent virtuel entame une conversation.
  • Déclencher un événement d’intention personnalisé pour tester les événements personnalisés que vous avez créés pour votre agent virtuel.
  • Déclenchez un événement de délai d’attente pour tester la réponse de l’agent virtuel lorsque le contact expire.
  • Tester la façon dont l’agent virtuel gère l’entrée DTMFClosed Tonalités de signalisation générées lorsqu’un contact appuie sur une touche du clavier téléphonique..

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 montre les onglets Configuration et Voix ainsi que le volet Test.

  1. Dans NiCE CXone, cliquez sur le sélecteur d'applications et sélectionnez Autre > Connection Hub et cliquez ensuite sur Virtual Agent Hub. Vous pouvez également faire un double-clic sur l'Action agent virtuel dans votre script Studio pour lancer Virtual Agent Hub.
  2. Cliquez pour sélectionner l’application de configuration de l’agent virtuel que vous souhaitez tester dans la liste de gauche.
  3. Dans le volet Test, saisissez un message d’essai dans le champ Type a message et appuyez sur entrée pour l’envoyer. Vous pouvez aussi cliquer sur MicrophoneUne Icône en forme de microphone. et parler dans le microphone de votre ordinateur.

  4. Cliquez sur Démarrer avec l’intention de bienvenue pour démarrer une conversation test depuis le début. L’agent virtuel répond avec son message de bienvenue par défaut. Vous pouvez saisir des messages test.
  5. Cliquez sur Plus d’optionsUne Icône avec trois points empilés verticalement. pour tester d’autres aspects de votre agent virtuel.

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

    • Modifier les scripts Studio pour l’agent virtuel.
    • Modifier les paramètres de configuration dans l'application d'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 montre 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 vos paramètres de configuration.
  9. Une fois les tests terminés, cliquez sur Fermer.