Pular para o conteúdo
D-APITestar grátis

automação e ia

Automação de anúncios Meta no WhatsApp com fluxos

Automação de anúncios Meta no WhatsApp: responda leads de click-to-WhatsApp e Lead Ads em segundos, com fluxos, HTTP e chatbots sem código novo.

Time D-API. Atualizado em .9 min de leitura.

Quem compra mídia na Meta para gerar conversa no WhatsApp sabe onde o dinheiro escorre: no intervalo entre o clique e a primeira resposta. A automação de anúncios Meta no WhatsApp fecha esse intervalo. O lead clica, a conversa abre e um fluxo responde na hora, qualifica, registra no CRM e avisa o comercial, tudo antes de alguém do time olhar o celular.

Para um SaaS que vende atendimento, agendamento ou marketing, isso vira recurso de produto. O seu cliente sobe a campanha e o seu sistema cuida do resto. A D-API entrega essa camada com um builder de fluxos no mesmo painel em que ficam as conexões, sem ferramenta separada para integrar e sem outro fornecedor para homologar.

Este artigo mostra o que dá para montar, como o dado do anúncio chega até você e onde entram as chamadas HTTP e os chatbots.

O que muda quando o lead do anúncio cai num fluxo

O ganho principal é tempo de resposta sem depender de gente. Um anúncio click-to-WhatsApp gera conversa a qualquer hora, inclusive de madrugada e no fim de semana. Um fluxo responde todas no mesmo padrão e entrega para o humano só quem já passou pela qualificação.

O segundo ganho é atribuição. Cada conversa vinda de anúncio carrega o identificador do clique e os dados do criativo. Com isso, o seu cliente para de adivinhar qual campanha trouxe venda e passa a ver isso no relatório, porque o evento volta para a Meta.

O terceiro ganho é que a regra de negócio fica com o seu sistema. O fluxo chama a sua API, recebe a resposta e decide o próximo passo com base nela. O builder orquestra; quem sabe se o lead tem cadastro, se a agenda tem horário ou se o CEP é atendido continua sendo o seu backend.

Como o dado do anúncio chega até o seu sistema

Antes de falar do builder, vale entender o dado bruto, porque é ele que alimenta tudo. Quando um contato inicia conversa a partir de um anúncio, o evento messages.received do webhook chega com os campos do anúncio em external_ad_reply, incluindo o ctwa_clid, que é o identificador do clique usado na atribuição.

Exemplo do payload, recortado da documentação:

{
  "event": "messages.received",
  "sessionId": "my-session",
  "timestamp": "2026-01-24T21:58:50.581Z",
  "data": {
    "type": "text",
    "message": "Olá, vi o anúncio e gostaria de mais informações.",
    "fromMe": false,
    "from": {
      "jid": "[email protected]",
      "name": "João"
    },
    "context_info": {
      "entry_point_conversion_app": "facebook",
      "entry_point_conversion_source": "ctwa_ad"
    },
    "external_ad_reply": {
      "title": "Título do anúncio",
      "body": "Texto do anúncio que o usuário viu",
      "ctwa_clid": "AffEzn5xEXlKpHmH8uQxUUPR7EIG...",
      "source_id": "120237659567410455",
      "source_type": "ad",
      "media_type": 2
    }
  }
}

Dois detalhes importam para quem integra. Primeiro, external_ad_reply aparece tanto dentro de context_info quanto na raiz de data, então você lê de um lugar só. Segundo, media_type vem numérico na API não-oficial (1 para imagem, 2 para vídeo) e como texto ("image", "video") nas conexões da API Oficial, do jeito que a Meta envia. A lista completa de campos está na documentação da D-API.

Se você prefere tratar tudo no seu código, esse webhook basta. O builder existe para o caso em que o seu cliente quer montar e mudar o fluxo sem abrir chamado para o seu time de engenharia. Os detalhes de entrega, retentativa e fila estão no artigo sobre webhooks do WhatsApp.

Os gatilhos que iniciam um fluxo

Cada fluxo começa num gatilho. O builder tem quatro, e eles cobrem as origens de lead mais comuns de um SaaS que vende para quem anuncia.

Mensagem recebida

Dispara quando chega mensagem numa conexão. Você escolhe quais conexões escutar (vazio significa todas), aplica filtros de texto (contém, começa com, igual a, regex) e pode ignorar grupos. Há também uma janela de reentrada: um contato que já entrou no fluxo não dispara de novo dentro do intervalo configurado, o que evita mandar a mesma saudação três vezes para quem clicou em três anúncios.

Meta Lead Ads

Dispara uma execução para cada lead de formulário instantâneo da Meta. Você conecta a credencial da conta de anúncios, escolhe a página e, se quiser, os formulários. Os campos do lead ficam disponíveis como variáveis, no formato {{input.lead.<campo>}}. Sem formulário selecionado, os campos comuns (full_name, email, phone_number) já vêm prontos.

Webhook

Cada fluxo com esse gatilho ganha uma URL própria. Qualquer sistema que faça um POST nela inicia uma execução, e os campos do corpo viram variáveis. É o caminho para formulário de landing page, checkout, ferramenta de agendamento ou o próprio backend do seu SaaS.

Campanha

Para disparos a partir de uma lista. Cada destinatário inicia uma execução com o telefone e as variáveis da lista.

Os blocos que fazem o trabalho

Depois do gatilho, o fluxo é uma sequência de blocos ligados por saídas. Os que mais aparecem em fluxo de anúncio:

  • WhatsApp: envia texto, imagem, vídeo, áudio, documento, botões, lista ou template por uma conexão oficial ou não-oficial. Pode aguardar a resposta do contato, salvar o que ele escreveu numa variável e seguir por “Respondeu” ou “Sem resposta” quando o prazo acaba.
  • Condição: ramifica por igual, contém, existe, maior que, menor que ou regex, com atalhos prontos para e-mail e telefone brasileiro.
  • HTTP: chama qualquer API com método, headers e corpo em JSON, aceitando variáveis. A resposta fica salva com o nome que você der e alimenta os blocos seguintes.
  • Atraso: espera minutos, horas ou dias antes de continuar.
  • SMS e Ligação (URA): alcançam o lead fora do WhatsApp, com áudio e menu por tecla.
  • CTWA Enrich: resolve campanha, conjunto e anúncio de origem e os expõe como variáveis.
  • CTWA Tracking: envia um evento (como Purchase, LeadSubmitted ou Contact) à Conversions API da Meta.

No canvas, cada bloco mostra as próprias saídas, e é nelas que você liga o passo seguinte. Um fluxo de anúncio completo fica assim:

1. Gatilho "Mensagem recebida"
2. CTWA Enrich (Meta)
3. WhatsApp, tipo Botões
     "Quero orçamento": passo 4
     "Tenho dúvida": fila do atendimento
     "Já sou cliente": fila do suporte
     "Sem resposta" (24h): Atraso + lembrete
4. HTTP POST para o CRM
     Sucesso: passo 5
     Erro: SMS de contingência
5. CTWA Tracking (Pixel), evento LeadSubmitted

Três fluxos que um SaaS consegue entregar no primeiro mês

Qualificação de lead de click-to-WhatsApp

O lead chega pelo anúncio. O bloco CTWA Enrich identifica a campanha. O bloco WhatsApp manda uma mensagem interativa com três botões (“Quero orçamento”, “Tenho dúvida”, “Já sou cliente”). Cada botão é uma saída. “Quero orçamento” chama via HTTP o CRM do seu cliente para criar o negócio já com o nome da campanha; “Já sou cliente” vai direto para a fila do suporte. Se o contato não responde em 24 horas, o fluxo segue por “Sem resposta” e agenda um lembrete. O artigo sobre botões e listas na API detalha o que cada tipo de mensagem suporta.

Formulário instantâneo com retorno imediato

O gatilho Meta Lead Ads recebe o lead com nome, e-mail e telefone. Uma condição valida o telefone com o atalho de telefone brasileiro. Se passou, o bloco WhatsApp manda a primeira mensagem usando {{input.lead.full_name}}. Se o contato está fora da janela de 24 horas numa conexão oficial, a abertura precisa ser um template aprovado. Se o telefone não passou, o fluxo cai num SMS ou numa ligação com URA.

Chatbot de triagem com consulta ao seu sistema

Aqui o HTTP é o protagonista. O contato escreve, o fluxo salva a resposta como variável, chama a sua API com ela e decide o caminho pelo que voltou. É um chatbot de regras, previsível e auditável, que resolve horário, segunda via, status de pedido e encaminhamento. Quando a conversa pede linguagem livre, o próximo passo é um agente de IA, assunto do artigo sobre agentes de IA no WhatsApp com MCP.

Medir o que o anúncio trouxe de verdade

Responder rápido é metade do trabalho. A outra metade é devolver para a Meta o que aconteceu depois do clique, para que a otimização da campanha trabalhe a favor do seu cliente.

O bloco CTWA Tracking cuida disso. Ele pega o ctwa_clid da conversa sozinho e, em conexões Cloud API, resolve o dataset pela WABA da conexão. Em conexão não-oficial, você informa o WABA ID manualmente. O evento leva custom_data com valor, moeda e nome do produto, todos aceitando variáveis. Antes de publicar, o botão “Validar configuração” testa token e evento com um evento de teste, sem gravar conversão real. Um cuidado prático: a Meta rejeita o evento Lead em CTWA, então use LeadSubmitted ou um evento personalizado.

Para conversas oficiais, vale lembrar que a conversa aberta por anúncio click-to-WhatsApp tem a regra de entrada gratuita via anúncio. As tarifas da Meta mudam por categoria e país, e quem paga é a conta Meta do cliente final. Para estimar esse valor, multiplique o volume de templates de cada categoria pela tarifa da tabela de preços da Meta.

Execuções, teste e consumo

Fluxo que roda sem visibilidade vira chamado de suporte. Por isso cada execução fica registrada com status (rodando, aguardando, concluída, falhou) e com os passos percorridos. Dá para filtrar por bloco, ver quem caiu em erro e exportar os contatos em CSV.

Para testar sem depender de um lead real, você fixa uma execução do histórico como dado de teste e roda o fluxo de novo com ela. O painel avisa que o teste executa de verdade, então mensagens saem e créditos são consumidos. Há também um painel de consumo por bloco, com o custo de SMS e URA do mês.

Onde o builder entra na arquitetura do seu SaaS

Existem dois jeitos de usar, e eles convivem bem.

No primeiro, o seu time monta fluxos padrão (qualificação, lembrete, pós-venda) e oferece aos clientes como recurso pronto. O seu backend conversa com o fluxo pelo gatilho de webhook e pelo bloco HTTP, e a lógica de negócio continua no seu código.

No segundo, o seu backend trata tudo direto pela API e pelos webhooks, e o builder fica para a operação montar campanhas pontuais sem fila de engenharia. Os dois caminhos usam as mesmas conexões, na mesma conta.

O builder fica no painel da D-API, na conta do SaaS, sem versão white-label nem embed para o cliente final. Quem faz a interface é o seu produto: o seu cliente configura a automação na sua tela, o seu backend dispara o fluxo pela URL de webhook com os dados daquele cliente e o fluxo escuta só as conexões que você escolher no gatilho. Para o seu time, a conta aceita membros com permissão de leitura ou escrita, restritos a conexões específicas.

Por baixo, a infraestrutura é a mesma que sustenta 1.875 conexões em 4 datacenters no Brasil, com 99,9% de uptime garantido em contrato, IPs dedicados e conexões isoladas por cliente. O fluxo herda essa base, então o seu time não precisa operar fila, reentrega nem reconexão para a automação funcionar.

Por onde começar

Comece pelo fluxo que dá retorno mais rápido: resposta imediata ao lead de click-to-WhatsApp com três botões e um HTTP para o CRM. Ele exige uma conexão, um gatilho de mensagem recebida e quatro blocos. Com ele rodando, adicione o CTWA Tracking para devolver a conversão à Meta e compare o custo por venda antes e depois.

Em seguida, ligue o gatilho de Meta Lead Ads para os clientes que usam formulário instantâneo e crie a rota de SMS ou URA para quem não responde no WhatsApp. Se o seu produto já tem webhook próprio, mantenha a lógica no backend e use o builder onde a operação precisa de autonomia. O preço por conexão cai com o volume e está na tabela de preços.

Veja também: Integração, Para SaaS.

Perguntas frequentes

Preciso programar para montar um fluxo de anúncio?

Para o caminho comum, não. Gatilho, mensagens, botões, listas, esperas e condições são blocos visuais. Código entra quando você quer integrar com o seu sistema, e mesmo assim pelo bloco HTTP, que chama a sua API com as variáveis do lead.

O fluxo funciona com API Oficial e com API não-oficial?

Sim. O bloco de WhatsApp envia por qualquer conexão da conta, oficial ou não-oficial. Os campos do anúncio chegam no mesmo formato nos dois casos, com uma diferença documentada no tipo de mídia do anúncio.

Consigo medir conversão de anúncio click-to-WhatsApp na Meta?

Sim. O bloco CTWA Tracking envia eventos para a Conversions API da Meta usando o ctwa_clid da conversa, e o bloco CTWA Enrich resolve campanha, conjunto e anúncio de origem para usar nas etapas seguintes.

Leads de formulário instantâneo da Meta também entram no fluxo?

Entram. O gatilho Meta Lead Ads dispara uma execução para cada lead recebido da página e dos formulários escolhidos, com os campos do lead disponíveis como variáveis.

Quem paga as mensagens enviadas pelo fluxo na API Oficial?

As tarifas de mensagem da Meta são cobradas na conta Meta (WABA) do cliente final. A D-API cobra por conexão. Para estimar o custo de mensagens, multiplique o volume previsto por categoria pela tarifa da página oficial de preços da Meta.

Teste com o time técnico do seu lado

SaaS liberado pelo time testa 14 dias grátis, com um grupo de onboarding em que o time da D-API acompanha a integração no seu produto.

Leia também

Liberar seu teste grátis

Responda rapidinho e o time libera seu teste pelo WhatsApp, com o time técnico ajudando na integração.

Seus dados são usados só pra liberar o teste. Sem spam.