Mise en œuvre d’une Intégration personnalisée d’Agent virtuel

Cette page décrit le processus général que vous devez suivre lors de la mise en œuvre d’une intégration d’agent virtuel personnalisée. Chaque environnement et chaque intégration personnalisée diffèrent. Votre situation peut nécessiter des étapes supplémentaires qui ne sont pas décrites ici. Il vous revient de comprendre les exigences de votre intégration et, si des tâches supplémentaires s’imposent, de déterminer où les intégrer dans le processus décrit sur cette page.

Effectuez chacune de ces tâches dans l'ordre indiqué.

Configuration de l’agent virtuel et du serveur d’autorisation

Configurez l’agent virtuel dans l’environnement du fournisseur. Effectuez des tests approfondis pour vous assurer qu'il fonctionne comme vous le souhaitez.

Si votre intégration utilise l’authentification dynamique, configurez le serveur d’autorisation.

Configuration du point de terminaison de tunnel de proxy

Pour terminer cette tâche, vous devez mettre en place le code du tunnel proxy et exécuter les commandes qui initient le code et exposent les points de terminaison. Les étapes et commandes nécessaires diffèrent dans chaque environnement.

Configuration des scripts Studio requis

Autorisations requises : ACD > Studio > Scripts studio > Créer/Modifier, Importer/Exporter, Déboguer, Contournement du verrou ; ACD > Studio > enregistrer les Invites > Activé ; ACD > Studio > Navigateur de fichiers > Modifier, Créer

Assurez-vous que tous les scripts Studio requis se trouvent dans votre environnement de production. Vous devrez peut-être :

  • Exportez les Scripts d'un environnement et importez-les dans un autre. Vous souhaiterez peut-être créer un dossier spécifiquement pour les Scripts liés à votre intégration d'agent virtuel personnalisée.
  • Enregistrer les scripts sous un nouveau nom. If vous utilisez conventions d'affectation de noms pour la gestion des versions, vous devez modifier les noms des scripts afin de les faire passer du développement à la production. Studio ne prend pas en charge la modification des noms de scripts. Pour les renommer, vous devez utiliser l'option Fichier > Enregistrer sous.

Assurez-vous que les actions des agents virtuels sont configurées correctement. Cela signifie que :

  • L'application Custom Exchange Terminal est créée dans Virtual Agent Hub.
  • Chaque Action de l'agent virtuel dans vos Scripts possède l'application Custom Exchange Endpoint qui lui est attribuée.
  • La connexion entre le script et l’agent virtuel fonctionne comme prévu après que vous avez placé le script en production. Effectuez quelques tests depuis l'application Custom Exchange Endpoint dans Virtual Agent Hub pour vérifier la connexion.

Configurer la connexion entre NiCE CXone et votre Agent virtuel

Autorisations requises : ACD > Studio > Scripts studio > Créer/Modifier; Intégrations > Lancer

La connexion entre votre agent virtuel et NiCE CXone correspond à l’action d’agent virtuel dans vos scripts Studio. L'action doit être configurée avec les informations nécessaires afin que les deux systèmes puissent communiquer. Vous procédez ainsi en créant une application de configuration dans Virtual Agent Hub, puis en l'affectant à chaque instance des actions agent virtuel dans votre script.

Vous devez accomplir cette tâche une seule fois, même si vous avez plus que une action agent virtuel dans votre script.

Les actions de l'agent virtuel sont Échange voicebot et Échange textbot.

La Page de configuration de l'application Terminal Custom Exchange diffère selon la VERSION D'intégration que vous utilisez. Suivez les étapes indiquées dans la section ci-dessous correspondant à votre version. Les différences entre les versions sont les suivantes :

  • 1.0.0: Supports a single authorization header. The header is sent with the ExternalIntegrationBotExchangeRequest request.
  • 2.0.0 : Prend en charge plusieurs en-têtes d'autorisation. Les en-têtes sont envoyés avec la demande ExternalIntegrationBotExchangeRequest sous forme de paires clé-valeur.
  • 3.0.0 : Prend en charge plusieurs en-têtes d'autorisation et StandardBot. Les en-têtes sont envoyés avec la demande ExternalIntegrationBotExchangeRequest sous forme de paires clé-valeur.
  • Les versions 1.0.0 et 2.0.0 de l'intégration seront déconseillées dans une version ultérieure. Nous recommandons la Version 3.0.0 pour les intégrations d'agents virtuels personnalisées. Si vous utilisez actuellement la version 1.0.0 ou 2.0.0, prévoyez de procéder à la mise à niveau vers 3.0.0. La version 3.0.0 est quasiment identique à la version 2.0.0. La différence primaire est que 3.0.0 ajoute le soutien pour StandardBot.

Configurer la Version d’intégration 1.0.0

  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. Saisissez un nom d’Agent virtuel (Bot) et sélectionnez Custom Exchange Endpoint comme Fournisseur de bot.
  4. Cliquez sur Prochain.
  5. Sélectionnez Version d’intégration 1.0.0.

  6. Saisissez l’URL de webhook de votre agent virtuel. Il s’agit du point de terminaison auquel le script envoie toutes les demandes.
  7. Si votre intégration d’agent virtuel personnalisée est configurée avec une autorisation, saisissez l’En-tête d’autorisation issu de votre service d’agent virtuel. L'en-tête est envoyé avec la ExternalIntegrationBotExchangeRequest demande.
  8. Pour inclure des paramètres avec chaque requête envoyée au service d'agent virtuel, cliquez sur ajouter des Paramètres de Terminal. Saisissez le nom et la Valeur du paramètre. Répétez cette étape pour ajouter d'autres paramètres.

  9. Pour modifier le Dépassement DE délai par défaut, entrée le nombre de millisecondes pendant lequel le script attend que le service agent virtuel réponde, avant un dépassement DE délai. La valeur par défaut est 10000.

  10. Cliquez sur Suivant sur la page de configuration.
  11. Complétez les pages Voix et transcription dans l’assistant ajouter robot.
  12. Testez votre intégration.
  13. Attribuez l'application de configuration Custom Exchange Endpoints aux actions d'agent virtuel dans votre script.

Configuration des Versions d’intégration 2.0.0 et 3.0.0

  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. Saisissez un nom d’Agent virtuel (Bot) et sélectionnez Custom Exchange Endpoint comme Fournisseur de bot.
  4. Cliquez sur Prochain.
  5. Sélectionnez Version d’intégration 2.0.0 ou 3.0.0.

  6. Saisissez l’URL de webhook de votre agent virtuel. Il s’agit du point de terminaison auquel le script envoie toutes les demandes.
  7. Pour envoyer des en-têtes avec l'URL de webhook, cliquez sur ajouter des En-têtes personnalisés. Cela inclut les en-têtes d'autorisation. Saisissez le nom et la Valeur de l'en-tête. Répétez cette étape pour ajouter d'autres en-têtes.

    Si vous utilisez l'authentification dynamique OAuth, sautez cette étape.

  8. Pour inclure des paramètres avec chaque requête envoyée au service d'agent virtuel, cliquez sur ajouter des Paramètres de Terminal. Saisissez le nom et la Valeur du paramètre. Répétez cette étape pour ajouter d'autres paramètres.

  9. Pour modifier le délai d'attente par défaut, entrez le nombre de millisecondes pendant lesquelles le script attend que le service d'agent virtuel réponde avant un Dépassement DE délai. La valeur par défaut est 10000.

  10. Pour utiliser l'authentification mTLS avec votre intégration d'agent virtuel personnalisée, cliquez sur Add Webhook client Certificates et configurez les détails de votre certificat.
  11. Pour configurer l'authentification dynamique avec votre intégration personnalisée, cliquez sur O Auth Required pour le basculer sur On et configurez les champs requis.
  12. Cliquez sur Suivant sur la page de configuration.
  13. Complétez les pages Voix et transcription dans l’assistant ajouter robot.
  14. Testez votre intégration.
  15. Attribuez l'application de configuration Custom Exchange Endpoints aux actions de l'agent virtuel dans votre script.

Configurer l'authentification mTLS avec des certificats client

Vous pouvez ajouter des certificats clients et des clés à votre application Custom Exchange Endpoints pour utiliser l'authentification mTLS avec votre intégration personnalisée.

Avant de commencer, vous devez disposer d'un certificat et d'une clé privée au format PEM.

  1. Dans Virtual Agent Hub, sélectionnez l'application Custom Exchange Endpoints que vous souhaitez modifier.

  2. Cliquez sur ajouter des certificats client webhook.

  3. Facultatif, saisissez le nom de certificat. Il peut s'agir d'un mot ou d'une phrase identifiant le certificat.

  4. Copiez le texte brut codé depuis le fichier PEM du certificat et collez-le dans le champ Certificat.

  5. Copiez le texte brut codé de la clé privée du fichier PEM et collez-le dans le champ Private Key.

  6. Saisissez le certificat du Mot DE passe.

  7. Si vous devez ajouter d'autres certificats de client, cliquez sur ajouter des certificats de client et répétez les étapes 2 à 5.

  8. Enregistrez vos modifications.

Configurer Authentification Dynamique avec OAuth pour version 2.0.0 ou 3.0.0

Si vous utilisez l'authentification dynamique avec votre intégration personnalisée, vous pouvez utiliser l'application Custom Exchange Endpoint pour gérer vos jetons. Si vous activez cette option, elle remplace la valeur d’en-tête personnalisée récupérée par le serveur d’autorisation.

  1. Dans Virtual Agent Hub, sélectionnez l'application Custom Exchange Endpoints que vous souhaitez modifier.
  2. Cliquez sur O Auth requis pour l’activer.
  3. Entrez l'URL de votre serveur d'autorisation dans le champ OAuth URL.
  4. Sélectionnez JSON ou Form URL Encode sous Type de contenu de la Demande. Il s’agit du type de corps des requêtes OAuth.
  5. Cliquez sur ajouter OAuth Demande et entrez les paires clé-valeur qui composent le corps de la demande d'authentification. Il s’agit d’informations telles que des secrets d’API ou des identifiants de client. Entrez la clé nom et la Valeur. Répétez cette étape pour ajouter d'autres paramètres de demande.
  6. Cliquez sur ajouter OAuth En-têtes et entrez les paires clé-valeur pour tous les en-têtes que votre serveur d'autorisation exige que les demandes incluent. Entrez la clé nom et Valeur. Répétez cette étape pour ajouter d'autres paramètres d'en-tête.
  7. Pour personnaliser les en-têtes d’autorisation envoyés avec les demandes à votre fournisseur d’agent virtuel, cliquez sur Aut. en-tête personnalisé pour l’activer, puis :

    1. Entrée un nouveau Authorization Header Name pour modifier le nom de la clé dans la paire clé-valeur de l'En-tête d’autorisation. La valeur par défaut est autorisation.
    2. Saisissez un nouveau Préfixe de la Valeur DE l’en-tête d'autorisation pour modifier le préfixe envoyé avec la valeur d’en-tête. Par défaut, il s’agit de Bearer.
  8. Pour personnaliser le délai d’expiration du jeton d’autorisation, saisissez une nouvelle valeur dans Durée expiration aut. La valeur par défaut est 0.

  9. Sélectionnez une option dans la liste déroulante Sélectionner un certificat OAuth pour indiquer si vous souhaitez utiliser un certificat avec votre serveur d’autorisation OAuth. Si vous souhaitez utiliser un certificat, vous pouvez Utiliser un certificat client de webhook ou ajouter un nouveau certificat client pour le serveur d’autorisation.

  10. Cliquez sur enregistrer.

Configurer les options Voix et Transcription

La Page Voix permet de configurer l'application Custom Exchange Endpoints pour un agent virtuel voix ou un agent virtuel texte. pour les agents virtuels de texte, il n'y a aucun paramètre supplémentaire à configurer. pour les agents vocaux virtuels, vous pouvez sélectionner :

  • Le type d’intégration vocale que vous réalisez.
  • Le service de transcription (reconnaissance vocale/STT) que vous souhaitez utiliser.

La page Transcript de l'assistant Custom Exchange Endpoints vous permet de sélectionner si vous souhaitez que votre intégration capture les transcriptions des conversations de l'agent virtuel avec les contacts.

  1. Dans Virtual Agent Hub, ajoutez l'application Custom Exchange Endpoint et complétez la page Configuration pour la version 1.0.0 ou la version 2.0.0/3.0.0.
  2. Cliquez sur Suivant sur la page de configuration.
  3. Si vous configurez une intégration d'agent virtuel texte, sélectionnez Texte uniquement sur la page Voix sous Options d'Intégration Voix, puis cliquez sur Suivant. Passez à l’étape 10 de cette section.

  4. Si vous configurez un agent virtuel vocal, sélectionnez l'option correspondant au type d'intégration vocale que vous définissez depuis la liste de la page voix dans la section Options d'Intégration vocale.

  5. Sous Transcription Options, sélectionnez le service de synthèse vocale que vous souhaitez utiliser.

  6. Cliquez sur Prochain.
  7. Sur la Page Transcript, sélectionnez l’Option indiquant si vous souhaitez capturer les transcriptions des conversations de l’agent virtuel.

  8. Cliquez sur Prochain.
  9. Test votre agent virtuel de l'intégration si vous le souhaitez, ou cliquez sur ajouter pour ajouter l'application de configuration Custom Exchange Endpoints à Virtual Agent Hub.

Test de l’Intégration d’Agent virtuel personnalisée

Autorisations requises : ACD > Studio > Studio Scripts > Créer/Modifier; Integrations > Launch

Cette étape permet de tester la connexion entre NiCE CXone et l’agent virtuel. Elle vérifie que l’agent virtuel fonctionne de la manière attendue lorsqu’il communique avec NiCE CXone.

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 d'agent virtuel dans Virtual Agent Hub. Lors des tests, 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 DTMFClosed Signaling tones that are generated when a contact presses a key on the telephone keypad..

L'image suivante est un exemple de page des propriétés pour une application agent virtuel dans Virtual Agent Hub. 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 de 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 et appuyez sur entrée pour l’envoyer.

  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 test les autres aspects de votre agent virtuel.

  6. Cliquez sur Réinitialiser pour recommencer le test.
  7. Si vous devez apporter 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 grand bouton carré 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. Il 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. Une fois les tests terminés, cliquez sur Fermer.

Attribuer l'Agent virtuel à une Action Studio

Autorisations requises : ACD > Studio > Studio Scripts > Créer/Modifier

Lorsque l'application agent virtuelClosed The meaning or purpose behind what a contact says/types; what the contact wants to communicate or accomplish. est 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. Repérez l'VOICEBOTSTREAMaction dans votre script. Si vous ne l'avez pas encore fait, ajoutez-la depuis la palette Actions.
  3. Cliquez sur Ouvrir l’éditeur sur l'action pour ouvrir Virtual Agent Hub.
  4. Repérez l’action agent virtuel dans le script, puis cliquez sur Ouvrir l’éditeur sur l’action pour ouvrir Virtual Agent Hub.

  5. Dans la colonne de gauche, repérez le profil d'agent virtuel que vous souhaitez assigner à l'action et cliquez sur la coche Icône de cercle avec une marque à 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 de l'agent virtuel à la propriété ID de l'Agent virtuel de l'action Virtual Agent Hub que vous utilisez.

  6. Cliquez sur Fermer.

Prise en compte des exigences spécifiques aux CANAUX

Autorisations requises : ACD> Paramètres du contact > Campagnes > Modifier, Créer; ACD> Paramètres du contact > Points de contact > Modifier, Créer; ACD> Paramètres du contact > Compétences > Créer, Modifier, Attribuer à l'utilisateur; ACD> Paramètres du contact > Profils de clavardage > Créer, Modifier; ACD> Digital Engagement > Réglages des canaux

Configurez le canalClosed Various voice and digital communication mediums that facilitate customer interactions in a contact center. que les contacts utiliseront pour initier des interactions avec votre agent virtuel.

Pour les canaux chat NiCE CXone ou voix :

Pour les canaux Digital Experience (DX) :

Si vous utilisez une convention de nommage comme contrôle de version avec vos Studio scripts, veillez à enregistrer votre script sous son nom de production avant de l'affecter au point de contact.

Assurez-vous d’avoir tenu compte de toutes les exigences de votre canal, par exemple :

  • Création d'un profil de chat pour le chat ACD.
  • Configuration de l'option de chat ou de messagerie pour digital channels où les conversations commencent sur d'autres sites Web, tels que Instagram.
  • Ajout du clavardage à votre site Web ou application mobile (NiCE CXone clavardage et clavardage numérique).

Test le Script à partir du Point de contact

Autorisations requises : ACD > Paramètres du contact > Points de contact > afficher, Modifier

Une fois le point de contactClosed The entry point that an inbound contact uses to initiate an interaction, such as a phone number or email address. configuré, vous devez tester votre script à partir du point de contact. Vous pouvez utiliser le traçage de script pour vérifier l’efficacité de votre script et identifier les problèmes qui surviennent.

Les tests que vous avez effectués plus tôt dans le processus d'implémentation ont permis de tester la connexion entre l'agent virtuel et NiCE CXone. Les tests de cette étape permettent de vérifier l'intégration complète, depuis le contact jusqu'à l'agent virtuel en passant par NiCE CXone.

  1. Dans Studio, ouvrez le script que le point de contact appelle.
  2. Cliquez sur Déboguer > Capturer script > Instance suivante Uniquement.
  3. Lancer une interaction. La marche à suivre dépend du canalClosed Various voice and digital communication mediums that facilitate customer interactions in a contact center..Par exemple :

    Dans Studio, la fenêtre de Sortie Trace s'ouvre. Elle affiche le progrès du script au fur et à mesure que vous type réponses et que l'agent virtuel répond.

  4. Cliquez sur une action dans le volet principal de la fenêtre Trace Sortie.

    • L’onglet variables affiche toutes les variables qui existent dans le script une fois achevée l’action sélectionnée. Il présente également la valeur de chaque variable à ce point précis du script.
    • L’onglet Properties affiche les Propriétés de l’action sélectionnée. Vous pouvez l’utiliser pour vérifier la configuration actuelle de l’action.
  5. Revenez au script et effectuez les modifications nécessaires, s’il y a lieu.
  6. Sélectionnez une action et appuyez sur la touche F1 du clavier pour accéder à l’aide en ligne correspondant à l’action. Pour chaque action, la page d’aide en ligne décrit les propriétés de l’action et apporte des informations sur son utilisation dans un script.
  7. Si vous voulez reprendre depuis le début, cliquez sur Quitter la conversation, actualisez la fenêtre du navigateur et recommencez la procédure à partir de l'étape 2.