Exemplo de Integração de Agente virtual personalizada

A NiCE CXone desenvolveu um exemplo de túnel proxy para você usar. Você pode configurar este exemplo de integração personalizada para obter um melhor entendimento de como as integrações personalizadas funcionam. Este exemplo simula uma integração de agente virtual de texto personalizado usando o chat NiCE CXone ACD.

O código de exemplo neste exemplo é diferente do tunnel de proxy usado em uma integração real. Em uma integração real, o túnel de proxy é configurado para se comunicar com os endpoints de um agente virtual. O código de amostra não se comunica com um agente virtual real. Em vez disso, ele é configurado para ecoar de volta a entrada do usuário que o testa. Assim, se você digitar Olá chatbot na janela de teste, a resposta será Olá chatbot.

Para configurar a integração de exemplo, você deve baixar e instalar o código de proxy de amostra em seu ambiente. O exemplo de túnel proxy está disponível em várias linguagens de programação diferentes. Sua equipe pode usar a linguagem com a qual tem mais familiaridade.

O modelo para o documento de Design técnico (TDD) da integração de agente virtual personalizada inclui exemplos baseados nesta integração de exemplo. Os exemplos no modelo de TDD podem ajudá-lo a entender melhor uma integração de agente virtual personalizada.

Alguns links nesta página abrem sites fora da ajuda online do NiCE CXone.

Requisitos

Para testar a integração de exemplo, você deve ter:

  • Studio instalado no seu computador.
  • 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 outro editor de código.
    • Java: VS Code Community, Jet Brains, Net Beans, Intelli J, Eclipse ou outras. Se você usa o editor VS Code, precisa baixar e instalar o pacote de extensões Java do site do Visual Studio Marketplace.
    • Node.js: NPM.
    • PHP: VS Code ou outro editor de código.
    • Python: VSCode ou outro editor de código.
  • Ngrok instalado no seu computador. Você pode encontrar a instalação neste site: https://ngrok.com/download.

Complete cada uma dessas tarefas na ordem indicada.

Configurar o Terminal do túnel proxy

Execute essa Chamada de API em uma porta de localhost. Anote o número da porta em que o serviço é executado. Você precisará do número em uma etapa posterior. Clique na lista suspensa para ver as instruções para configurar o terminal para cada linguagem disponível.

Expor Terminal de Proxy Tunnel

O terminal do túnel proxy deve ser exposto para que o NiCE CXone possa acessá-lo globalmente. Use o Ngrok para expor o terminal.

  1. Instale o Ngrok, se ainda não tiver feito isso.
  2. Inicie o Ngrok usando este comando no prompt de comando:

    ngrok http [port number]

    onde [port number] é o número da porta que você anotou ao configurar o terminal.

  3. Copie o URL do servidor que o Ngrok expõe e os terminais de API necessários.

    Na imagem de exemplo, o URL exposto é https://4db3-5-46-62-207.nrgok.io. Esse é o URL base do webhook. Determine qual terminal usar com seu URL. Salve a URL para usar quando você configurar a ação do textbot Studio em uma tarefa posterior.

As etapas para determinar o terminal, descritas nesta seção, aplicam-se somente ao exemplo de integração. Quando você criar seu próprio terminal, poderá ser qualquer coisa que atenda às necessidades da sua organização.

Configurar um script de chat simples no Studio

  1. Baixe este script de chat simples.
  2. Extraia o arquivo TextBotExchangeExample.xml para o seu computador.
  3. Em Studio, clique em Arquivo > Importar do Arquivo, selecione o arquivo extraído e clique em Abrir.
  4. Salvar o script. Lembre-se do nome que você deu ao script. Deixe o script aberto. Você retornará a ele em uma tarefa posterior.

Criar uma Competência de chat e ponto de contato em NiCE CXone

Você precisa criar uma competênciaClosed Usada para automatizar a distribuição de interações com base nas competências, nas habilidades e no conhecimento dos agentes. de chat e um ponto de contatoClosed O ponto de entrada que um contato de entrada usa para iniciar uma interação, como um número de telefone ou endereço de e-mail.. O ponto de contato chama o script que você importou. É assim que o NiCE CXone encaminha os contatos para o seu agente virtual.

  1. Em NiCE CXone, clique no seletor de aplicativos Icon of three-by-three grid of white squares on a blue background e selecioneACD.
  2. Clique em Configurações de contato> ACD Competências e crie uma Competência de chat. Você deve dar à competência um Nome e a atribua a uma Campanha. Talvez você queira criar uma campanha para usar na integração de amostra. Você pode aceitar os padrões para todas as outras opções de competência.
  3. Acesse Configurações de contato > pontos de contato e crie um ponto de contato com as seguintes Configurações:

    • Tipo DE mídia: Selecione Chat.
    • Script: Selecione o nome do script que você importou para usar com a integração de exemplo.
    • Competência: Selecione o nome da competência que você criou nesta tarefa.
  4. Depois de criar o ponto de contato, copie o URL do ponto de contato exibido na guia Detalhes. Cole-o em uma aba do seu navegador. Você usará essa URL em uma tarefa posterior para testar o script.

Configurar a Ação do TextBot Exchange

Esta etapa configura o NiCE CXone para se comunicar com o terminal do túnel proxy de amostra.

  1. Em Studio, abra o script que você importou script you imported, caso ainda não esteja aberto.
  2. Dê um duplo clique em uma das ações Textbot Exchange para abrir Virtual Agent Hub.

  3. Clique Adicionar bot.
  4. Digite um Nome de Agente virtual (Bot) e selecione Terminal Exchange Personalizado como Provedor de bot.
  5. Clique em Avançar.
  6. Digite o URL DO webhook. Esse é o URL que você salvou depois de expor o terminal de túnel proxy.
  7. Clique em Avançar.
  8. Na página Voz, selecione Apenas texto em Opções de Integração de Voz e, em seguida, clique em Próximo.
  9. Na página Testar + Adicionar, clique em Iniciar com intenção DE boas vindas. Testar outras opções, como enviar carga útil personalizada, conforme desejado. Se não houver erros, siga para a próxima tarefa. Se o teste resultar em erros, revise as tarefas anteriores para verificar a configuração e a exposição do terminal do túnel proxy e a configuração em Virtual Agent Hub.

Testar o script em uma janela de chat

Depois de resolver todos os erros que ocorreram ao testar a configuração da ação Textbot Exchange, você pode testar o script usando a URL de ponto de contatoClosed O ponto de entrada que um contato de entrada usa para iniciar uma interação, como um número de telefone ou endereço de e-mail. que você copiou em uma tarefa anterior.

  1. No Studio, abra o script de amostra que você importou.
  2. Clique em Depurar > Capture Script > Somente Próxima instância.
  3. Na guia do navegador em que você colou a URL do ponto de contato, digite uma mensagem no campo Enter your text e clique em Enviar.
  4. No Studio, a janela Rastrear Saída é aberta. Ela mostra o progresso do script conforme você envia mensagens e o script responde.

    Clique em uma ação no painel principal na janela Trace Output .

    • A aba Variáveis mostra todas as variáveis que existem no script quando a ação selecionada é Concluída. Ela também mostra o valor que cada Variável contém nesse ponto do script.
    • A guia Propriedades mostra as propriedades da ação selecionada. Você pode usar isso para verificar a configuração atual da ação.
  5. Volte ao script e faça alterações, se necessário.
  6. Para acessar a ajuda online para uma ação, selecione-a na tela e pressione F1 em seu teclado. A página de ajuda online de cada ação descreve as propriedades e outras informações sobre como usar a ação em um script.
  7. If você quiser recomeçar, clique em encerrar chat, atualize a janela do navegador e repita este processo, começando pela etapa 2.