API oficial do WhatsApp: guia completo 2026 (custos, limites e como obter)

Resposta rápida (TL;DR)

A API oficial do WhatsApp Business é o canal autorizado pela Meta para empresas enviarem e receberem mensagens em escala, com número verificado e sem risco de bloqueio por uso indevido. Obter exige quatro coisas: conta de empresa no Business Manager, número que não esteja em uso no aplicativo comum, um provedor que faça a conexão e verificação da empresa. O custo tem duas camadas: o que a Meta cobra por conversa iniciada pela empresa e o que o provedor cobra de mensalidade. O limite de envio começa em 250 destinatários únicos por 24 horas para portfólio novo e sobe para 2.000, 10.000, 100.000 e ilimitado conforme verificação e qualidade. Toda mensagem enviada fora da janela de 24 horas depois da última mensagem do cliente precisa usar um modelo aprovado, classificado em uma de três categorias: marketing, utilidade ou autenticação.

O que é a API oficial e o que ela não é

A API oficial do WhatsApp Business (também chamada de WhatsApp Business Platform, ou WABA, de WhatsApp Business Account) é a interface que a Meta disponibiliza para sistemas conversarem com o WhatsApp de forma autorizada. Ela não é um aplicativo: não tem tela, não se instala no celular e não substitui a interface de atendimento. Ela é o encanamento. A tela onde o time atende vem de um CRM ou plataforma conectada por cima dela.

O que ela não é: não é o mesmo que o aplicativo WhatsApp Business, que é gratuito e roda em um aparelho. E não é a conexão por leitura de QR code que muitas plataformas oferecem, que usa o mesmo mecanismo do WhatsApp Web e opera fora do canal oficial.

Quando ela passa a ser necessária

Envio ativo. Mensagem para quem não escreveu primeiro: aviso, lembrete, campanha, cobrança, atualização de pedido.
Selo de conta verificada. O nome da empresa aparecendo no lugar do número.
Volume com estabilidade. Operação que não pode conviver com queda de sessão.
Integração programática. Sistema próprio consultando e gravando dados na conversa.
Vários números sob a mesma gestão. Portfólio com filiais, unidades ou marcas.

Se a operação apenas responde a quem chegou, com volume moderado, a conexão por QR code ainda atende. A comparação direta entre os dois caminhos está em API oficial do WhatsApp vs não oficial.

Como obter, passo a passo

Conta no Business Manager. A empresa precisa de um portfólio de negócios (Business Portfolio) na Meta, com dados cadastrais reais.
Número disponível. Um número que não esteja ativo no aplicativo WhatsApp comum nem no WhatsApp Business. Se estiver, é preciso apagar a conta daquele número antes, e o histórico do aparelho não migra.
Escolher o caminho de conexão. Ou por um provedor (a via usual, que já entrega a interface de atendimento junto) ou direto com a Meta via Cloud API, que exige equipe técnica.
Verificação da empresa. Envio de documentos que comprovem a existência da empresa. É o que destrava limites maiores e o selo.
Cadastro do número e do nome de exibição. O nome que aparece para o cliente passa por aprovação.
Criação dos primeiros modelos de mensagem. Necessários para qualquer envio fora da janela de 24 horas.

Prazo realista: de poucos dias a duas semanas, quase sempre determinado pela verificação da empresa e pela aprovação do nome de exibição, não pela parte técnica.

Quanto custa

São duas camadas somadas, e confundir as duas é a origem da maioria das surpresas na fatura.

Camada	Quem cobra	Base de cobrança
Mensagem	Meta	Por conversa ou mensagem iniciada pela empresa, com preço que varia por categoria e por país
Plataforma	Provedor ou CRM	Mensalidade, com variação por atendente, por número conectado ou por volume

Dois pontos que mudam a conta na prática:

Resposta dentro da janela de atendimento não é cobrada como envio ativo. Quando o cliente escreve, abre uma janela de 24 horas em que a empresa conversa livremente.
A categoria do modelo muda o preço. Marketing custa mais que utilidade. Classificar errado um modelo de utilidade como marketing sai caro em escala.

Os limites de envio

O limite de mensagens é o número máximo de destinatários únicos que a empresa consegue alcançar fora da janela de atendimento, em uma janela móvel de 24 horas. Conforme a documentação oficial da Meta, ele é calculado no nível do portfólio de negócios e é compartilhado por todos os números daquele portfólio.

Limite	Como se chega
250 destinatários únicos por 24h	Padrão de portfólio recém-criado
2.000	Verificando a empresa, ou tendo o provedor verificando por você, ou entregando 2.000 mensagens fora da janela para números únicos em 30 dias com modelos de alta qualidade
10.000	Escalonamento automático, mediante análise de qualidade
100.000	Escalonamento automático
Ilimitado	Escalonamento automático

Detalhe que costuma pegar operações com várias unidades: como o limite é do portfólio e não do número, um único número pode consumir toda a capacidade do grupo em um dia.

Modelos de mensagem: as três categorias

Toda mensagem enviada fora da janela de 24 horas precisa usar um modelo previamente aprovado. A categoria não é etiqueta cosmética: ela define o preço e influencia a entrega.

Marketing. A mais flexível e a mais cara. Promoção, novidade, reengajamento, retargeting.
Utilidade. Acompanhamento de uma ação ou solicitação do próprio cliente: confirmação, status de pedido, lembrete de agendamento.
Autenticação. Verificação de identidade. Só esta categoria pode enviar código de uso único.

Dois comportamentos que fazem um modelo cair em marketing mesmo sem intenção: conteúdo misto, quando uma mensagem de utilidade traz junto um trecho promocional, e conteúdo vago, quando o texto é genérico demais para ser classificado como utilidade. Ambos são regra explícita da documentação de categorização da Meta.

Qualidade, ritmo e pausa

Cada modelo carrega uma nota de qualidade calculada a partir de três sinais: uso, feedback dos usuários (denúncias e bloqueios) e engajamento, principalmente a taxa de leitura.

Nota	Significado	Ainda envia?
Verde	Alta qualidade, pouco ou nenhum feedback negativo	Sim
Amarela	Qualidade média, feedback negativo ou baixa leitura	Sim, com risco
Vermelha	Baixa qualidade, em risco de pausa	Sim, em perigo
Pendente	Sem dados suficientes ainda	Sim

Todo modelo novo nasce sem nota e vai sendo classificado com o uso. Se a nota cair de forma persistente, a Meta pode limitar o ritmo de envio (pacing) ou pausar o modelo. Modelo pausado deixa de enviar até voltar ao status aprovado.

O que protege a nota, na prática: pedir consentimento antes de enviar, segmentar em vez de disparar para a base inteira, escrever mensagem específica em vez de genérica e dar caminho fácil para o cliente parar de receber.

Como migrar do WhatsApp comum para a API oficial

Exporte antes. Contatos e conversas relevantes. O histórico do aparelho não é transferido pela Meta.
Decida o número. Migrar o número conhecido pelo mercado (mais atrito, mais valor) ou começar em um novo (mais simples, exige comunicar a mudança).
Apague a conta do número no aplicativo. O número não pode estar ativo no aplicativo comum ao ser cadastrado na API.
Cadastre e verifique. Número, nome de exibição e documentos da empresa.
Suba os modelos essenciais. Comece por utilidade e autenticação, que aprovam mais rápido e sustentam a operação.
Rode em paralelo por alguns dias. Com o time acompanhando, antes de desligar o caminho antigo.

Janela de indisponibilidade existe e costuma ser curta, mas planeje a migração fora do pico de atendimento.

Erros comuns

Achar que a API dá liberdade de disparo. Ela dá autorização, não licença. Mensagem sem consentimento derruba a nota de qualidade do mesmo jeito.
Misturar promoção em mensagem de utilidade. Reclassifica o modelo como marketing e encarece a operação inteira.
Não medir taxa de leitura. É o sinal de engajamento que mais influencia a nota.
Esquecer que o limite é do portfólio. Em operação com várias unidades, um número pode consumir a capacidade de todos.
Migrar sem exportar. O histórico do aparelho não volta depois.

Para ligar a API a um sistema de atendimento, ver como escolher um CRM para WhatsApp. Para a parte de automação, ver como automatizar o atendimento no WhatsApp.

Perguntas frequentes (FAQ)

Quanto custa a API oficial do WhatsApp?

O custo tem duas camadas somadas. A Meta cobra pelas conversas ou mensagens iniciadas pela empresa, com preço que varia conforme a categoria do modelo (marketing custa mais que utilidade) e o país. O provedor ou CRM cobra a mensalidade da plataforma, que varia por atendente, por número conectado ou por volume. Respostas dentro da janela de 24 horas aberta pelo cliente não entram na cobrança de envio ativo.

Qual o limite de mensagens da API oficial do WhatsApp?

Um portfólio de negócios recém-criado começa com limite de 250 destinatários únicos em uma janela móvel de 24 horas, considerando apenas envios fora da janela de atendimento. Esse limite sobe para 2.000 mediante verificação da empresa ou histórico de 2.000 mensagens entregues em 30 dias com modelos de alta qualidade, e depois para 10.000, 100.000 e ilimitado por escalonamento automático. O limite é do portfólio inteiro, compartilhado entre todos os números.

Como obter a API oficial do WhatsApp?

São seis passos: criar o portfólio de negócios no Business Manager da Meta, separar um número que não esteja ativo no aplicativo WhatsApp comum, escolher entre contratar um provedor ou conectar direto pela Cloud API, passar pela verificação da empresa com documentos, cadastrar o número e o nome de exibição para aprovação, e criar os primeiros modelos de mensagem. O prazo costuma ser de poucos dias a duas semanas, determinado pela verificação e não pela parte técnica.

O que são os modelos de mensagem e por que precisam de aprovação?

Modelo de mensagem é o texto pré-aprovado que a empresa usa para falar com um cliente fora da janela de 24 horas contada desde a última mensagem dele. A aprovação existe para controlar o que chega sem que a pessoa tenha iniciado a conversa. Cada modelo é classificado em marketing, utilidade ou autenticação, e essa categoria define quanto a Meta cobra por aquele envio.

Posso perder o acesso ao envio se a qualidade cair?

Sim. Cada modelo tem nota de qualidade calculada por uso, feedback negativo dos usuários e engajamento, com peso grande para taxa de leitura. Nota persistentemente baixa leva a Meta a reduzir o ritmo de envio ou pausar o modelo, e modelo pausado não envia até voltar ao status aprovado. As práticas que protegem a nota são consentimento prévio, segmentação, mensagem específica e saída fácil para quem não quer receber.

Continue lendo

Histórico de revisões

2026-07-27 · v1.0 · publicação inicial.

Sobre as marcas mencionadas

Este portal cita marcas de terceiros para fins editoriais e comparativos. Todas as marcas são propriedade de seus respectivos donos e não possuem vínculo formal com este site. Os dados apresentados foram coletados de fontes públicas e podem mudar. Em caso de erro factual, escreva para contato@botaihub.com.br.