Integrações personalizadas de API no Bot Builder

É possível configurar integrações personalizadas utilizando APIsFechado APIs permitem automatizar certas funcionalidades conectando seu CXone sistema com outro software que sua organização usa.. Isso permite utilizar o seu próprio banco de dados ou aplicativos de terceiros com o bot. É possível conectar o Bot Builder e o serviço da Web ao qual você estiver se integrando, configurando-se a integração personalizada.

Depois que a integração estiver configurada, será necessário criar uma ou mais ações de bots. Isso permite definir as solicitações que serão enviadas ao serviço integrado da Web. É possível utilizar estas ações de bots nos diálogosFechado Histórias e regras de bot no Bot Builder. para que o bot envie uma solicitação ao serviço da Web em pontos específicos da conversa.

A página Nova Integração da guia APIs, onde é possível configurar a autenticação e criar ações.

Criar uma nova integração de API

É necessário criar apenas uma integração por serviço da Web ao qual você estiver se conectando.

  1. No CXone, clique no seletor de aplicativos e selecioneBot Builder.

  2. Clique no bot com o qual você deseja trabalhar.
  3. Clique em Integraçõesícone, que parece um plugue. no menu do ícone esquerdo.
  4. Na guia APIs, clique em Nova integração.
  5. Clique no título padrão Nova integração para renomear a integração e, em seguida, pressione Enter, para salvar a alteração.
  6. Em Autenticação, selecione um método de autenticação. Digite as informações necessárias correspondentes ao tipo selecionado.
    CampoDetalhes
    Público

    A sua integração API não requer autenticação. Nenhuma etapa adicional é necessária.

    Você ainda pode adicionar uma linha de autorização no JSON para todas as ações que criar.

    OAuth 2.0

    Preencha os campos URL de autorização, Chave e Segredo. Os detalhes de Escopo são opcionais. O escopo permite limitar o grau de acesso concedido a um token. O Bot Builder utiliza o tipo de concessão OAuth 2.0 das credenciais do cliente.

    Estas informações podem ser encontradas na conta correspondente ao serviço da Web com o qual você estiver se integrando.

    Personalizado

    No editor de solicitações JSON, adicione uma linha para autorização na seção "cabeçalhos" e digite o método de autenticação que você quer usar. Você pode usar a autenticação básica, JSON Web Token, Simple Web Token ou Bearer Token. 

    {
  "headers": {
  "Content-Type": "application/json",
  "Authorization": "[authentication_type] [token]"
  }
}
  7. Adicione uma ou mais ações à integração.
  8. Quando terminar de fazer as alterações, clique em Treinar e palco, para atualizar o modeloFechado Versão de um bot que foi treinado e testado de bot.

  9. Adicione sua ação a uma históriaFechado Usado para treinar bot para manipulação de interação com base na intenção e contexto, regraFechado Usado para definir a resposta do bot a mensagens que não mudam com o contexto. ou fallbackFechado Uma alternativa em texto simples enviada quando o destino não tem suporte para mídia avançada.. A seção APIs das opções de ação do bot mostra todas as ações de integração de API que você configurou e ativou.

    Uma janela em que você seleciona uma resposta do bot nas guias Geral, Formulários, APIs ou Scripts

Criar uma ação de bot personalizada para uma integração

É necessária pelo menos uma ação de bot personalizada na integração de API. Depois que tiver criado e ativado a ação de bot personalizada, você poderá utilizá-la em uma resposta do bot ao trabalhar comdiálogosFechado Estado que permite que um agente conclua os requisitos de trabalho após terminar uma interação..

  1. No CXone, clique no seletor de aplicativos e selecioneBot Builder.

  2. Clique no bot com o qual você deseja trabalhar.
  3. Clique em Integraçõesícone, que parece um plugue. no menu do ícone esquerdo.
  4. Selecione a pasta correspondente às intenções com as quais queira trabalhar ou crie uma nova intenção.
  5. Em Ações, clique em Nova Ação.
  6. Digite o nome da ação e pressione Enter.
  7. Clique na ação para configurá-la.
  8. Em Configuração, grave a sua configuração na janela Solicitar JSON. Os valores de slot podem ser usados como variáveis no formato {{slot_name}}. Você pode usar o parâmetro mockSlots para fins de teste.
  9. Clique Pedido de Teste a qualquer momento para preencher a janela Resposta.
  10. É possível utilizar o campo Mensagem de erro, abaixo de Resolução de erros, para especificar o que deverá ser mostrado ao contato em resposta a uma solicitação de API com falha.
  11. Você pode selecionar o Modo de depuração caixa de seleção para adicionar uma resposta de sufixo à mensagem de erro.
  12. Quando a ação estiver pronta para ser utilizada com o bot, clique no interruptor de ação Uma forma oval oblonga contendo um círculo, que se movimenta de um lado para outro quando clicada., no alto da página de configuração de ação. Se a chave estiver desligada, a ação não estará disponível para uso.

  13. Quando terminar de fazer as alterações, clique em Treinar e palco, para atualizar o modeloFechado Versão de um bot que foi treinado e testado de bot.

Adicionar uma integração personalizada de API a uma competência de bot

É possível adicionar uma integração personalizada de API a uma ou mais de suas competências de bot. Isso permite utilizar as ações do bot de integração com as competências às quais for adicionada a integração.

  1. No CXone, clique no seletor de aplicativos e selecioneBot Builder.

  2. Clique no bot com o qual você deseja trabalhar.
  3. Clique em Integraçõesícone, que parece um plugue. no menu do ícone esquerdo.
  4. Na guia APIs, passe o cursor sobre a integração com a qual deseja trabalhar.
  5. Clique na elipse Ícone com três pontos alinhados. e selecione Adicionar à competência.
  6. Clique em uma ou mais competências para clicar em Selecionar tudo, para adicionar a integração a todas as competências disponíveis.
  7. Caso a competência desejada não esteja disponível, digite um nome na barra de pesquisa e, em seguida, clique em Criar competência.