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 effectuer cette tâche, vous devez mettre en place le code du tunnel proxy, puis exécuter les commandes qui lancent 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 destiné aux Scripts liés à votre intégration d'agent virtuel personnalisée.
  • Enregistrer les scripts sous un nouveau nom. Si vous utilisez conventions d'affectation de noms pour la gestion des version, 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 Endpoint est créée dans Virtual Agent Hub.
  • Chaque action agent virtuel dans vos Scripts dispose de l'application Custom Exchange Endpoint assigné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 des tests depuis l'application Custom Exchange Terminal 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 de l'agent virtuel dans votre script.

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

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

La Page de configuration de l’application Terminal d’échange personnalisé est différente 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éprécierecées dans une prochaine version. Wait, I need to correct a typo. Les versions 1.0.0 et 2.0.0 de l'intégration seront dépréciées dans une prochaine version. 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 la version 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'application 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 demande ExternalIntegrationBotExchangeRequest.
  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, entrez le nombre de millisecondes pendant lesquelles le script attend une réponse du service agent virtuel avant d’expirer. 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 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'application 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, passez 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épassement DE délai par défaut, entrez le nombre de millisecondes pendant lesquelles le script attend que le service agent virtuel réponde avant d'expirer. La valeur par défaut est 10000.

  10. Pour utiliser l'authentification mTLS avec votre intégration d'agent virtuel personnalisée, cliquez sur ajouter des certificats client de webhook 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 la basculer sur Activé 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. Attribuer l'application de configuration Custom Exchange Endpoints aux actions 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 encodé depuis le fichier PEM du certificat et collez-le dans le champ Certificat.

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

  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 l'authentification Dynamique avec OAuth pour la version 2.0.0 ou 3.0.0

Si vous utilisez l'authentification dynamique avec votre intégration personnalisée, vous pouvez disposer de 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 Request Content Type. Il s’agit du type de corps des requêtes OAuth.
  5. Cliquez sur ajouter OAuth Demande, puis 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 Valeur. Répétez cette étape pour ajouter d'autres paramètres de demande.
  6. Cliquez sur ajouter OAuthEn-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 nom de l’En-tête d’autorisation 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 vous permet de configurer l'application Custom Exchange Endpoints afin qu'elle soit utilisée pour un agent virtuel vocal ou un agent virtuel textuel. pour les agents virtuels textuels, aucun paramètre supplémentaire n'est à configurer. pour les agents vocaux virtuels, vous pouvez sélectionner :

  • Le type d’intégration voix que vous réalisez.
  • Le service de transcription (parole-vers-texte/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 textuel, sélectionnez Texte uniquement sur la page Voice sous Voice Integration Options, puis cliquez sur Next. 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 configurez dans la liste de la page voix, sous 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. Testez l'intégration de votre agent virtuel 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 > Lancer

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 agent virtuel dans Virtual Agent Hub. Lors des tests, vous pouvez :

  • Vérifiez que l'application de l'agent virtuel est correctement configurée 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 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 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'application 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, entrez un message test dans le champ Type a 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 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 de la page de 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. 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 minutieusement l'agent virtuel après chaque modification de vos scripts ou de tous les paramètres de configuration.
  9. Lorsque vous avez terminé les tests, cliquez sur Fermer.

Attribuer l'Agent virtuel à une Action Studio

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

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 et paramétré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. Localisez 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 solution de remplacement à 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 dans 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 of Contact > Modifier, Créer; ACD> Paramètres du contact > Skills > Créer, Modifier, Affecter un utilisateur; ACD> Paramètres du contact > Profils de clavardage > Créer, Modifier; ACD> Digital Engagement > Réglages des canaux

Configurez le canalClosed Divers moyens de communication vocale et numérique qui facilitent les interactions avec les clients dans un centre de contacts. que les contacts utiliseront pour initier des interactions avec votre agent virtuel.

Pour les canaux chat NiCE CXone ou voix :

  • Créer une campagne ou choisir une campagne existante à utiliser.
  • Créer une compétence ACD pour voix ou ACD chat. Il est inutile d’ajouter des agents à la compétence ACD.
  • Créer un point de contact. Choisissez la compétence ACD et le script que vous avez créés pour votre intégration d'agent virtuel personnalisée.

Pour les canaux Digital Experience (DX) :

Si vous utilisez une convention de nommage comme contrôle de version avec vos scripts Studio, veillez à enregistrer votre script sous son nom de production avant de l'affecter au point of 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 débutent sur d'autres sites Web, comme Instagram.
  • Ajout du chat à votre site Web ou application mobile (NiCE CXone chat et clavardage numérique).

Test le Script à partir du Point de contact

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

Une fois le point de contactClosed point d’entrée qu’un contact entrant utilise pour amorcer une interaction, comme un numéro de téléphone ou une adresse courriel. 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 vérifié la connexion entre l'agent virtuel et NiCE CXone. Les tests de cette étape vérifient l'intégration complète, du 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 le script > Instance suivante Uniquement.
  3. Lancer une interaction. La marche à suivre dépend du canalClosed Divers moyens de communication vocale et numérique qui facilitent les interactions avec les clients dans un centre de contacts..Par exemple :

    La fenêtre Trace Studio s'ouvre. Elle affiche le progrès du script au fur et à mesure que vous saisissez des 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 souhaitez reprendre depuis le début, cliquez sur terminer la conversation, actualisez la fenêtre du navigateur et recommencez cette procédure à partir de l’étape 2.