Integre seu sistema ao Karoo BOT para envio proativo de mensagens e documentos.

Com essa integração, é possível automatizar o envio de mensagens e documentos, como boletos ou alertas, sem a necessidade de interação prévia do cliente. A configuração é feita via API, permitindo uma comunicação mais eficiente.

O que é um Chatbot Proativo?

Um chatbot proativo é um sistema que inicia a comunicação com o cliente sem aguardar uma interação inicial. Ao contrário do chatbot reativo, que depende de uma mensagem do cliente para responder, o proativo atua por conta própria. Por exemplo, ao enviar boletos automáticos, ele notifica o cliente assim que um novo boleto está disponível.


Configurar Integração

Sigas os passos abaixo para gerar o token necessário para a integração:

  1. No menu lateral do Karoo Bot, selecione 'Integrações'.
  2. Escolha a opção 'Sistemas Externos'.
  3. Clique em 'gerar token'.
  4. Copie o token gerado.

    Karoo Bot - Sistemas Externos

Finalizando a integração

Com o token copiado, cole-o no campo correspondente do seu sistema para concluir a integração.


Criar Chatbot Proativo‎

  1. No menu lateral do Karoo Bot, selecione 'Chatbots'.
  2. Clique em 'Criar Novo'.
  3. Escolha a opção 'Criar do Zero'.
  4. Defina as Configurações do chatbot:
    CampoDescrição
    Nome de ApresentaçãoNome que será exibido para identificar o chatbot.
    StatusDefina se o chatbot estará Ativo ou Inativo.
    Exclusivo para mensagens proativas

    Habilite para envio de mensagens proativas.

    1. Digite o ID Externo.
    2. Em Token de acesso, selecione Sistemas Externos. Sistemas Externos
    Transferir sessão por resposta inválidaHabilite para transferir a sessão para um humano após 3 respostas inválidas em um menu de opções.
    Minutos de inatividade para encerrar uma conversaDefina o tempo limite (mínimo de 15 minutos) sem resposta para encerrar a conversa. Uma nova interação reinicia o fluxo.
    ID ExternoInforme o identificador único para integração externa, se houver.
    Token de acessoInforme o token configurado no menu Integrações, utilizado para acesso externo via API.

    As variáveis globais permitem configurar parâmetros reutilizáveis no fluxo do chatbot. Elas são úteis para personalizar mensagens, armazenar valores dinâmicos e facilitar a manutenção.

    Abaixo está uma explicação detalhada das principais variáveis globais disponíveis: 

    CampoDescriçãoExemplo de Valor

    ENCERRA_FLUXO

    		Define a condição para encerrar o fluxo atual do chatbot e retornar ao estado inicial. É útil para garantir que a conversa recomece do início após determinadas interações.

    #ENCERRAR

    MENU_PRINCIPAL

    		Representa o identificador para o menu principal do chatbot. Pode ser usado para redirecionar o usuário ao menu inicial durante a navegação.

    #MENU

    ID_CONTA_KAROO

    		Identificador único associado à conta Karoo do cliente. Essa variável é utilizada para autenticação ou personalização de fluxos com base na conta específica.

    12345

    NUMERO_CLIENTE

    		Número de identificação do cliente ou qualquer código exclusivo que represente o usuário no sistema. Pode ser usado em mensagens personalizadas ou em integrações externas.

    987654321

    NOME_CLIENTE

    		Nome completo ou apelido do cliente. Usado para personalizar as interações e criar uma experiência mais amigável.

    JOÃO SILVA

    OMNICHANNEL_SESSION

    		Identificador de sessão utilizado em contextos Omnichannel. Permite rastrear interações do usuário em diferentes canais, como WhatsApp, Instagram ou outros meios integrados.

    SESSÃO_001

    Adicione os canais disponíveis (como WhatsApp e Instagram) cadastrados no menu Canais.

    • Encerramento por inatividade: Defina a mensagem a ser enviada ao cliente quando a conversa for encerrada por inatividade.
    • Transferência por resposta inválida: Personalize a mensagem a ser enviada quando houver três respostas inválidas e a configuração “Transferir sessão por resposta inválida” da aba Preferências estiver habilitada.


  5. Clique em Salvar.