API oficial do WhatsApp Business: implantação técnica e regras da Meta explicadas

De acordo com a documentação oficial da Meta para desenvolvedores, desde 1º de julho de 2025 a plataforma cobra por mensagem, e o modelo antigo baseado em conversas foi descontinuado. Os pontos principais:

• Modelos de mensagem (templates) são classificados em marketing, utilidade ou autenticação, e é sobre eles que incide a cobrança.
• Mensagens que não são modelos, como texto e imagem enviados em resposta, são gratuitas, mas só podem ser enviadas dentro da janela de atendimento de 24 horas, aberta quando o cliente manda mensagem.
• Modelos de utilidade enviados dentro de uma janela de atendimento aberta são gratuitos.
• Mensagens recebidas do cliente não são cobradas.
• Janela de 72 horas: quando o cliente chega por um anúncio de clique para WhatsApp ou pelo botão da Página do Facebook e a empresa responde em até 24 horas, todas as mensagens ficam gratuitas por 72 horas, inclusive modelos.
• O valor varia conforme a categoria, o país do número de destino e faixas de volume. Utilidade e autenticação têm faixas de volume mensais.

Os valores por país mudam periodicamente, por isso não publicamos tabela aqui. Consulte sempre a página oficial de preços da Meta antes de planejar o orçamento. Se você usa um parceiro de soluções, ele pode cobrar taxas próprias além das da Meta.

A Política de Mensagens do WhatsApp Business estabelece, entre outros pontos:

• Permissão prévia: a empresa só pode iniciar contato com quem deu opt-in para receber mensagens dela. A recomendação é que as pessoas esperem as mensagens que recebem, com permissões separadas por tipo de mensagem.
• Respeito à saída: pedidos para bloquear ou parar de receber mensagens devem ser respeitados, com instruções claras de como sair.
• Caminho para humano: ao usar automação no atendimento, a empresa precisa oferecer formas rápidas e claras de falar com uma pessoa ou outro canal de suporte.
• Setores restritos: há produtos e serviços proibidos ou regulados, como armas, drogas, jogos de azar com dinheiro real e alguns serviços financeiros.

A política é atualizada pela Meta. Antes de qualquer campanha, revisamos a versão vigente.

1. Classificar mal os modelos: promoção disfarçada de utilidade pode ser reclassificada pela Meta como marketing, o que muda o custo.
2. Disparar para listas compradas: sem opt-in, além de violar a política, gera bloqueios e derruba a qualidade do número.
3. Esquecer a janela de 24 horas: tentar mandar mensagem livre fora da janela resulta em erro.
4. Automação sem saída humana: além de frustrar o cliente, contraria a política.
5. Não acompanhar custos: sem relatório, a conta de mensagens cresce sem controle.

• Envio direto pela plataforma da Meta ou por parceiro de soluções.
• Quantidade de integrações e sistemas envolvidos.
• Número de modelos e fluxos de mensagem.
• Uso de automação ou IA nas respostas. Para isso, veja atendimento com IA no WhatsApp e integração de CRM com WhatsApp.
• Volume de mensagens, que define o custo pago à Meta.

O valor do projeto depende do escopo; o custo das mensagens é pago à Meta (ou ao parceiro) conforme a tabela oficial.

A implantação da API oficial tem etapas que dependem da Meta e etapas que dependem da sua empresa. Conhecer a ordem evita retrabalho e atraso.

1. Portfólio empresarial na Meta: a empresa precisa de uma conta no gerenciador de negócios, com dados corretos e, quando solicitado, verificação.
2. Escolha do provedor: acesso direto pela Cloud API da Meta ou por um provedor de soluções (BSP) que oferece painel, suporte e recursos extras.
3. Número de telefone: um número que receba SMS ou ligação para verificação. Se ele já está em uso no aplicativo, é preciso planejar a migração.
4. Perfil e nome de exibição: nome, foto, descrição e site, seguindo as regras de nome de exibição da Meta.
5. Webhooks: um endereço seguro (HTTPS) que recebe mensagens e status de entrega. É aqui que o seu sistema ou o n8n passa a escutar o WhatsApp.
6. Modelos de mensagem: criação e envio para aprovação dos templates de marketing, utilidade e autenticação.
7. Testes: envio para números internos, conferência de status, falhas e respostas.
8. Produção gradual: começar com volume pequeno ajuda a construir boa reputação do número.

A documentação de primeiros passos da Meta detalha a parte técnica. Para conectar a API ao funil de vendas, veja integração de CRM com WhatsApp.

Não existe resposta universal. Em projetos com n8n e CRM próprio, a Cloud API direta costuma dar mais controle. Em operações de atendimento com muitos agentes e pouca equipe técnica, um BSP pode acelerar. Em ambos os casos, garanta que a conta da Meta fique registrada em nome da sua empresa.

Perguntas para decidir

• Sua equipe ou parceiro consegue manter integrações por API?
• Quantos atendentes vão usar o número ao mesmo tempo?
• Você precisa de painel pronto já na primeira semana?
• Qual o custo total em 12 meses somando mensalidade, mensagens e manutenção?

Modelos (templates) são a única forma de iniciar conversa fora da janela de 24 horas. A Meta revisa cada um e define a categoria, o que afeta a cobrança. Seguir as diretrizes de categorização reduz reprovações e reclassificações.

Boas práticas

• Utilidade é sobre algo que o cliente já fez: confirmação de pedido, atualização de entrega, lembrete de consulta agendada. Se houver oferta no texto, a tendência é virar marketing.
• Variáveis com contexto: evite modelos que são só uma variável. Texto fixo explicando o motivo da mensagem ajuda na aprovação.
• Identifique a empresa: o cliente precisa entender quem está falando logo na primeira linha.
• Ofereça saída: em mensagens de marketing, deixe claro como parar de receber.
• Botões com ação clara: "Ver pedido", "Remarcar", "Falar com atendente".
• Português correto e sem exageros: letras maiúsculas em excesso e promessas agressivas prejudicam a experiência e a qualidade do número.

Exemplo ilustrativo de utilidade

"Olá, {{1}}. Seu pedido {{2}} foi enviado e deve chegar até {{3}}. Para acompanhar, toque em Ver pedido."

Cada número na API tem uma classificação de qualidade baseada no retorno dos clientes, como bloqueios e denúncias. Ela influencia quantos contatos únicos a empresa consegue alcançar com modelos em um período.

• Qualidade alta: mensagens esperadas, com opt-in, relevantes e na frequência certa.
• Qualidade em queda: sinal de que o público não reconhece a empresa ou está recebendo mensagens demais.
• Consequência: limites de envio menores e, em casos graves, restrições ao número.

Como proteger a qualidade

1. Envie só para quem deu consentimento, registrado com data e origem.
2. Segmente: mensagem certa para o grupo certo.
3. Comece campanhas com lotes pequenos e acompanhe bloqueios.
4. Responda rápido quando o cliente responde, de preferência dentro da janela de atendimento.
5. Remova imediatamente quem pede para sair.

A Política de Mensagens do WhatsApp Business é o documento de referência sobre consentimento e conteúdo permitido.

Um ponto de economia que muita empresa ignora:

"Utility templates delivered within an open customer service window are free." (Meta for Developers, Pricing on the WhatsApp Business Platform)

Ou seja, modelos de utilidade enviados enquanto a janela de atendimento está aberta não são cobrados. Também segundo a Meta, conversas iniciadas por anúncios que clicam para o WhatsApp abrem uma janela de ponto de entrada gratuito de 72 horas. Desenhar os fluxos levando isso em conta reduz custo sem reduzir qualidade. Consulte sempre a página oficial de preços, porque a Meta atualiza regras e valores.

Glossário

• Cloud API: versão da API hospedada pela própria Meta, acessada pela internet.
• BSP: provedor de soluções empresariais autorizado pela Meta a oferecer acesso à API com serviços adicionais.
• Portfólio empresarial: a conta da empresa na Meta, onde ficam números, ativos e permissões.
• WABA: a conta do WhatsApp Business dentro do portfólio, à qual os números ficam ligados.
• Template (modelo): mensagem pré-aprovada pela Meta, usada para iniciar conversas.
• Janela de atendimento: período de 24 horas após a última mensagem do cliente, em que a empresa responde livremente.
• Ponto de entrada gratuito: janela de 72 horas aberta por anúncios de clique para o WhatsApp ou botão da página, conforme regras da Meta.
• Webhook: endereço que recebe, em tempo real, mensagens e status de entrega.
• Opt-in: o consentimento do cliente para receber mensagens da empresa.

Checklist antes de ligar em produção

• Portfólio empresarial em nome da empresa, com administradores definidos.
• Número verificado e perfil completo (nome, foto, descrição, site).
• Webhooks em HTTPS, com validação de assinatura e registro de eventos.
• Modelos aprovados para os principais casos de uso.
• Registro de opt-in com data, origem e texto aceito.
• Processo de descadastro funcionando de ponta a ponta.
• Forma de pagamento configurada e alerta de gasto definido.
• Equipe treinada para responder dentro da janela de atendimento.
• Plano de contingência se o provedor ou o sistema integrado ficar fora do ar.

As regras completas estão nos Termos de Serviço do WhatsApp e na Política de Mensagens. Se o objetivo principal é atender clientes com IA, o caminho está em automação de WhatsApp.