#Karoo
#Karoo
Breadcrumbs

Sistemas Externos


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.

    Unknown Attachment

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:

    Preferências

    Campo

    Descrição

    Nome de Apresentação

    Nome que será exibido para identificar o chatbot.

    Status

    Defina 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. Unknown Attachment

    Transferir sessão por resposta inválida

    Habilite 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 conversa

    Defina o tempo limite (mínimo de 15 minutos) sem resposta para encerrar a conversa. Uma nova interação reinicia o fluxo.

    ID Externo

    Informe o identificador único para integração externa, se houver.

    Token de acesso

    Informe o token configurado no menu Integrações, utilizado para acesso externo via API.


    Variáveis Globais

    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: 

    Campo

    Descrição

    Exemplo 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
    Canais

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

    Mensagem padrão

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