Disparar o chatbot proativamente a partir do CRM
Faça o chatbot começar a conversa por conta própria (quando um card entra numa etapa do CRM, por exemplo) em vez de esperar o contato falar primeiro.
🧩 Este recurso faz parte do módulo Chatbots. Se ele não aparecer na sua conta, fale com o administrador para ativá-lo. Veja Planos e módulos.
Objetivo
Disparar um chatbot a partir de um evento do CRM, usando uma automação com o passo Iniciar chatbot.
Pré-requisitos
- Perfil Administrador.
- Um chatbot já criado, com o fluxo montado. Veja Criar um chatbot no builder visual, sem código e Usar os nós: enviar mensagem, pergunta, menu e condição.
- Um canal oficial (Meta) com um modelo de mensagem aprovado, usado como abertura. Veja Conectar WhatsApp Oficial (API da Meta) e Criar um modelo de mensagem (WhatsApp Oficial).
Tempo estimado
5 minutos.
Caminho de acesso
Bots → Automação CRM
💻 O builder de automações é uma tela de computador (desktop).
Passo a passo
- O disparo proativo não sai de um botão dentro do chatbot: ele vem de uma automação. Abra Bots → Automação CRM e crie (ou abra) uma automação. Veja Criar sua primeira automação.
- Configure o gatilho da automação com o evento que deve iniciar a conversa, por exemplo, Card mudou de etapa. Veja Definir gatilhos e condições.
- Em Adicionar passo, adicione a ação Iniciar chatbot ao fluxo: a janela de configuração abre sozinha.

- Em Canal, escolha o canal por onde a mensagem sai.
- Em Chatbot, selecione o chatbot que vai assumir a conversa depois da abertura. Os ainda não publicados aparecem marcados como "(rascunho)" e os pausados como "(pausado)". Só um chatbot publicado é iniciado.
- Em Modelo de abertura (HSM), escolha um modelo aprovado para aquele canal e preencha as variáveis que aparecerem (texto fixo ou uma variável do card, como
{{primeiro_nome}}). - Ligue as saídas do passo (Iniciado e Falha) aos próximos passos, se quiser tratar cada caso. Clique em Salvar e ativar para deixar a automação funcionando.
Resultado esperado
Quando o evento acontece, a automação cria a conversa no canal, envia o modelo de abertura e, assim que o contato responde, entrega o atendimento ao chatbot escolhido, que segue o fluxo montado no builder.
Erros comuns
- Sintoma: o campo Modelo de abertura (HSM) diz "Nenhum modelo aprovado para este canal". Solução: o disparo proativo exige um canal oficial (Meta) com modelo aprovado; sincronize/aprove o modelo em Ajustes → Modelos de Mensagem. Veja Criar um modelo de mensagem (WhatsApp Oficial).
- Sintoma: o passo cai na saída Falha com "Não iniciado: o chatbot ... está em rascunho" (ou "está pausado"). Solução: publique o chatbot. O modelo de abertura não é enviado enquanto ele não estiver publicado. Veja Publicar, pausar e acompanhar o chatbot.
- Sintoma: o passo cai na saída Falha por outro motivo. Solução: confira se o canal está conectado e se o contato tem um número válido; acompanhe o motivo pelo Histórico. Veja Publicar, pausar e acompanhar o chatbot.
- Sintoma: o chatbot foi pausado depois do disparo e o contato respondeu. Solução: esperado, a conversa segue o fluxo normal do canal (outros chatbots ativos ou a fila de atendimento), sem o chatbot pausado.