Automação de WhatsApp por API e webhooks

As duas direções

Toda automação de WhatsApp é uma combinação de duas coisas. Vale entender as duas antes de desenhar qualquer fluxo, porque quase todo problema de automação é uma delas mal resolvida.

• Saída: seu sistema envia — uma venda foi aprovada, um pedido saiu para entrega, um agendamento é amanhã. Seu código chama a API e a mensagem sai.
• Entrada: o WhatsApp avisa você — o cliente respondeu, mandou um áudio, clicou num botão. Um webhook assinado chega ao seu endpoint com o conteúdo e o identificador da conversa.

Na coexistência há uma terceira: o eco. Quando alguém atende pelo celular, o que foi digitado ali também chega ao seu sistema — assim o histórico não se parte em dois só porque uma parte do atendimento foi manual.

Como fica no código

Na prática, uma automação é um par de rotinas no seu backend. Nenhuma das duas exige chatbot nem ferramenta visual — é HTTP comum.

• Envio — o evento do seu sistema chama POST /api/v1/channels/{id}/messages com o número do cliente e o conteúdo: texto livre se a janela de atendimento estiver aberta, template aprovado se não estiver. O formato está na referência de mensagens e o caminho completo, em enviar template.
• Recebimento — um endpoint seu recebe o webhook, confere a assinatura X-Hub-Signature-256, responde 2xx em até 10 segundos e processa o evento numa fila. Responder rápido importa: entrega sem 2xx é reenviada, e a mesma mensagem chega duas vezes se você não deduplicar. Veja receber mensagens e assinatura e retentativa.
• Status de entrega — enviado, entregue, lido e falhou também chegam por webhook (o evento message.status), não na resposta do envio. Automação que precisa saber se a mensagem foi lida (para mandar um lembrete, por exemplo) escuta esses eventos.
• Sem backend próprio — o mesmo par funciona num orquestrador. O guia de n8n monta o envio e o recebimento sem escrever servidor.

O que costuma valer a pena

Em ordem aproximada de retorno por esforço. As primeiras são simples e pagam rápido; as últimas são projetos.

• Notificação transacional — pedido confirmado, código de rastreio, lembrete de consulta. Template aprovado, disparo por evento, e o cliente não precisa perguntar nada.
• Resposta imediata fora do horário — dentro da janela de atendimento, uma resposta automática que diz quando alguém vai retornar evita a conversa morrer. Desde 1º de outubro de 2026 ela conta como mensagem de serviço: gasta a franquia de 1.000 gratuitas por mês do número e, depois dela, é cobrada — vale medir quantas disparam por dia.
• Roteamento para o CRM — cada mensagem recebida vira registro no sistema de quem atende, com o número e o canal identificados.
• Recuperação de carrinho e retomada — exige template de marketing aprovado, opt-in do cliente e cuidado com frequência, porque é o tipo de disparo que mais gera bloqueio e derruba a nota do template quando exagerado.
• Atendimento conversacional — o chatbot propriamente dito. É o que mais aparece em anúncio e o que menos costuma ser o gargalo real da operação.

Onde as automações quebram

Quatro regras da Meta explicam quase toda automação que funcionou no teste e falhou em produção.

• A janela de 24 horas — passou o prazo desde a última mensagem do cliente, só sai template. Um fluxo que responde livremente no teste (onde você acabou de mandar mensagem) volta recusado no dia seguinte, com a mesma chamada e o mesmo código.
• Template precisa de aprovação — e reprovação é comum. Texto promocional demais, variável no começo da mensagem e conteúdo genérico são causas frequentes. Aprovar leva de minutos a horas, então não é algo para deixar para o dia do lançamento.
• Limite de mensagens — é o número de clientes diferentes que a empresa alcança fora da janela de atendimento em 24 horas móveis, somando todos os números do mesmo portfólio de negócios. Começa em 250 e sobe em degraus (250, 2.000, 10.000, 100.000 e ilimitado) conforme a empresa usa pelo menos metade do limite com qualidade alta. Um disparo grande em conta nova bate no teto e o restante não sai.
• Velocidade — até 80 mensagens por segundo por número (20 em coexistência). Acima disso a API devolve erro de limite, e a automação precisa de fila com nova tentativa, não de laço que dispara tudo de uma vez.

O que a API oficial não faz

Vale saber antes de desenhar o produto, porque não é limitação de fornecedor — é o que a Meta não permite:

• Ler a agenda de contatos do aparelho.
• Disparar para quem não deu consentimento. A Meta exige opt-in antes de qualquer template, e lista comprada gera o tipo de denúncia que pausa templates e pode interromper a campanha no meio.
• Automatizar os grupos que já existem no aplicativo: na coexistência, grupos não são sincronizados com a API.

E o que a Meta permite, mas o CRPRO Hub ainda não oferece: a Groups API, lançada em outubro de 2025, que cria e administra grupos pela própria API; e a importação do histórico anterior à conexão, que a Meta libera para coexistência (até seis meses de conversas, nas 24 horas seguintes à conexão). Hoje, no Hub, o histórico começa na conexão.

Perguntas frequentes