Intégrer Google Dialogflow CX

Avant d’effectuer les tâches indiquées sur cette page, veillez à ce que les conditions préalables à l’intégration soient remplies.

Créer un script

Autorisations requises : Studio Script Voir, Créer/Modifier

Vous avez besoin d’au moins un script Studio pour acheminer les interactions à votre agent virtuel. Appliquez les directives et normes du script. Votre script doit posséder le type de médiaFermé Un moyen, tel que la voix, le courrier électronique et le chat, par lequel un contact se connecte avec un destinataire prévu. téléphone pour un agent virtuel vocal ou le type de média numérique pour un agent virtuel texte. Les actions d’agent virtuel prises en charge pour ce fournisseur sont :

Si vous utilisez une connexion SIPFermé Protocole utilisé pour signaler et contrôler les sessions de communication multimédia telles que les appels vocaux et vidéo. backchannel avec votre agent virtuel, contactez votre Représentant de compte CXone.

Vous trouverez plus d’informations sur les scripts de Studio dans les sections Principes de base et Guide de référence technique de l’aide en ligne.

Lorsque votre agent virtuel est prêt pour la mise en production, affectez le script à un ou plusieurs points de contact.

Meilleures pratiques de charge utile personnalisée

Suivez ces bonnes pratiques lors de l’intégration des données de la charge utile personnalisée de Google Dialogflow CX dans CXone :

  • Dialogflow CX n'utilise pas de contextes pour transmettre des données aux DialogflowintentionsFermé La signification ou le but derrière ce qu'un contact dit/tape ; ce que le contact veut communiquer ou accomplir commeDialogflowES.
  • Vous pouvez transmettre des données personnalisées à Dialogflow CX utilisant des paires clé-valeur JSON. Dans une action Snippet 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 ou Conversation de votre script, configurez la propriété customPayload avec la variable incluant la fonction asJSON()comme valeur. Vous trouverez cette variable dans l’objet customPayload.
  • Transférez le code JSON customPayload à l’agent virtuel en utilisant la propriété Payload de QueryParameters. Reportez-vous à la documentation Google concernant QueryParameters Un carré avec une flèche pointant du centre vers le coin supérieur droit. pour Google Dialogflow CX.
  • Les données transférées via 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.
  • N’imbriquez pas d’objet dans l’objet customPayload. Les objets imbriqués sont envoyés sous forme de chaînes littérales.
  • Pour renvoyer des données personnalisées de votre agent virtuel Dialogflow CX dans votre script, utilisez le champ Charge utile personnalisée de la console Dialogflow CX. Vérifiez que vous vous trouvez dans la console de l’agent virtuel que vous utilisez avec CXone. Mappez ceci à votre script en utilisant la variable customPayloadVarName (out) dans l'action voix ou chat Studio de votre script. Par exemple, vous pouvez l'utiliser pour définir les comportements de l'invite suivante.
  • Les paramètres définis en utilisant customPayload peuvent uniquement être utilisés dans le webhook externe. Si vous souhaitez définir des paramètres à utiliser en dehors du webhook externe, faites-le dans une action Snippet avec le champ session_params. Par exemple :

    {
    	"session_params":
    	{ 
    		"name": "Winnie Le Pooh"
    		"job": "Food critic"
    		"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.

  • Les conseils de contexte vocal peuvent être transmis avec la charge utile dans le paramètre speechContexts. La valeur de speechContexts.phrases doit être un jeton de classe Google Un carré avec une flèche pointant du centre vers le coin supérieur droit. correspondant au conseil à donner. Le jeton doit correspondre à la langue et aux paramètres régionaux de vos contacts. Par exemple :

    DYNAMIC customPayload
    customPayload.speechContexts.phrases="$OOV_CLASS_ALPHANUMERIC_SEQUENCE"
    customPayload.speechContexts.boost=10		
  • Lorsque vous utilisez VOICEBOT EXCHANGE : pour configurer la durée d’attente de l’agent virtuel lorsque le contact fait une pause dans son énoncé, ajoutez le paramètre maxPostEnergySilenceMS à l’action Next Prompt Behaviors ou Default Next Prompt Behaviors Snippet.

Ajouter une application à Virtual Agent Hub

Autorisations requises : Automatisation & IA > Lancer Automatisation & IA

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

Si vous utilisez une connexion SIPFermé Protocole utilisé pour signaler et contrôler les sessions de communication multimédia telles que les appels vocaux et vidéo. backchannel avec votre agent virtuel, appliquez les étapes de configuration de ce type de connexion.

  1. Dans CXone, cliquez sur le sélecteur d'application et sélectionnezAutre > Automatisation & IA, puis cliquez sur Virtual Agent Hub. Vous pouvez également double-cliquer sur l’action d’agent virtuel dans votre script Studio pour lancer Virtual Agent Hub.
  2. Cliquez sur Ajouter un robot.
  3. Entrez un Nom d’agent virtuel (robot) et cliquez sur Google Dialogflow CX dans la liste de fournisseurs d’agents virtuels.

  4. Cliquez sur Suivant.

  5. Remplissez les champs du formulaire de configuration et cliquez sur Prochain. Vous trouverez des détails sur ce formulaire à la section Détails de la page de configuration sur cette page.

  6. Cliquez sur Suivant.

  7. Si vous configurez un agent virtuel de type texte, sélectionnez Texte seulement (pas de prise en charge de la voix) sur la page Voix. Si vous configurez un agent virtuel vocal, consultez la section Configuration des options d’intégration vocale de cette page.

  8. Cliquez sur Prochain.

  9. Sur la page Transcription, sélectionnez l’option permettant de capturer la transcription de la conversation et les informations relatives à l’intention. Cette option n'est disponible que pour les agents virtuels de type texte et les agents virtuels vocaux basés sur les énoncés. Elle n’est pas prise en charge pour les intégrations vocales qui utilisent une connexion SIPFermé Protocole utilisé pour signaler et contrôler les sessions de communication multimédia telles que les appels vocaux et vidéo. backchannel.

  10. Cliquez sur Suivant.

  11. 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 Retourpour revenir à la page de configuration et vérifier les paramètres. Il est parfois nécessaire de vérifier vos configurations dans votre console de gestion de fournisseur d'agent virtuel.

  12. Cliquez surAjouter.

Détails de la page de configuration Google Dialogflow CX

Utilisez les informations présentées dans le tableau suivant lorsque vous remplissez la page Configuration. Vous voyez cette page lorsque vous ajoutez une application dans Virtual Agent Hub.

Si vous configurez Dialogflow CX pour utiliser une connexion SIPFermé Protocole utilisé pour signaler et contrôler les sessions de communication multimédia telles que les appels vocaux et vidéo. backchannel, suivez les étapes de configuration de la connexion et non pas les étapes de cette section.

champs

Détails

Version d'intégration

Sélectionnez la 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.
  • 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.
  • Version 3.0.0 : cette version a introduit StandardBot, qui standardise la façon dont CXone communique avec les fournisseurs d'agents virtuels. L’objet customPayload est renvoyé sous forme de tableau, comme customPayloadscriptPayloads[n].xxxx. Cette version est disponible pour tous les fournisseurs.
Configuration SIP Cliquez si vous souhaitez utiliser la connexion SIP backchannel avec cet agent virtuel. La définition d’une connexion SIP backchannel est un processus distinct.
Compte de service JSON

Le fichier de clé de compte de service que vous avez créé et téléchargé depuis votre Google Cloud Console. Copiez et collez l’intégralité du contenu du fichier de clé dans ce champ en veillant à inclure les accolades. Ce champ n'est visible que si vous utilisez le vôtre Google Dialogflow CX Compte.

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 d’administration de l’API DialogflowUn carré avec une flèche pointant du centre vers le coin supérieur droit..

Langue

La langue que vous souhaitez que cet agent virtuel utilise. C'est le langage que comprend l'agent virtuel. Ce champ est obligatoire.

Région La région où le Google Dialogflow CX agent virtuel auquel vous ajoutezVirtual Agent Hub est situé. Ce champ est obligatoire.
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 obligatoire.
Environnement Saisissez le GUID de l’environnement que cette application Dialogflow doit utiliser. 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 d’agent.
Effectuer la sortie TTS

Cliquez sur le curseur pour sélectionner Activé si vous souhaitez utiliser le service Google Dialogflow CX de synthèse vocale (TTSFermé Permet aux utilisateurs de saisir des invites enregistrées sous forme de texte et d'utiliser une voix générée par ordinateur pour lire le contenu.). Configurez les paramètres de sortie de la synthèse vocale.

Si vous ne souhaitez pas utiliser le service de synthèse vocale Google, vous pouvez utiliser CXone Cloud TTS Hub. Vous pouvez configurer cette option sur la page Voix de l’assistant de configuration.

Gestionnaire d’événement de dépassement de délai Nom du Google Dialogflow CX événement que vous souhaitez déclencher à l'expiration du délai.
Modèle de sortie DTMF Si les caractères spécifiés sont enfoncés, le script passe directement à la branche OnDTMFBreakout .
Dépassement de délai pour les fournisseurs externes

Entrez le nombre de secondes pendant lesquelles le script doit attendre 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.

Configuration de la sortie de synthèse vocale Google Dialogflow CX

Autorisations requises : Automatisation & IA > Lancer Automatisation & IA

Complétez les étapes de cette section si vous souhaitez 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 Configuration de Dialogflow CX dans Virtual Agent Hub.

  1. Dans Virtual Agent Hub, ajoutez une nouvelle application de configuration et configurez-la en suivant les étapes de la section Ajout d’une application à Virtual Agent Hub de cette page.
  2. Activez Activer synthèse vocale.
  3. Pour utiliser un modèle vocal personnalisé, cliquez sur Utiliser voix personnalisée pour sélectionner Activer, puis saisissez le nom du modèle AutoML à 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 de machine learning et sa variante que les services de synthèse vocale de Google doivent utiliser.

  6. Pour ajouter un silence au début de la réponse audio de l’agent virtuel, saisissez la durée de silence en millisecondes à ajouter dans le champ Ajouter silence initial. La durée de silence recommandé est de 500 millisecondes.

  7. Saisissez la Vitesse d’élocution, le Ton et le Gain du volume pour configurer le rendu de la synthèse vocale.

  8. Revenez à la section Ajout d’une application à Virtual Agent Hub sur cette page pour terminer l’ajout de l’application de configuration.

Configuration des options d'intégration vocale

Autorisations requises : Automatisation & IA > Lancer Automatisation & IA

Si vous définissez un agent texte virtuel, vous pouvez ignorer cette section. Si vous utilisez une connexion SIP backchannel avec votre agent vocal virtuel, appliquez les étapes de configuration de la page d’aide consacrée à la configuration de SIP backchannel.

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

  3. Sur la page Voix dans la section Options d’intégration vocale, sélectionnez Contrôle tour par tour (CXone Voice Bot Gateway).
  4. Dans la section Options de synthèse vocale, sélectionnez Utiliser la synthèse vocale Cloud de CXone si vous souhaitez utiliser l’option de synthèse vocale de CXone. Pour utiliser plutôt le service de synthèse vocale du fournisseur d’agent virtuel, désactivez cette case à cocher et configurez la sortie en synthèse vocale sur la page Configuration de l’assistant.

    Si le formulaire ne vous permet pas de sélectionner Utiliser la synthèse vocale Cloud de CXone, cliquez sur Retour pour revenir à la page Configuration. Cliquez sur le curseur de Effectuer la sortie TTS pour le placer sur Désactivé. Vous pouvez désormais activer Cloud TTS Hub sur la page Voix.

  5. Sélectionnez un Fournisseur de synthèse vocale, si vous utilisez Cloud TTS Hub. Si vous utilisez le service de synthèse vocale de votre fournisseur d'agents virtuels, ce champ n’est pas visible et vous pouvez ignorer cette étape.
  6. Dans la section Options de transcription, sélectionnez l’option du service de transcription à utiliser.

  7. Si vous choisissez d’utiliser un profil de transcription CXone, cliquez sur Profil de transcription pour sélectionner celui qu’il vous faut. Cliquez sur Ajouter un nouveau profil de transcription tour par tour pour créer un profil.
  8. Cliquez sur Suivant.
  9. Revenez à la section Ajout d’une application à Virtual Agent Hub sur cette page pour terminer l’ajout de l’application de configuration.

Assignation de l’application Google Dialogflow CX à une action

Autorisations requises : Studio Script Voir, Créer/Modifier

Quand l’application d’agent virtuelFermé 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’affecter aux actions d’agents virtuels 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 ce n’est déjà fait, cliquez sur l’onglet Instrument, développez la catégorie Automatisation et IA, et ajoutez l’action de l’agent virtuel que vous souhaitez utiliser. Veillez à la placer au bon endroit au sein de votre script. Si vous ne voyez pas l’action attendue, vérifiez que le type de support du script est correct. Par exemple, si vous créez un script pour un agent virtuel vocal, votre script doit être un script de type téléphone.

  3. Double-cliquez sur l’action pour ouvrir Virtual Agent Hub.

  4. Dans la colonne de gauche, localisez l’agent virtuel que vous souhaitez affecter à l’action et cliquez sur la coche Icône de cercle avec une marque à l’intérieur. correspondante.
  5. Cliquez sur Fermer.

Modifier le profil de transcription

Autorisations requises : Automatisation & IA > Lancer Automatisation & IA

Un profil de transcription vous permet d'utiliser un service de transcription différent de celui proposé par le fournisseur d’agents virtuels. Chaque agent virtuel peut avoir un profil de transcription. Les étapes de cette section ne vous concernent que si vous utilisez un agent virtuel vocal et devez modifier le profil de transcription.

  1. Dans CXone, cliquez sur le sélecteur d'application et sélectionnezAutre > Automatisation & IA, puis cliquez sur Virtual Agent Hub. Vous pouvez également double-cliquer sur l’action d’agent virtuel dans votre script Studio pour lancer Virtual Agent Hub.
  2. Dans la liste déroulante des applications de configuration des agents virtuels 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 d’agents virtuels, cliquez sur l'onglet Voix.
  4. Dans la section Options de transcription, sélectionnez Utiliser le profil de transcription CXone s’il ne l’est pas déjà.

  5. Sélectionnez le Profil de transcription tour par tour que vous voulez que cette intégration d’agents virtuels utilise. Si l'option que vous souhaitez utiliser n'existe pas, 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 de propriétés de votre application d'agent virtuel.

Test de votre agent virtuel

Autorisations requises : Automatisation & IA > Lancer Automatisation & IA

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 de propriétés de l'application de l'agent virtuel dans Virtual Agent Hub. Lors du test, vous pouvez :

  • vérifier 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 DTMFFermé Tonalités de signalisation générées lorsqu'un utilisateur appuie ou appuie sur une touche de son clavier téléphonique..

L'image suivante donne un exemple de page de propriétés d'une application d'agent virtuel dans Virtual Agent Hub. Elle illustre les onglets Configuration et Voix, ainsi que le volet Test.

  1. Dans CXone, cliquez sur le sélecteur d'application et sélectionnezAutre > Automatisation & IA, puis cliquez sur Virtual Agent Hub. Vous pouvez également double-cliquer sur l’action d’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 Saisissez un message, puis appuyez sur la touche Entrée pour l’envoyer. Vous pouvez aussi cliquer sur Microphone Icône en forme de microphone. pour utiliser le micro 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’options Icô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 changements en fonction des résultats du test, vous pouvez :

    • modifier les scripts Studio de l'agent virtuel ;
    • modifier les paramètres de configuration dans l'application de l’agent virtuel dans Virtual Agent Hub ;
    • modifier les paramètres de configuration de l'agent virtuel dans la console du fournisseur. Cliquez sur le grand bouton carré de la page des propriétés d’application dans Virtual Agent Hub. L’exemple au début de cette section montre l’application Google Dialogflow CX avec le bouton fournisseur. Il comporte l’icône Une icône présentant un carré superposé d’une flèche. La flèche part du centre du carré et pointe vers l’angle supérieur droit. pour indiquer que le lien mène à un site externe.
  8. Testez soigneusement l'agent virtuel après chaque modification des scripts ou des paramètres de configuration.
  9. Une fois le test terminé, cliquez sur Fermer.