Exemple Intégration personnalisée d'Agent virtuel

NiCE CXone a mis au point un exemple de tunnel de proxy que vous pouvez utiliser. Vous pouvez configurer cet exemple d’intégration personnalisée afin de mieux comprendre le fonctionnement des intégrations personnalisées. Cet exemple simule une intégration agent virtuel textuel personnalisée utilisant le chat NiCE CXone ACD.

Cet exemple de code diffère du tunnel de proxy utilisé dans une intégration réelle. Dans une intégration réelle, le tunnel de proxy est configuré pour communiquer avec les points de terminaison d’un agent virtuel. L’exemple de code ne communique pas avec un réel agent virtuel. À la place, il est configuré pour renvoyer en écho la saisie de l’utilisateur qui le teste. Ainsi, si vous saisissez Bonjour Chatbot dans la fenêtre de test, la réponse est Bonjour Chatbot.

Pour configurer l’exemple d’intégration, vous devez télécharger et installer l’exemple de code de proxy dans votre environnement. L’exemple de tunnel de proxy est disponible dans différents langages de programmation. Votre équipe peut choisir le langage avec lequel elle est le plus à l’aise.

Le modèle de document de conception technique (TDD) destiné à l’intégration d’agents virtuels personnalisée comprend des exemples basés sur cet exemple d’intégration. Les exemples donnés dans le modèle de TDD peuvent vous aider à mieux appréhender l’intégration personnalisée d’un agent virtuel.

Certains liens sur cette page renvoient vers des sites externes à l’aide en ligne de NiCE CXone.

Exigences

Pour tester l’exemple d’intégration, vous devez au préalable :

  • Studio installé sur votre ordinateur.
  • Downloaded the sample code ZIP file. Sample code is available in the following languages:
    • C# .NET
    • Java
    • Node.js
    • PHP
    • Python
  • IDE and compiler dependencies for the language of the sample code you're using:
    • C# .NET : VS Code ou tout autre éditeur de code.
    • Java : VS Code Community, Jet Brains, Net Beans, Intelli J, Eclipse, ou autres. Si vous utilisez l'éditeur VS Code, vous devez télécharger et installer le Java Extension pack depuis le site Web Visual Studio Marketplace.
    • Node.js : NPM.
    • PHP : VS Code ou autre éditeur de code.
    • Python : VSCode ou autre éditeur de code.
  • installer Ngrok sur votre ordinateur. Vous pouvez trouver l'installation sur ce site : https://ngrok.com/download.

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

Configuration du point de terminaison de tunnel de proxy

Exécutez cet Appel API sur un port localhost. Copiez le numéro du port sur lequel s’exécute le service. Vous aurez besoin de ce numéro dans une étape ultérieure. Cliquez sur la liste déroulante pour afficher les instructions de configuration du terminal pour chaque langue disponible.

Exposer le Terminal du tunnel proxy

Il est nécessaire d’exposer le point de terminaison du tunnel de proxy afin que NiCE CXone puisse y accéder de manière globale. Pour ce faire, utilisez Ngrok.

  1. Installez Ngrok, si cela n'est pas déjà terminé.
  2. Lancez Ngrok à l’aide de cette commande dans l’invite de commande :

    ngrok http [port number]

    où [port number] correspond au numéro de port que vous avez noté lors de la configuration du point de terminaison.

  3. Copiez l’URL de serveur que Ngrok expose ainsi que les points de terminaison d’API nécessaires.

    Dans l’exemple illustré ci-dessous, l’URL exposée est https://4db3-5-46-62-207.nrgok.io. Il s’agit de l’URL de base pour le webhook. Déterminez le point de terminaison à utiliser avec votre URL. Enregistrez l’URL pour l’utiliser lors de la configuration de l’action Studio Textbot dans une tâche ultérieure.

Les étapes décrites dans cette section en vue de déterminer le point de terminaison s’appliquent uniquement à l’exemple d’intégration. Lorsque vous créez votre propre point de terminaison, les informations reflètent les besoins de votre organisation.

Configuration d’un script de chat simple dans Studio

  1. Téléchargez ce script de chat simple.
  2. Extrayez le fichier TextBotExchangeExample.xml sur votre ordinateur.
  3. Dans Studio, cliquez sur Fichier > Importer à partir d'un fichier, sélectionnez le fichier extrait, puis cliquez sur Ouvrir.
  4. Enregistrez le script. Mémorisez le nom donné au script. Laissez le script ouvert. Vous y reviendrez ultérieurement.

Création d'une Compétence de chat et d'un Point de contact dans NiCE CXone

Vous devez créer une compétenceClosed Used to automate delivery of interactions based on agent skills, abilities, and knowledge. de chat et un point de contactClosed The entry point that an inbound contact uses to initiate an interaction, such as a phone number or email address.. Le point de contact appelle le script que vous avez importé. C’est ainsi que NiCE CXone achemine les contacts vers votre agent virtuel.

  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 ACD.
  2. Cliquez sur Paramètres de contact > ACD Compétences et créer une compétence de chat. Vous devez attribuer un nom à la Compétence et l’attribuer à une Campagne. Vous pouvez souhaiter créer une campagne à utiliser pour l'intégration exemple. Vous pouvez accepter les valeurs par défaut pour toutes les autres options de compétence.
  3. Accédez à Contact Settings > Points of Contact et créez un point de contact avec les Paramètres suivants :

    • Type de média : sélectionnez Chat.
    • Script : sélectionnez le nom du script que vous avez importé pour l’exemple d’intégration.
    • Compétence : sélectionnez le nom DE LA compétence que vous avez créée dans cette tâche.
  4. Après avoir créé le point de contact, copiez l’URL du Point de contact affichée sous l’onglet Détails. Collez-la dans un onglet de votre navigateur. Vous utiliserez cette URL par la suite afin de tester le script.

Configurer l'action Échange textbot

Cette étape configure NiCE CXone de manière à communiquer avec le point de terminaison du tunnel de proxy.

  1. Dans Studio, ouvrez l'exemple de script que vous avez importé, s'il n'est pas déjà ouvert.
  2. Double-cliquez sur l'une des actions Textbot Exchange pour ouvrir Virtual Agent Hub.

  3. Cliquez sur Ajouter un robot.
  4. Saisissez un nom d’Agent virtuel (Bot), puis sélectionnez Custom Exchange Endpoint comme Fournisseur de bot.
  5. Cliquez sur Prochain.
  6. Saisissez l’URL de webhook. Il s’agit de l’URL que vous avez enregistrée après avoir exposé le point de terminaison du tunnel de proxy.
  7. Cliquez sur Prochain.
  8. Sur la page Voix, sélectionnez Texte seulement sous Options d’Intégration vocale, puis cliquez sur Suivant.
  9. Sur la page Tester + ajouter, cliquez sur Commencer par l’intention DE bienvenue. Testez d’autres options, comme l’envoi d’une charge utile, si vous le souhaitez. Si aucune erreur ne survient, passez à l’étape suivante. Si votre test entraîne des erreurs, revoyez les tâches précédentes afin de vérifier la mise en place et l'exposition du terminal du tunnel proxy ainsi que la configuration dans Virtual Agent Hub.

Test du script à partir d’une fenêtre de chat

Lorsque vous avez résolu les erreurs survenues lors du test de la configuration de l'action Textbot Exchange, vous pouvez tester le script à l'aide de l'URL du point de contactClosed The entry point that an inbound contact uses to initiate an interaction, such as a phone number or email address. que vous avez copiée lors d'une tâche précédente.

  1. Dans Studio, ouvrez l’exemple de script que vous avez importé.
  2. Cliquez sur Déboguer > Capturer script > Instance suivante Uniquement.
  3. Dans l’onglet de navigateur où vous avez collé l’URL du point de contact, saisissez un message dans le champ Entrée de votre texte et cliquez sur Envoyer.
  4. Dans Studio, la fenêtre Sortie de l'analyse s'ouvre. Elle affiche la progression du script à mesure que vous envoyez des messages et que le script y répond.

    Cliquez sur une Action dans le volet principal de la fenêtre Trace Output .

    • 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. Pour accéder à l’aide en ligne concernant une action, sélectionnez l’action sur le canevas et appuyez sur la touche F1 du clavier. 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 le test depuis le début, cliquez sur End Chat, actualisez la fenêtre du navigateur et recommencez la procédure à partir de l’étape 2.