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 —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 umcriar-chatbotno builder visual, sem códigoeUsar os nós: enviar mensagem, pergunta, menu e condiçãousar-nos. - Um canal oficial (Meta) com um modelo de mensagem aprovado, usado como abertura. Veja
Conectar WhatsApp Oficial (API da Meta)conectar-whatsapp-oficial eCriar um modelo decriar-modelo-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 —chatbot: ele vem de uma automação. Abra Bots → Automação CRM e crie (ou abra) uma automação. VejaCriar sua primeira automaçãocriar-automacao. - Configure o gatilho da automação com o evento que deve iniciar a
conversa —conversa, por exemplo, Card mudou de etapa. VejaDefinir gatilhos e condiçõesgatilhos-condicoes. - Em Adicionar passo, adicione a ação Iniciar chatbot ao
fluxo —fluxo: a janela de configuração abre sozinha.

Janela do passo Iniciar chatbot na Automação CRM: Canal, Chatbot e Modelo de abertura (HSM)
- 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ó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 —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 decriar-modelo-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. VejaPublicar, pausar e acompanhar opublicar-pausar-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 opublicar-pausar-chatbot. - Sintoma: o chatbot foi pausado depois do disparo e o contato respondeu. Solução:
esperado —esperado, a conversa segue o fluxo normal do canal (outros chatbots ativos ou a fila de atendimento), sem o chatbot pausado.
Artigos relacionados
Nó "Iniciar chatbot"no-iniciar-chatbotCriar sua primeira automaçãocriar-automacaoPublicar, pausar e acompanhar opublicar-pausar-chatbotEncadear ações e acompanhar as execuçõesencadear-acompanhar-automacao