Exemple d'intégration d'agents virtuels personnalisés

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 d'agent virtuel personnalisée de type texte utilisant le chat ACD CXone.

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 CXone.

Exigences

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

  • installer Studio sur votre ordinateur.
  • Fichier ZIP d'échantillon de code téléchargé. L’exemple de code est disponible dans les langages suivants :
    • C# .NET
    • Java
    • Node.js
    • PHP
    • Python
  • prévoir les dépendances IDE et compilateur pour le langage de l’exemple de code que vous utilisez :
    • C# .NET : VS Code ou autre éditeur de code.
    • Java : VS Code Community, Jet Brains, Net Beans, Intelli J, Eclipse, ou autre. Si vous utilisez l’éditeur VS Code, vous devez télécharger et installer le pack d’extension Java sur le site Visual Studio Marketplace.
    • Node.js : NPM.
    • PHP : VS Code ou autre éditeur de code.
    • Python : VS Code ou autre éditeur de code.
  • installer Ngrok sur votre ordinateur. Vous trouverez le programme d’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 proxy

Exécutez cet appel d’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 le menu déroulant pour afficher les instructions de configuration du point de terminaison dans chaque langage disponible.

Exposition du point de terminaison de tunnel de proxy

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

  1. Si ce n’est déjà fait, installez Ngrok.
  2. Lancez Ngrok à l’aide de cette commande dans l’invite de commande :

    ngrok http [port number]

    [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 depuis 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 CXone

Vous devez créer une compétenceFermé Utilisé pour automatiser la livraison des interactions en fonction des compétences, des capacités et des connaissances des agents de chat et un point de contactFermé Le point d'entrée qu'un contact entrant utilise pour initier une interaction, tel qu'un numéro de téléphone ou une adresse e-mail.. Le point de contact appelle le script que vous avez importé. C’est ainsi que CXone achemine les contacts vers votre agent virtuel.

  1. Dans CXone, cliquez sur le sélecteur d'application et sélectionnezACD.
  2. Cliquez sur Paramètres des contacts > Compétences ACD, puis créez une compétence de chat. Vous devez attribuer un Nom à la compétence et l’attribuer à une Campagne. Il est recommandé de créer une campagne à utiliser pour l’exemple d’intégration. Vous pouvez accepter les valeurs par défaut pour toutes les autres options de compétence.
  3. Accédez à Paramètres des contacts > Points de 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.

Configuration de l’action Textbot Exchange

Cette étape configure 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 Centre d'agents virtuels.

  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 Suivant.
  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 Suivant.
  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 aboutit à des erreurs, examinez les tâches précédentes afin de vérifier la configuration et l’exposition du point de terminaison du tunnel de proxy, ainsi que la configuration dans Centre d'agents virtuels.

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

Dès lors que vous avez résolu les éventuelles erreurs survenues lors du test de la configuration de l’action Textbot Exchange, vous pouvez tester le script par le biais de l’URL de point de contactFermé Le point d'entrée qu'un contact entrant utilise pour initier une interaction, tel qu'un numéro de téléphone ou une adresse e-mail. que vous avez copiée lors d’une tâche antérieure.

  1. Dans Studio, ouvrez l’exemple de script que vous avez importé.
  2. Cliquez sur Débogage > Capturer le scriptInstance suivante uniquement.
  3. Dans l’onglet de navigateur où vous avez collé l’URL du point de contact, saisissez un message dans le champ Saisissez votre texte, puis cliquez sur Envoyer.
  4. La fenêtre Trace Output s'ouvre dans Studio. 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 donne également la valeur de chaque variable à ce stade du script.
    • L'onglet Propriétés 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 apportez des modifications si nécessaire.
  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. La page d'aide en ligne de chaque action décrit les propriétés et autres informations se rapportant à l'utilisation de l'action dans un script.
  7. Si vous voulez reprendre le test 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.