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 e criar-modelo-mensagem.
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-automacao.
- Configure o gatilho da automação com o evento que deve iniciar a conversa — por exemplo, Card mudou de etapa. Veja gatilhos-condicoes.
- 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 (chatbots que ainda não foram publicados também aparecem na lista, marcados como "(pausado)").
- 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-modelo-mensagem.
- 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.