CHAT BOT INTERNO
🧭 Escolha e Prioridade dos Bots
⚠️ Atenção: Se a fila associada ao canal tiver integração ativa, o bot não será acionado.
O sistema utiliza quatro critérios de prioridade para definir qual bot será usado em novos tickets. Eles são avaliados nessa ordem:
1️⃣ Lane do CRM
Todos os contatos vinculados a uma lane específica do CRM seguirão o bot configurado para ela. Ao enviar uma mensagem para o número do sistema, se não houver tickets abertos ou pendentes, o bot dessa lane será acionado.
2️⃣ Palavra-chave
Permite definir palavras que acionam um bot específico. Exemplo: se você cadastrar a palavra "comprar", e o cliente enviar "Eu quero comprar", a mensagem será direcionada ao bot configurado.
⚠️ Observação: a palavra-chave só funciona na primeira mensagem de um novo ticket. Se o cliente enviar “oi” e depois “quero comprar”, não será reconhecida.
3️⃣ Canal
Cada canal pode ter um bot próprio. Quando o cliente envia uma mensagem para o número do sistema, caso não existam tickets abertos ou pendentes, o bot configurado nesse canal será utilizado.
4️⃣ Configurações Globais
Se nenhum dos critérios anteriores se aplicar, o sistema usará o bot configurado no fluxo ativo padrão.
Essas prioridades determinam qual bot será acionado sempre que uma nova mensagem for recebida sem ticket aberto ou pendente. Garanta que cada bot esteja corretamente configurado em seu respectivo nível para que o atendimento funcione conforme o esperado.
📚 Índice
⚙️ Configuração de Fluxo
A configuração do fluxo do chatbot é feita pela interface visual:
🔧 Elementos Básicos de Configuração
A partir da versão 2.11.0, estão disponíveis as seguintes interações:
💬 Enviar Mensagem
Permite definir o texto a ser enviado ao cliente.
Suporta variáveis dinâmicas (veja seção de variáveis).
📎 Enviar Documentos, Vídeos, Áudios e Arquivos
Envio de qualquer tipo de arquivo.
😄 Enviar Figurinhas
Converte automaticamente qualquer imagem enviada em figurinha.
📍 Enviar Localização
Envia localização para o contato.
Compatível apenas com a WHATSAPP oficial e não oficial.
⏱️ Adicionar Delay
Define o tempo (em segundos) entre as mensagens.
Garante a sequência correta de envio.
🏷️ Adicionar Tag
Marca o contato com uma etiqueta específica.
📂 Adicionar CRM
Move o contato para uma lane do CRM compartilhado.
🔁 Alterar Follow-up
Adiciona ou remove o cliente de um follow-up.
🌐 HTTP Request
Permite realizar requisições externas e gravar o resultado em variáveis.
⚡ Forçar Execução de Condições
Executa condições sem esperar uma nova mensagem. Exemplo: fazer uma requisição HTTP, salvar o resultado e comparar a variável obtida.
🗂️ Adicionar Lista
Compatível com API oficial e API Plus.
Funciona parcialmente no Baileys (sem suporte oficial, pode parar a qualquer momento).
🔘 Enviar Botões
Compatível com WhatsApp oficial, Facebook, Instagram e API Plus.
Máximo de 3 botões.
🔗 Botão com Link
Compatível com API oficial e API Plus.
📍 Solicitar Localização
Envia botão solicitando a localização do cliente.
Útil para serviços de entrega.
Compatível com API oficial e API Plus.
🧩 Botão Dinâmico
Exclusivo da API Plus.
Permite misturar tipos de botões: resposta, link, cópia, ligação, etc.
Alguns dispositivos pode aparecer mensagem não compativel
🎠 Carrossel de Mídia
Exclusivo da API Plus.
Envie várias imagens com botões interativos abaixo delas.
Alguns dispositivos pode aparecer mensagem não compativel
🔄 Ordem das Interações
⚠️ Importante:
Os números indicam a sequência exata de execução.
Use delays entre mensagens múltiplas para manter a ordem correta.
🧩 Configuração de Condições
Tipos de Condições (em ordem de prioridade)
🕓 Dentro/Fora do Horário de Atendimento
Funciona apenas na etapa "Boas-vindas!".
Deve estar no início das condições.
Define ações diferentes para dentro ou fora do horário comercial.
✅ Respostas Exatas
Exemplo: “1” ou “01”.
A resposta precisa ser idêntica ao configurado.
🔍 Contém Exato
Reconhece frases completas. Exemplo: “Eu quero comprar um tênis”.
🧠 Contém
Reconhece partes da frase. Exemplo: “comprando”, “comprador” → reconhece “compra”.
✳️ Qualquer Resposta
Sempre posicionada por último.
Captura qualquer resposta não reconhecida.
⏰ Dentro/Fora de Horário Personalizado
Define ações específicas conforme horários configurados manualmente.
🧮 Comparação de Variáveis
Permite comparar valores fixos, variáveis existentes ou verificar se uma variável foi definida.
⚠️ Respostas Inesperadas
Se nenhuma condição for atendida, o bot enviará:
“Desculpe! Não entendi sua resposta. Vamos tentar novamente! Escolha uma opção válida.”
(Essa mensagem pode ser personalizada nas configurações.)
⚙️ Configurações Gerais
Opções disponíveis:
Mensagem de saudação (Fila/Usuário): enviada ao transferir ticket.
Se nenhuma resposta for enviada: mensagem padrão caso nenhuma condição seja cumprida.
Ausência de resposta: define ação após determinado tempo sem interação.
Máximo de tentativas do bot: define o que fazer se o cliente não responder corretamente.
Outras configurações podem ser ajustadas conforme necessidade.
🧠 Exemplos Práticos de Fluxos
1️⃣ Fluxo com Horário de Atendimento
Ideal para empresas com plantão ou suporte emergencial.
2️⃣ Fluxo com Variáveis Dinâmicas
Permite personalizar mensagens com dados do cliente.
Exemplo de uso:
Template:
Por favor, confirme se seu endereço é {{endereco}}?
1 - Sim
2 - Não
Mensagem enviada:
Por favor, confirme se seu endereço é Rua Marechal Deodoro, 11?
1 - Sim
2 - Não3️⃣ Fluxo de Agendamento com Cal.com
Integração com https://cal.com/
4️⃣ Fluxo sobre Whazing (lista, botão e links)
5️⃣ Fluxo com HTTP Request e Comparação de Variável
Exemplo que valida CEP e cidade via API.
6️⃣ Fluxo para Teste de API SaaS
Usa HTTP Request para gerar teste automático para o cliente.
7️⃣ Fluxo de Boas-vindas Simples
Envia mensagem de boas-vindas e direciona o cliente para uma fila.
Usa “Forçar executar condições” para simular uma resposta automática e avançar o fluxo.
8️⃣ Seleção de Fila por Palavra-chave
Permite enviar o cliente para uma fila específica conforme a palavra digitada. Com “Iniciar Integração ao transferir”, o sistema já ativa a integração automaticamente.
9️⃣ Consulta de CPF via API
Usa a API pública cpfhub.io.
O token do exemplo é limitado; recomenda-se gerar um novo para testes.
Atualizado