Intégrer Google Dialogflow CX

Conditions préalables

Pour utiliser des Google Dialogflow CX agents virtuelsFermé Une application logicielle qui traite les interactions avec les clients à la place d’un agent en chair et en os. avec CXone Mpower, vous avez besoin :

  • Un compte sur la plateforme Google Cloud.

  • Un agent virtuel Google Dialogflow CX configuré et formé pour répondre aux demandes de vos contacts. Pour effectuer l’intégration dans CXone Mpower, vous avez besoin du nom de l’agent virtuel à partir 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 permet au projets Google Cloud d’accéder à des fonctionnalités qui ne sont pas disponibles autrement. La Visibilité Alpha n’est pas nécessaire pour utiliser Dialogflow CX avec CXone Mpower. Cependant, il existe certains cas où vous devrez peut-être activer la visibilité alpha. La visibilité Alpha est requise si vous voulez :

  • Pour que le dernier énoncé 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 se peut que la Visibilité Alpha ne soit pas activée pour votre projet. Si vous avez besoin de ces informations, votre projet Cloud Google doit avoir la visibilité alpha activée.

  • 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 : Afficher, créer et modifier des scripts Studio

Vous avez besoin d'au moins un script Studio pour acheminer les interactions vers votre agent virtuel. Suivez les directives de script directives de script. Votre script doit avoir le type de supportFermé 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 vocal ou le type de support « numérique » pour un agent virtuel textuel. Les actions d’agent virtuel prises en charge pour ce fournisseur sont :

Si vous configurez un agent virtuel vocal et utilisez un service CXone Mpower Cloud TTS Hub, incluez l'CLOUD TTS action dans votre script.

Vous pouvez en savoir plus sur les scripts Studio dans les sections Principes fondamentaux et Guide de référence technique de l’aide en ligne.

Meilleures pratiques de charge utile personnalisée

Suivez ces bonnes pratiques lors de l’intégration des données des charges utiles personnalisées de Google Dialogflow CX dans CXone Mpower :

  • 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 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 trouverez cette variable dans l’objet customPayload.
  • Transmettez JSON customPayload à l’agent virtuel en utilisant la propriété Payload de QueryParameters. Consultez la documentation Google concernant les paramètres QueryParameters Un carré avec une flèche pointant du centre vers le coin supérieur droit. pour Google Dialogflow CX.
  • Les données transmises via QueryParameters sont reçues par un webhook dans Dialogflow CX. Vous pouvez écrire du code dans le 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 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 que vous êtes dans la console de l’agent virtuel que vous utilisez avec CXone Mpower. Associez ceci à votre script en utilisant la variable customPayloadVarName (out) dans l'action VOICEBOT EXCHANGE  ou TEXTBOT EXCHANGE Studio dans votre script. Par exemple, vous pouvez l’utiliser pour définir les comportements de l’invite suivante.
  • Pour passer 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 ne sont utilisés qu’avec les agents virtuels Dialogflow CX. Pour obtenir un résultat similaire avec Dialogflow ES, utilisez des contextes.

  • Configurez les conseils de contexte vocal et un ID de conversation personnalisépour transférer la conversation vers un autre Dialogflowagent virtuel CX dans l'extrait de code Charge utile personnalisée.

  • Lorsque vous utilisez VOICEBOT EXCHANGE : Pour configurer la durée d’attente de l’agent virtuel lorsque le contact fait une pause endant qu’il parle, ajoutez le paramètremaxPostEnergySilenceMS à l’action Next Prompt Behaviors ou Default Next Prompt Behaviors Snippet.

Ajouter une application à Virtual Agent Hub

Autorisations requises : Automatisation et IA > Lancer Automatisation et IA

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

  1. Dans CXone Mpower, cliquez sur le sélecteur d’application et sélectionnezAutre > Automatisation et IA 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 logiciel.
  3. Entrez un nom d'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 trouverez des détails sur ce formulaire dans la section Détails de la page de configuration sur cette page.

  6. Cliquez sur Suivant.

  7. Si vous configurez un agent virtuel textuel, sélectionnez Texte uniquement (voix non prise en charge) sur la page Voix. Si vous configurez un agent virtuel vocal, consultez la section Configurer les options d’intégration vocale sur cette page.

  8. Sur la page Transcription, sélectionnez l’option permettant de saisir la transcription de la conversation et les informations relatives à l’intention. Si cet onglet n'est pas disponible, la fonctionnalité n'est pas activée pour votre locataireFermé Regroupement organisationnel de haut niveau utilisé pour gérer le support technique, la facturation et les paramètres globaux pour votre système CXone Mpower.. Contactez votre Représentant de compte pour plus d'informations sur cette fonctionnalité. Cette option n’est disponible que pour les agents virtuels textuels et les agents virtuels vocaux basés sur les énoncés.

  9. Cliquez sur Suivant.

  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 surRetourpour revenir à la page de configuration et vérifier les paramètres.

  11. Cliquez sur Ajouter.

Détails de la page de configuration Google Dialogflow CX

Utilisez les informations du tableau suivant lorsque vous remplissez la page de configuration. Cette page s’affiche 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 souhaitez utiliser. Cette option vous permet d’utiliser une version antérieure de Virtual Agent Hub jusqu’à ce que vous soyez prêt à passer à une nouvelle version. Les versions disponibles sont les suivantes :

  • Version 1.0.0 : Il s’agit de la première version de Virtual Agent Hub. L’objet de la charge utile personnalisée est renvoyé sous la forme customPayload.payload.xxxx.
  • Version 2.0.0 : Dans cette version, les schémas utilisés avec Google Dialogflow CX ont été mis à jour. Cela a un impact sur la structure de l’objet customPayload.
  • Version 3.0.0 : Cette version introduit StandardBot, qui normalise la façon dont CXone Mpower communique avec les fournisseurs d’agents virtuels. L'objet customPayload est retourné sous forme de tableau, comme customPayloadscriptPayloads[n].xxxx. Cette version est disponible pour tous les fournisseurs.
SIP configuré Ne pas activer cette option. CXone Mpower ne prend pas en charge une configuration de canal arrière 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 Google Cloud Console. Copiez et collez tout le contenu du fichier clé dans ce champ, y compris les accolades entourant la clé. Ce champ n’est visible que si vous utilisez le vôtre Google Dialogflow CX Compte. Si le champ n'est pas visible alors qu'il devrait l'être, demandez à votre CXone Mpower Représentant de compte de vérifier 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 d’administrateur de l’API DialogflowUn carré avec une flèche partant du centre vers le coin supérieur droit..

Langue

La langue que vous voulez que l’agent virtuel utilise. C’est le langue 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 de l’agent virtuel Google Dialogflow CX auquel vous souhaitez ajouter Virtual Agent Hub. Vous pouvez 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 vous souhaitez que cette application Dialogflow utilise. Dans Dialogflow CX, les différentes versions d’un même agent virtuel sont appelées des 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 Activer si vous voulez utiliser le service de synthèse texte-parole (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 prononcer le contenu.) Google Dialogflow CX. 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 CXone MpowerCloud TTS Hub.

S’il s’agit d’un agent virtuel textuel, laissez cette option désactivée.

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

Cliquez sur le curseur sur Activé si vous souhaitez recevoir les résultats de l'analyse des sentiments de Google. Cette option nécessite que cette option soit activée dans votre projet Google Cloud. Vous êtes responsable de la configuration de la manière dont les données d’analyse des sentiments sont utilisées avec votre agent virtuel.

Dépassement de délai de fournisseur externe

Entrez 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 prend la branche d’erreur.

Configurer la sortie TTS Google Dialogflow CX

Autorisations requises : Automatisation et IA > Lancer Automatisation et IA

Suivez les étapes de cette section si vous souhaitez utiliser le service Google TTS. Les champs de l’image suivante apparaissent lorsque vous activez l’option Exécuter sortie TTS sur la page de configuration 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 Ajouter une application à Virtual Agent Hub de cette page.
  2. Activez eExé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 un silence au début de la réponse audio de l’agent virtuel, saisissez le nombre de millisecondes de silence à ajouter dans le champ Ajouter un silence de tête. 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 : Automatisation et IA > Lancer Automatisation et IA

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

  3. Sur la page Voix, sous Options d'intégration vocale, sélectionnez Contrôle tour par tour (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 Turn-by-Turn TranscriptionProfil pour sélectionner celui que vous souhaitez utiliser. Cliquez sur Ajouter un nouveau profil de transcription tour par tour pour créer un nouveau profil.
  6. Sous Options de transcription, sélectionnez un Profil de transcription ou cliquez sur Ajouter un nouveau profil de transcription tour par tour pour créer un nouveau profil.
  7. Cliquez sur Suivant.
  8. Retournez à la section Ajouter une application à Virtual Agent Hub de cette page pour terminer l’ajout de l’application de configuration.

Affecter l’application Google Dialogflow CX à une action

Autorisations requises : Afficher, créer et modifier des scripts Studio

Lorsque l'application agent virtuelFermé La signification ou le but derrière ce qu’un contact dit/tape; ce que le contact veut communiquer ou accomplir. est installée et configurée dans Virtual Agent Hub, vous devez l'affecter à l'action d'agent virtuel dans votre script. Cela permet de relier l’action et le script à votre fournisseur d’agents virtuels.

  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 et ajoutez l’action d’agent virtuel que vous souhaitez utiliser. Assurez-vous de le 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. 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 Une icône représentant un cercle avec une coche à l’intérieur. à côté.

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

  5. Cliquez sur Fermer.

Modifier le profil de transcription

Autorisations requises : Automatisation et IA > Lancer Automatisation et IA

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 seul 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 CXone Mpower, cliquez sur le sélecteur d’application et sélectionnezAutre > Automatisation et IA 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 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 Options de transcription, sélectionnez Utiliser le profil Turn-by-Turn Transcription s'il n'est pas déjà sélectionné.

  5. Sélectionnez le Profil de transcription tour par tour que vous souhaitez utiliser pour l’intégration de l’agent virtuel. Si l’option que vous souhaitez utiliser ne s’y trouve 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 des propriétés de votre application d’agent virtuel.

Testez votre agent virtuel

Autorisations requises : Automatisation et IA > Lancer Automatisation et IA

Vous pouvez tester de nombreux aspects de votre agent virtuel pour vous assurer que tout fonctionne comme prévu. Vous pouvez effectuer des tests à partir de la page des propriétés de l’application de l’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éclencher un événement de dépassement de délai pour tester la réaction de l’agent virtuel en cas de dépassement de délai du contact.
  • Tester la façon dont l’agent virtuel gère l’entrée DTMFFermé 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. Elle affiche les onglets Configuration et Voix, ainsi que le volet Test.

  1. Dans CXone Mpower, cliquez sur le sélecteur d’application et sélectionnezAutre > Automatisation et IA 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 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, entrez un message de test dans le champ Taper un message et appuyez sur Entrer pour l’envoyer. Vous pouvez aussi cliquer sur Microphone Une 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 par son message de bienvenue par défaut. Vous pouvez saisir des messages de test.
  5. Cliquez sur Plus d’options Une 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.
    • Modifier les paramètres de configuration de l’agent virtuel dans la console du fournisseur. Cliquez sur le gros bouton carré de 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. Il a l’icône Une icône qui a un carré avec une flèche superposée dessus. La flèche pointe du centre du carré vers le coin supérieur droit du carré. dessus 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.