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 [Entender planos, módulos e o que está incluído](/books/comece-por-aqui/page/entender-planos-modulos-e-o-que-esta-incluido).
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á publicado. Veja Publicar, pausar e acompanhar o chatbot.
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ções
💻 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ções 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 e clique nela para abrir a configuração.
🖼️ PRINT — Painel da ação Iniciar chatbot com os campos 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.
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 publique a automação.
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. Veja Criar um modelo de mensagem (WhatsApp Oficial).
Sintoma: o passo cai na saída Falha. 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.
Artigos relacionados
Nó "Iniciar chatbot"
Criar sua primeira automação
Publicar, pausar e acompanhar o chatbot
Encadear ações e acompanhar as execuções