Integração com chatbot

O sistema permite configurar a integração com uma solução externa de chatbot. Por padrão, o sistema disponibiliza classes de integração com tecnologias de mercado já conhecidas, para facilitar a configuração. São elas: Movidesk, Octadesk, Chatling e Dante AI. Ao escolher uma dessas classes, as opções de preenchimento das configurações já são apresentadas de maneira estruturada. Entretanto, é possível realizar a integração com qualquer outro chatbot disponível utilizando a classe “Outros Chatbots” e realizando as configurações necessárias. Uma vez configurado, o chatbot pode ser aberto pelo botão correspondente na barra principal.

Processo Chatbot

Caminho: Administração do sistema > Aparência e personalização > Chatbot.

Este processo permite realizar a configuração da integração do Web Framework com chatbots. É possível configurar vários chatbots diferentes, porém apenas um chatbot estará disponível para o usuário, podendo ser uma configuração distinta de acordo com seus grupos e papéis.

O processo é constituído por três grades:

  • Integrações com Chatbot: classe de dados “Integrações com Chatbot”. Nesta grade você pode adicionar, editar ou excluir integrações. Toda integração deve ter uma classe, código, nome e ícone.

  • Configuração do Chatbot […]: grade para configurar a integração com chatbot que foi criada. Ela muda a depender do registro selecionado em “Integrações com Chatbot”. Seus campos também mudam a depender de qual classe de Chatbot está sendo configurado. Mais detalhes adiante.

  • Regras para uso do Chatbot: define grupo, papel ou usuário que pode utilizar cada integração, e também o grau de prioridade. Quando um usuário possuir mais de uma regra para definição do chatbot vinculado a ele ou seus grupos, será utilizada a regra cujo campo “Prioridade” for mais alto.

Configuração

A seguir, um passo a passo de como criar e configurar um chatbot.

Insira um registro

Insira um registro em “Integrações com Chatbot” e escolha:

  • Classe: a classe do chatbot, pode ser Movidesk, Octadesk, Chatling, Dante AI ou Outros chatbots. A depender da classe de chatbot, sua configuração será feita de maneira diferente.
  • Código: código da configuração. Utilizado para identificar e agrupar os resultados obtidos com esta configuração de forma compacta.
  • Nome: nome da configuração. Será utilizado como dica do botão de acionamento do chatbot.
  • Ícone: ícone que será apresentado no botão de ativação e desativação do chatbot. Deve ser um dos ícones disponíveis em “Menu > Desenvolvimento > Componentes > Ícones”.

Configure o chatbot

Com o registro selecionado, configure o chatbot na grade ao lado preenchendo seus campos. A seguir, explicaremos as configurações de cada classe de chatbot.

Movidesk

Acesse as configurações do aplicativo do seu Movidesk e obtenha a chave do aplicativo. Esta chave identificará seu chat no Movidesk. Você também precisará preencher obrigatoriamente seu e-mail ou seu código de cliente. É através de uma das duas informações que o Movidesk identificará o cliente, dando preferência ao código de cliente. Seguem as descrições detalhadas de cada configuração:

  • Chave do aplicativo: é o código que identifica o seu aplicativo de chat no Movidesk. Ele poderá ser obtido nas configurações do aplicativo do seu Movidesk.
  • Logar automaticamente: quando marcado, será realizado um login automático no chat do Movidesk utilizando as credenciais configuradas. Não deve ser habilitado caso esteja utilizando o Movidesk apenas como “Base de conhecimento”.
  • Nome do cliente: nome identificador do cliente.
  • E-mail - E-mail que irá identificar o cliente. Informação opcional caso o campo “Código do cliente” seja informado. Do contrário, será obrigatório.
  • Código do cliente: código de referência do cliente. Informação opcional caso o campo E-mail seja informado. Do contrário, será obrigatório. Se esse campo for informado, é através dele que o cliente será identificado no Movidesk.
  • Código da organização: código de referência da organização (Empresa) do cliente. Informação opcional que será utilizada somente se o cliente não for encontrado e precisar ser cadastrado associado a alguma organização.
  • Iniciar ao abrir: quando marcado, a conversa será iniciada imediatamente no momento da integração. Do contrário, o cliente será direcionado para a tela inicial do chat, sendo necessário clicar em “Iniciar chat” para começar a conversa.
  • Permanecer conectado: quando marcado, mantém o usuário conectado indefinidamente no chat.
  • Assunto vazio: quando marcado, mantêm o assunto do ticket gerado pelo atendimento via chat vazio, precisando ser preenchido pelo agente que atender a solicitação de conversa. Se desmarcado, fixa o assunto do ticket com o nome do cliente, podendo ainda o agente que atendeu a conversa alterar o assunto posteriormente.

Octadesk

Preencha as seguintes configurações:

  • Chave do aplicativo: identificador da aplicação Octadesk, equivalente à opção “subDomain” da configuração do aplicativo.
  • Abrir a cada nova mensagem: indica se a caixa de mensagem do chat abre automaticamente a cada nova mensagem.

Na grade detalhe de campos adicionais, devem ser declarados os campos adicionais a serem configurados no Octadesk. Esses campos serão informados para o chatbot que poderá utilizá-los em seu roteiro de decisões. Os campos precisam ter sido configurados no bot do Octadesk de forma antecipada como “Campos de conversa”.

Chatling

Preencha o ID de integração com o identificador da aplicação Chatling. Este identificador pode ser obtido no parâmetro data-id na seção “Integrations > Add to website > Copy the code below” do website do Chatling.

Dante AI

Preencha o Código de compartilhamento do Chatbot. Este código é gerado no website do Dante AI. Para gerar o código, selecione a opção “Share Chatbot” no menu lateral da esquerda, escolha o chatbot que será compartilhado, o algoritmo de LLM e o modo de compartilhamento “Chatbot iFrame (Embed)”. Copie o código gerado e cole no campo.

Outros chatbots

É possível configurar um chatbot totalmente customizado. Para isso, um script para controlar o funcionamento do chatbot deve ser criado na Virtual File System. Deve ser um script com o tipo de mídia “javascript” (.js). Este script será executado no navegador, portanto, não pode depender de bibliotecas ou inclusões de scripts do servidor (.ijs).

Para uma configuração mais fina do chatbot a ser definida para cada integração criada para ele, é possível utilizar o campo “Configuração”.

Campos a serem preenchidos:

  • Módulo: a chave do módulo que controla o chatbot. Este módulo é um script na VFS.
  • Configuração: JSON enviado para o módulo de controle do chatbot durante a inicialização. Pode ser utilizado para informar credenciais ou identificadores únicos para o chatbot. Deve ser um JSON válido.

Também devem ser declarados quaisquer scripts adicionais necessários ao funcionamento da integração com o chatbot. Os caminhos desses scripts podem ser declarados na grade detalhe Scripts adicionais. Esses scripts podem ser obtidos na documentação específica de cada integração. É recomendado que seja dada preferência à carga desses scripts através de importação dinâmica dentro do módulo.

Defina as regras de uso

Uma vez configurado o chatbot, defina a sua prioridade de uso para um grupo, papel ou usuário por meio da grade “Regras para uso do Chatbot”. Crie um novo registro na grade, preencha o campo “Chatbot” com o código da integração recém-criada e defina as regras:

  • Grupo, papel ou usuário: grupo, papel ou usuário ao qual será definido o uso do chatbot.
  • Prioridade: quando um usuário possuir mais de uma regra para definição do chatbot vinculado a ele ou seus grupos, será utilizada a regra cujo campo “Prioridade” for mais alto.

Última atualização em 24 Feb 2025