API Oficial do WhatsApp Business: o guia definitivo para 2026

1. O que é a API Oficial do WhatsApp Business

A API Oficial do WhatsApp Business (oficialmente WhatsApp Business Platform, com a infraestrutura atual chamada de Cloud API) é a única forma autorizada pela Meta de conectar sistemas externos ao WhatsApp para fins de atendimento profissional, automações, chatbots, disparos e integrações com CRM, ERP ou plataformas de suporte.

Ela é diferente, em essência, do WhatsApp comum e do WhatsApp Business que você instala no celular. Esses dois últimos são aplicativos de uso pessoal/microempresarial, com interface gráfica, presos a um único dispositivo principal e com limites duros de automação. A API Oficial, por outro lado, é uma interface programática hospedada nos servidores da Meta — não há aplicativo, não há QR Code, não há sessão de navegador. Sua plataforma de atendimento se comunica direto com o backbone do WhatsApp via requisições HTTPS autenticadas.

A AtendeSEG, como Parceiro Oficial Meta (BSP — Business Solution Provider), é uma das empresas autorizadas a provisionar essa API para clientes finais. Isso significa que cuidamos de todo o processo de habilitação, verificação, registro de Display Name, aprovação de templates, integração e suporte contínuo.

2. Por que ter API Oficial é obrigatório quando você usa uma plataforma

Essa é a pergunta que mais aparece. A resposta curta é: porque qualquer plataforma de atendimento que conecta ao WhatsApp por meios não oficiais (QR Code, scraping, apps modificados) viola os Termos de Serviço da Meta — e isso sempre foi assim. O que mudou em 2026 não foi a regra; foi a capacidade da Meta de detectar e punir violações em escala industrial.

O argumento técnico

Quando você instala o WhatsApp ou o WhatsApp Business no celular e usa diretamente, está dentro do ecossistema oficial da Meta. Toda mensagem trafega por servidores que ela controla, audita e regula. Suspensões só acontecem por violações graves de conteúdo (spam, ilegalidade, denúncias múltiplas).

Quando você conecta uma plataforma externa via QR Code, sua plataforma se comporta como um "WhatsApp Web simulado" — ou seja, automatiza um navegador para emular um humano usando o WhatsApp Web. A Meta nunca autorizou isso. Sempre foi tolerado por limitação técnica de detecção, mas oficialmente proibido.

O argumento contratual

Os WhatsApp Business Solution Terms e a WhatsApp Business Policy proíbem expressamente "desenvolver ou utilizar aplicações que interajam com nossos Serviços Empresariais sem nosso consentimento prévio por escrito" e "criar softwares ou APIs que funcionem substancialmente da mesma forma que nossos Serviços Empresariais". Fonte 3

Em linguagem direta: toda conexão de plataforma via QR Code sempre foi uma violação dos termos. O usuário que assume essa conexão assume também o risco.

O argumento prático (2026)

Em 2026, a Meta passou a usar detecção comportamental por inteligência artificial em larga escala. Algoritmos analisam padrões de uso (cadência, horários, fingerprint de sessão, rota de rede, latências) e identificam quando um número está conectado a uma plataforma não oficial. O resultado são suspensões automáticas — 6h, 24h, 72h, 7 dias, e em casos persistentes, banimento permanente.

3. Como funciona a API Oficial por dentro

Para entender custos e limites, você precisa entender como a API enxerga o mundo. Ela não trabalha com "mensagens individuais" do ponto de vista de cobrança — trabalha com conversas. E uma conversa tem uma vida útil bem definida.

A unidade básica: conversa

Uma conversa é uma janela de 24 horas iniciada por um evento qualificador. Dentro dela, você pode trocar quantas mensagens quiser com aquele contato sem custo adicional pela conversa. A Meta cobra (quando cobra) por conversa iniciada, não por mensagem trocada.

Quem fala primeiro define quem paga

Esta é a regra de ouro de toda a economia da API:

Cloud API: zero infra para você

Desde julho de 2025, a Meta descontinuou completamente a antiga On-Premise API (que exigia que você hospedasse servidores). Hoje só existe a Cloud API, hospedada e gerenciada pela própria Meta. Isso significa: zero servidor para você manter, atualizações automáticas, infraestrutura redundante e SLA próximo de 99,9%. Fonte 1

Sua plataforma de atendimento (a AtendeSEG, no nosso caso) faz requisições HTTP autenticadas para os endpoints da Cloud API e recebe webhooks quando há mensagens novas, mudanças de status, atualizações de template, etc. Tudo em tempo real, com latência típica abaixo de um segundo.

4. As janelas: 24 horas, 72 horas e a "Customer Service Window"

Existem três tipos de janelas que você precisa conhecer. Elas determinam o que pode ser enviado livremente e o que precisa de template pago.

Janela de Atendimento ao Cliente (Customer Service Window) — 24 horas

É aberta toda vez que o cliente envia uma mensagem para você. Dura 24 horas a partir da última mensagem dele. Dentro dessa janela, você pode enviar qualquer tipo de mensagem em formato livre — texto, áudio, mídia, documento — sem necessidade de template, sem custo de conversa.

Detalhe importante: a janela reseta a cada nova mensagem do cliente. Se ele te manda algo às 10h de segunda e responde às 9h de terça, a janela vai até 9h de quarta.

Free Entry Point (FEP) — 72 horas

Quando um cliente clica num anúncio Click-to-WhatsApp no Facebook ou Instagram (CTWA — Click to WhatsApp Ads) e inicia conversa com você, abre uma janela especial de 72 horas totalmente gratuita. Dentro dela, qualquer mensagem é grátis — inclusive templates de marketing, utilidade e autenticação. Fonte 5

Essa é uma das jogadas mais subestimadas da API Oficial: se você roda anúncios pagos no Facebook ou Instagram com CTA para WhatsApp, todo o atendimento desse lead nas primeiras 72h é gratuito, mesmo que você dispare templates dentro desse período.

Conversas iniciadas pela empresa (Business-Initiated)

Se passou da janela de 24h ou se você quer iniciar uma conversa com um cliente sem que ele tenha falado primeiro, é obrigatório enviar um template aprovado. O envio dessa mensagem inicia uma nova conversa de 24h e é cobrado conforme a categoria do template.

5. As 4 categorias de mensagem

Toda mensagem na API se enquadra em uma de quatro categorias, e a categoria determina regras de aprovação, conteúdo permitido e tarifa. Misturar categorias (ex.: enviar marketing com template aprovado como utilidade) é uma das principais causas de perda de qualidade da conta.

*Valores aproximados em Real, convertidos a partir das tarifas oficiais publicadas pela Meta para o mercado brasileiro em 2026 (USD). A Meta começa a publicar tarifas oficiais em BRL a partir de junho de 2026 e a cobrança em Real entra em vigor a partir de julho de 2026, eliminando a exposição cambial. Volumes altos de Utilidade e Autenticação recebem descontos progressivos automáticos. Fonte 1

6. Templates: o que são, como funcionam e como são aprovados

Um template (também chamado HSM — Highly Structured Message) é uma mensagem pré-formatada e pré-aprovada pela Meta que você pode enviar para iniciar conversas ou para entregar mensagens dentro/fora da janela de 24h. Cada template é cadastrado uma vez, aprovado pela Meta e fica disponível para uso ilimitado depois.

As três categorias de template

Como funciona a aprovação

Você submete o template via plataforma (a AtendeSEG faz isso pra você) e a Meta aprova ou rejeita em geral em poucos minutos a 24 horas. A análise é automatizada com revisão humana em casos limítrofes. Critérios:

• Categoria correta: a Meta hoje pode recategorizar automaticamente seu template se ele estiver na categoria errada (ex.: você submete como Utilidade um conteúdo claramente de Marketing — ela aprova como Marketing e cobra a tarifa correta). Fonte 4
• Sem conteúdo abusivo: spam, conteúdo enganoso, promessas exageradas, link de phishing, ofensas — tudo rejeitado.
• Variáveis bem definidas: placeholders ({{1}}, {{2}}) precisam fazer sentido no contexto.
• Idioma e localidade: cada template é cadastrado em um idioma específico. Se você atende em PT e EN, são dois templates.
• Política da indústria: setores regulados (saúde, financeiro, seguros) têm critérios extras — a AtendeSEG orienta você nisso.

Anatomia de um template completo

Um template pode ter, a depender da categoria:

• Header: texto curto, imagem, vídeo, documento ou localização.
• Body: o texto principal, com variáveis dinâmicas {{1}}, {{2}}, etc.
• Footer: texto opcional embaixo, geralmente um disclaimer.
• Botões: até 10 botões. Podem ser de URL, telefone, resposta rápida (Quick Reply), copy code (autenticação) ou flow (formulários estruturados).

7. Tiers de mensagens: como você escala de 250 a ilimitado

A Meta limita quantas conversas únicas iniciadas pela empresa por dia sua conta pode ter. Esse limite cresce automaticamente com base em qualidade e uso. Não é um limite de quanto você fala com cada cliente — é quantos clientes diferentes você inicia conversa por dia.

A regra dos 50% (como subir de tier)

Para passar de um tier para o próximo, sua conta precisa atender duas condições simultâneas:

1. Manter qualidade alta (verde) ou média (amarela) Quality rating não pode estar em vermelho. Veja o próximo capítulo.
2. Usar pelo menos 50% do limite atual em 7 dias consecutivos Para subir de Tier 1 (1.000) para Tier 2 (10.000), por exemplo, é preciso enviar conversas iniciadas para 500+ contatos únicos numa janela de 7 dias.

Se as duas condições são satisfeitas, a Meta promove sua conta automaticamente — geralmente em até 24h após bater o critério. Não há solicitação manual. Fonte 2

8. Quality Rating: o termômetro da sua conta

A cada conta da API a Meta atribui um Quality Rating, calculado com base no comportamento dos seus contatos nos últimos 7 dias. Ele mede principalmente: bloqueios recebidos, denúncias por spam, taxa de leitura, taxa de resposta e velocidade de resposta. Fonte 2

O que afeta seu Quality Rating

9. O selo verde (Official Business Account)

O selo verde — também chamado de green check ou tecnicamente Official Business Account (OBA) — é a verificação oficial da Meta de que aquele número pertence a uma empresa de fato real e notória. Ele aparece ao lado do nome da empresa no perfil e nas conversas, e funciona como um sinal forte de credibilidade. Fonte 6

Importante: o selo não é automático e não é dado a toda empresa. A Meta concede apenas para empresas que comprovem notabilidade. O selo é cosmético — sua API funciona perfeitamente sem ele — mas para certos segmentos faz diferença em conversão.

Pré-requisitos para solicitar o selo

1. WABA com mais de 30 dias Sua WhatsApp Business Account precisa estar ativa há pelo menos 30 dias.
2. Display Name aprovado O nome exibido precisa estar em conformidade com as diretrizes da Meta e bater com sua marca.
3. Business Verification completa Verificação da empresa no Meta Business Manager — documentos da empresa validados.
4. Autenticação em duas etapas habilitada (2FA) No número e na conta Meta Business.
5. Conta no Tier 1 ou superior Já com volume mínimo demonstrado.
6. Notabilidade comprovada De 3 a 5 artigos em mídia orgânica relevante (Google News indexa) — entrevistas, citações, reportagens. Press releases pagos e advertorial não contam.

Solicitação só pode ser feita por um BSP autorizado. Se rejeitada, há um período de 30 dias para reaplicar. Fonte 6

10. Checklist completo de pré-requisitos para ter API Oficial

Antes de iniciar, junte tudo isso. Quanto mais limpo for o ponto de partida, mais rápida a aprovação:

Pré-requisitos da empresa

• CNPJ ativo e regular: sem pendências cadastrais. MEI também é aceito.
• Comprovante de endereço comercial: mesmo que coincida com o residencial no caso de MEI.
• Site institucional ou página de redes sociais ativa: a Meta verifica presença digital. E-mail corporativo ajuda.
• Documento do responsável legal: CPF, RG ou CNH do administrador da conta.
• Atividade compatível com a Política de Comércio do WhatsApp: setores como cassino, drogas ilegais, armas e alguns produtos restritos não podem operar via API. Seguros, saúde, educação, comércio, serviços e financeiros são todos permitidos com regras específicas.

Pré-requisitos técnicos

• Número de telefone disponível: fixo, VoIP ou celular. Pode ser um número novo ou a migração de um existente — desde que esteja "limpo" no momento da migração (sem WhatsApp ativo em outro lugar). Migração de número usado por anos e com histórico é totalmente possível e recomendada.
• Acesso ao SMS ou ligação naquele número: a Meta envia código de verificação durante o setup.
• Conta no Meta Business Manager (Facebook Business): nós podemos ajudar a criar se você não tiver. É gratuita.
• 2FA habilitada na conta Meta Business desde o início.

Pré-requisitos comportamentais (os mais ignorados)

• Lista de contatos com opt-in claro: não pode disparar para listas compradas ou clientes sem autorização. Isso destrói qualidade rapidamente.
• Política de privacidade pública: com cláusula explícita sobre uso de WhatsApp para comunicação.
• Mecanismo de opt-out: seus templates de marketing precisam permitir que o cliente pare de receber mensagens.
• Conformidade com LGPD: tratamento de dados pessoais documentado, base legal definida, encarregado mapeado.

11. Custos detalhados (Brasil 2026)

O custo total de operar com API Oficial tem dois componentes: (1) as tarifas da Meta por conversa e (2) a mensalidade da plataforma de atendimento (no nosso caso, AtendeSEG).

Tarifas da Meta — por conversa, não por mensagem

Descontos progressivos por volume

Para Utility e Authentication, a Meta aplica descontos automáticos por volume mensal: as primeiras 1.000 conversas têm tarifa cheia, as 1.001 a 10.000 têm tarifa menor, e a partir de 10.000 há novos cortes. Marketing também tem descontos progressivos a partir de volumes elevados.

Custo da plataforma

A AtendeSEG cobra uma mensalidade fixa pela plataforma (multi-atendimento, automações, relatórios, integrações) — independente das tarifas da Meta. O cálculo da mensalidade considera número de atendentes, volume e recursos contratados. Faça o diagnóstico gratuito para receber a proposta exata.

12. Calculadora real de custos da API

Use os campos abaixo para simular quanto sua operação pagaria por mês somente em tarifas da Meta. Os valores se atualizam ao vivo conforme você ajusta. Use os atalhos para carregar perfis típicos.

13. Simulações realistas de 4 perfis

Para você ter um chão antes de simular o seu próprio caso, abaixo estão quatro operações reais que rodam na AtendeSEG hoje, com estrutura de mensagens detalhada.

Perfil 1 — Clínica de saúde (médio porte)

• 1.500 conversas / mês iniciadas pelo cliente (agendamentos, dúvidas, retornos)
• 500 templates Utility de confirmação, sendo 300 enviados dentro da janela já aberta (gratuitos) e 200 iniciados (pagos)
• 0 marketing, 0 authentication
• Custo Meta estimado: ~R$ 7,00/mês

Perfil 2 — Corretora de seguros

• 2.000 conversas / mês iniciadas pelo cliente
• 800 templates Utility: lembretes de vencimento, renovação, confirmação de sinistro (400 dentro de janela, 400 iniciados)
• 500 templates Marketing: campanhas mensais de cross-sell e upgrade
• Custo Meta estimado: ~R$ 179/mês

Perfil 3 — E-commerce

• 3.000 conversas / mês iniciadas pelo cliente (suporte, dúvidas)
• 2.500 conversas CTWA (campanhas pagas no Instagram/Facebook — gratuitas por 72h)
• 1.500 templates Utility: confirmação de pedido, código de rastreio, entrega
• 2.000 templates Marketing: abandoned cart, lançamentos, promoções
• Custo Meta estimado: ~R$ 712/mês

Perfil 4 — Microempresa / autônomo

• 300 conversas / mês iniciadas pelo cliente
• 100 templates Utility de confirmação de horário (todos dentro de janela aberta)
• 0 marketing, 0 authentication
• Custo Meta estimado: R$ 0,00 a R$ 3,50/mês

Como você percebe, na esmagadora maioria das operações de atendimento (clínicas, corretoras, prestadores, comércio), as tarifas da Meta ficam na casa de poucas dezenas de reais por mês. Os custos relevantes só aparecem quando há campanhas de marketing massivas — e mesmo aí, o ROI costuma ser amplamente positivo.

14. Vantagens reais (e mensuráveis) da API Oficial

15. As limitações honestas — o que a API NÃO faz

Para você decidir com olhos abertos, aqui estão as principais limitações reais. Algumas são técnicas, outras são por desenho.

• Sem chamadas de voz/vídeo via API: a API Oficial é só texto e mídia. Chamadas continuam só no app (e podem ser feitas por uma versão "coexistência" do mesmo número, em modelos mais novos).
• Sem status/recados: a feature "Status" do WhatsApp pessoal não está disponível pela API.
• Sem grupos como participante automático: a API não entra em grupos. Comunidades e grupos seguem sendo gerenciados pelo app.
• Templates Marketing precisam de opt-in claro: não basta "ter o número do cliente". Sem consentimento explícito documentado, a qualidade despenca rapidamente.
• Janela de 24h é rígida: passou? Só template. Sem exceção.
• Variáveis de template têm limites: em Authentication, máx. 15 caracteres por variável. Em outras categorias, há limites de tamanho do corpo total.
• Aprovação de novos templates leva tempo: embora geralmente rápido (minutos a 24h), em casos limítrofes pode demorar dias. Planeje campanhas com antecedência.
• Limites por tier no início: nos primeiros dias, sua conta pode iniciar até 250 conversas/24h. Se você precisa disparar para 5 mil contatos no dia 1, vai bater no teto. Subir a tier exige tempo e qualidade.
• Conteúdo restrito: certos setores e produtos não podem operar via API (ver Política de Comércio do WhatsApp). Para os permitidos, há regras adicionais (saúde, finanças, seguros).
• Custo cresce com Marketing pesado: se sua estratégia depende fortemente de disparos massivos para listas frias, a conta vai ser sentida — ainda que tipicamente compensada por conversão muito acima de SMS ou e-mail.

16. Como manter uma operação saudável e duradoura

Ter API Oficial protege você de banimentos por uso de plataforma. Mas banimento por mau uso ainda existe — e atinge contas oficiais que abusam. Aqui está o checklist da AtendeSEG para manter qualidade verde de forma sustentável:

1. Opt-in genuíno antes de qualquer template proativo Cliente precisa ter dito "sim, pode falar comigo no WhatsApp". Cadastros de site com checkbox marcado por padrão não são opt-in válido. O ideal é opt-in duplo (formulário + confirmação).
2. Categorize templates honestamente Marketing como Marketing, Utility como Utility. Tentar mascarar uma campanha como utilitária para pagar menos resulta em recategorização automática, queda de qualidade e perda de confiança da Meta.
3. Mantenha sua lista limpa Numero inválido, número que mudou de dono, número que bloqueou — tira da lista. Ferramentas de validação prévia ajudam a economizar dinheiro e proteger qualidade.
4. Frequência razoável Marketing no WhatsApp não é e-mail. 1 mensagem por semana por contato já é muito. Acima disso, taxa de bloqueio dispara.
5. Personalize de verdade Use nome, contexto, histórico do cliente. Mensagens "olá amigo" sem variável geram bloqueio em massa.
6. Ofereça opt-out fácil Toda campanha Marketing precisa de "responda SAIR para parar de receber". Honrar esse opt-out instantaneamente é obrigação técnica e jurídica (LGPD).
7. Responda rápido em janelas abertas Cliente te chamou e você demora 6 horas? Ele pode reabrir, achar que o número não está ativo e bloquear. Velocidade de resposta entra no Quality Rating.
8. Monitore quality rating semanalmente A AtendeSEG entrega esse relatório direto na plataforma. Verde — siga. Amarelo — investigue. Vermelho — pare e refaça antes de continuar campanhas.
9. Mantenha 2FA e segurança da conta Acesso indevido à sua conta Meta Business pode comprometer não só a API mas a marca toda. 2FA + senhas únicas + revisão de admins a cada trimestre.
10. Acompanhe atualizações da Meta Categorias mudam, regras de aprovação mudam, política se atualiza. Como BSP, a AtendeSEG repassa essas mudanças com antecedência para você adequar antes que afete a operação.

17. Perguntas frequentes