Automação de WhatsApp pela API oficial

Automatizar WhatsApp pela API oficial é reagir a evento: algo acontece no seu sistema e uma mensagem sai; algo chega no WhatsApp e o seu sistema é avisado. O resto — janela de 24 horas, template, limite por número — são as regras da Meta sobre quando esse envio é permitido.

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.

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 custa nada e evita a conversa morrer.
  • 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 aprovado e cuidado com frequência, porque é o tipo de disparo que derruba a qualidade do número 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

Três 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 conversas iniciadas por dia — cada número começa com um teto e sobe conforme a qualidade se mantém. Um disparo grande em número novo bate no limite e o restante simplesmente não sai.

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 expõe:

  • Automação de grupos: entrar, ler ou enviar em grupo.
  • Leitura da agenda de contatos do aparelho.
  • Disparo em massa para lista comprada — isso derruba a qualidade e, na prática, encerra o número.
  • Ler o histórico anterior à conexão. O que veio antes fica no aplicativo.
No CRPRO Hub, o que sustenta essas automações é o básico bem feito: chave de API escopada por organização, webhook assinado com HMAC, log por número e conexão por coexistência. Veja a primeira requisição, como conectar um número ou quanto custa.

Perguntas frequentes

O que dá para automatizar no WhatsApp com a API oficial?

Envio de mensagem a partir de um evento do seu sistema, resposta automática dentro da janela de atendimento, encaminhamento do que chega para um CRM ou atendente, e disparo de notificação transacional por template aprovado. O que não dá é automatizar grupos, ler contatos do aparelho ou disparar mensagem em massa para quem não pediu.

O que é a janela de 24 horas?

É o período em que sua empresa pode responder livremente depois que o cliente manda uma mensagem. Dentro dela, texto, mídia e botão saem sem template e sem custo por mensagem. Fora dela, só é possível iniciar conversa com uma mensagem de template previamente aprovada pela Meta.

Automação de WhatsApp pode banir o número?

Na API oficial não existe banimento por usar automação — existe classificação de qualidade. Se muitas pessoas bloquearem ou denunciarem o número, a qualidade cai e a Meta reduz quantas conversas ele pode iniciar por dia. O risco de banimento é característico das integrações não oficiais, que operam contra os termos de uso.

Preciso de um chatbot para automatizar o WhatsApp?

Não. Boa parte das automações que geram receita é mais simples que um chatbot: confirmar um pedido, avisar de uma entrega, lembrar de um agendamento. Isso é um webhook e uma chamada de envio — não exige árvore de conversa nem modelo de linguagem.