Criar conta grátis
Todos os textos

API oficial do WhatsApp: o que é, como contratar e quanto custa em 2026

A API oficial do WhatsApp é o caminho que a Meta oferece para uma empresa conversar com clientes a partir de um sistema, e não de um celular. Ela cobra por mensagem e segue regras que o app não tem. O que ela é, a diferença para o app e para a API não oficial, como chegar até ela, quanto custa, quais limites valem e o que muda entre 2026 e 2027.

Produto CCXProduto · Regras dos canais · 21 out 2026 · 12 min de leitura
Ilustração de um painel de código com uma chamada POST ligada a uma conversa de WhatsApp com o selo de conta verificada e uma etiqueta API
A API oficial do WhatsApp liga o seu sistema às conversas: a chamada sai de um lado, e a mensagem chega do outro, com o selo da conta verificada. Ilustração.

O que você leva

  • A diferença entre o app WhatsApp Business, a API oficial e a chamada API não oficial
  • O caminho até a API: portfólio, verificação, número, nome de exibição e templates
  • Como a Meta cobra, como os provedores cobram e os limites que valem para todo mundo

O que é a API oficial do WhatsApp

O nome oficial é WhatsApp Business Platform. É o conjunto de APIs da Meta para empresas que conversam com clientes em escala: enviar e receber mensagens, cuidar de templates, números e perfil, e receber por webhook tudo o que acontece com cada mensagem. Quem fala em “API do WhatsApp”, “WhatsApp Business API” ou “API oficial do WhatsApp” está falando dela.

Em 2026, essa plataforma é a Cloud API, hospedada pela própria Meta. Existia uma versão que a empresa instalava nos próprios servidores, a On-Premises API. Ela deixou de aceitar cadastros novos em julho de 2024 e parou de vez em 23 de outubro de 2025, quando a última versão expirou e os números que ainda estavam nela deixaram de enviar e receber mensagens. Hoje, API oficial do WhatsApp e Cloud API são a mesma coisa.

A API leva mensagens entre o WhatsApp e um sistema. A Meta oferece um painel para gerenciar contas, números e templates, o WhatsApp Manager, mas a conversa com o cliente acontece no software ligado à API: o seu, se você tem engenharia para construí-lo, ou o de um provedor, que entrega por cima dela o inbox da equipe, as automações e os relatórios.

A página da plataforma descreve exatamente esses dois caminhos: conectar direto, para quem tem desenvolvedores, ou entrar pelo cadastro de um parceiro da Meta. Nos dois, o acesso à Cloud API é gratuito. O que se paga são as mensagens, e, quando há provedor, o que ele cobra pelo que constrói em volta.

App WhatsApp Business ou API: o que muda

O app WhatsApp Business é gratuito e foi feito para a pequena empresa que atende pelo celular. Ele tem perfil comercial, catálogo, etiquetas, mensagem de saudação, mensagem de ausência e respostas rápidas. O número fica num celular principal, que pode ser vinculado a até quatro aparelhos, e a equipe inteira responde pelo mesmo punhado de telas.

A API troca o celular por um sistema. Não há limite de pessoas atendendo no mesmo número, porque quem atende está no software, e não num aparelho vinculado. A conversa pode ser distribuída por fila, respondida por automação ou por IA e ligada à loja, ao ERP e ao CRM. E a empresa pode iniciar a conversa com templates aprovados, como o aviso de pedido ou o código de verificação.

A regra que mais surpreende quem vem do app é a janela de atendimento. Quando o cliente escreve, abre-se uma janela de 24 horas em que a empresa responde o que quiser. Fora dela, só sai template aprovado pela Meta. No app essa regra não existe; na API, ela decide o que pode ser enviado e quanto custa.

E não é preciso escolher um dos dois. Desde 2025, a coexistência permite usar o mesmo número no app e na API ao mesmo tempo, com o app na versão 2.24.17 ou mais nova e a conexão feita pelo cadastro de um parceiro. O dono segue no celular, a equipe vai para o inbox, e o histórico das conversas vem junto, uma vez só. Escrevemos sobre os detalhes no post sobre coexistência.

Oficial e não oficial: o que é a “API não oficial”

“API não oficial do WhatsApp” é o nome comercial de um software que automatiza o WhatsApp comum ou o WhatsApp Web: você lê um QR code, e um servidor passa a enviar e receber mensagens como se fosse o seu celular. É vendida como mais barata, sem template e sem a cobrança da Meta. Não é uma API do WhatsApp; é o app sendo usado por um robô.

Os Termos de Serviço do WhatsApp proíbem exatamente isso. Na seção sobre danos ao WhatsApp e aos usuários, vedam acessar ou usar o serviço por meios automatizados sem autorização. Na seção de uso aceitável, vedam envio em massa, mensagens automáticas e uso não pessoal sem autorização. E o WhatsApp pode suspender ou desativar a conta a qualquer momento. Na prática, o risco é o banimento do número que os seus clientes conhecem.

Há também o que a automação do app não faz. Não há template, então não há como falar com quem não escreveu nas últimas horas sem parecer spam. Não há confirmação de entrega confiável, a sessão cai quando o celular desconecta, e as conversas dos seus clientes passam por um servidor que não tem compromisso nenhum com a LGPD. O barato está em não ter nenhuma das garantias da plataforma oficial.

Como ter acesso à API, passo a passo

O primeiro passo é um portfólio empresarial na Meta, o antigo Business Manager. É nele que ficam a conta do WhatsApp, os números e a forma de pagamento. Quem vai conectar direto também precisa de uma conta de desenvolvedor e de um app no painel da Meta; quem entra por um parceiro faz tudo no cadastro dele, o Embedded Signup, em poucos minutos e com o próprio login do Facebook.

A verificação da empresa não é obrigatória para começar, mas é o primeiro desbloqueio que importa. Com o portfólio verificado, ele pode passar de 2 para 20 números, subir o teto de templates por conta de mensagens, pedir o selo de conta oficial e sair do limite inicial de 250 pessoas por dia. A Meta confere os dados da empresa, como razão social, endereço e site, contra documentos.

O número precisa ser seu, com código de país e de área, e receber um código por SMS ou ligação. Código curto não vale. Se o número já está em uso no WhatsApp, a Meta pede para apagar a conta antes, a não ser que o caminho escolhido seja a coexistência. O nome de exibição, o que o cliente vê, é informado no cadastro e passa por verificação automática quando o limite sobe e a cada alteração.

Com o número no ar, faltam os templates: as mensagens que a empresa envia fora da janela de atendimento. Cada template é aprovado pela Meta e classificado numa categoria, marketing, utility ou authentication, e a categoria decide o preço. Por fim, o selo azul de conta oficial é opcional: exige 30 dias na plataforma, portfólio verificado, verificação em duas etapas e nome aprovado.

Quanto custa a API oficial do WhatsApp

Usar a API não tem mensalidade da Meta. O que a Meta cobra é mensagem: desde 1º de julho de 2025, cada mensagem entregue tem um preço que depende da categoria e do país de quem recebe. São três categorias de template, marketing, utility e authentication, cada uma com a sua tabela. Utility e authentication ganham desconto por faixa de volume no mês; marketing, não.

A resposta livre, que a Meta chama de mensagem de serviço, foi gratuita de novembro de 2024 a setembro de 2026. Desde 1º de outubro de 2026 ela também é cobrada, com uma franquia de 1.000 mensagens de atendimento grátis por número por mês, que não acumula. No mesmo dia, o template de utility enviado com a janela de atendimento aberta voltou a ser cobrado.

Há uma mudança de moeda em andamento no Brasil. O faturamento em real começou em 1º de julho de 2026 para quem fatura no Brasil, com a fatura emitida pelo Facebook Brasil, e todas as contas do portfólio precisam migrar até 30 de junho de 2027. A partir de 1º de julho de 2027, a Meta deixa de entregar as mensagens das contas que continuarem em outra moeda.

Em cima disso vem o modelo de cobrança do provedor, e é aí que os preços do mercado se separam. Há quem cobre mensalidade fixa, quem cobre por atendente, quem cobre por contato ativo, quem repassa a tabela da Meta em dólar e quem publica um preço por mensagem em real. Comparar só a tarifa por mensagem esconde a maior parte da conta.

A comparação justa é a conta do mês: o seu volume por categoria, o número de pessoas que vão atender, a moeda em que a fatura chega e o que é cobrado à parte, como inbox, automação e IA. Um provedor que cobra pouco por mensagem e muito por atendente pode sair mais caro para um time de atendimento grande, e o contrário vale para quem só dispara avisos.

Os limites: para quantas pessoas e com que velocidade

O limite que mais aparece é o de mensagens, e ele não conta mensagens: conta pessoas. É o número de destinatários únicos que você pode alcançar fora da janela de atendimento numa janela móvel de 24 horas. Responder a quem te escreveu não consome nada. E, desde outubro de 2025, o limite é do portfólio inteiro, dividido entre todos os números dele.

Portfólio novo começa em 250 pessoas por dia. A subida para 2.000 vem pela verificação da empresa ou por 2.000 mensagens de qualidade entregues fora da janela em 30 dias. Depois, a escada é 10.000, 100.000 e ilimitado, e ela anda sozinha, em até seis horas, quando a qualidade das mensagens é alta e o portfólio usou pelo menos metade do limite nos últimos sete dias.

A velocidade é outro teto. Cada número envia até 80 mensagens por segundo por padrão e pode subir sozinho até 1.000, desde que o portfólio esteja no limite ilimitado, o número tenha falado com 100 mil pessoas em 24 horas e a qualidade seja amarela ou melhor. Número em coexistência, usado no app e na API ao mesmo tempo, fica fixo em 20 por segundo.

A qualidade amarra os dois tetos. A Meta mede como os clientes reagem às suas mensagens, com bloqueios e denúncias pesando contra, e usa isso para liberar ou segurar a escada do limite. Template que irrita derruba a qualidade, e qualidade baixa trava o crescimento do portfólio inteiro, não só do número que disparou.

O que mudou em 2026 e o que muda em 2027

Em 23 de setembro de 2026 começou a valer o novo modelo de contas. A conta do WhatsApp Business se divide em duas: uma conta do WhatsApp, que guarda o número, e uma conta de mensagens, com os templates, a cobrança e os webhooks. Com isso, o mesmo número pode ser compartilhado com mais de um provedor, e trocar de provedor deixou de ser uma migração do número.

Em 15 de janeiro de 2026 entrou em vigor a regra da Meta para provedores de IA. Assistentes de uso geral, como os chatbots de grandes modelos de linguagem, não podem usar a plataforma quando a IA é a funcionalidade principal. No Brasil, eles são aceitos desde 11 de março de 2026, pagando por mensagem de atendimento. A IA de atendimento de uma empresa, que responde sobre os produtos e os pedidos dela, continua permitida, segundo a Meta, e a política de mensagens pede um caminho para atendimento humano.

Em 13 de outubro de 2026, a Meta anunciou o fim do marketing pela Cloud API. Contas de mensagens criadas a partir de 13 de abril de 2027 já não enviam marketing por ela, e em 13 de outubro de 2027 a Cloud API deixa de aceitar marketing. Ele passa a sair pela Marketing Messages API, e isso vale para todo provedor.

Por fim, os nomes de usuário. Em 2026 a Meta começou a liberar usernames no WhatsApp, e com eles uma pessoa pode falar com a empresa sem mostrar o telefone. Os webhooks passaram a trazer um identificador por portfólio, o BSUID, que serve para enviar mensagens desde julho de 2026. Para quem identifica o cliente pelo telefone, como quase todo CRM brasileiro, é uma mudança de modelagem que vale preparar antes.

Como escolher o provedor

A API é a mesma em todo provedor: os mesmos limites, as mesmas categorias e as mesmas regras de janela. O que muda é o que cada um constrói por cima e como cobra. Por isso as perguntas que valem a pena são sobre a operação, e não sobre a API.

Pergunte em que moeda vem a fatura e quem a emite. Pergunte se há cobrança por atendente, por contato ou por número, e se o preço por mensagem está publicado ou só sai numa proposta. Pergunte se o provedor aceita coexistência, para você não perder o app, e o que acontece com o número e com o histórico se um dia você quiser sair.

Pergunte também onde ficam as conversas, porque elas são dados pessoais dos seus clientes e a LGPD vale para elas. E, se a IA está no plano, pergunte como ela passa a conversa para uma pessoa, o que ela pode fazer sozinha e o que precisa de aprovação. Um provedor que responde a essas perguntas por escrito, antes da venda, costuma responder do mesmo jeito depois.

O checklist antes de contratar

01Portfólio e verificaçãoPortfólio empresarial na Meta com a empresa verificada. É o caminho mais curto para sair do limite de 250 pessoas por dia.
02Um número livreNúmero que recebe código por SMS ou ligação e não está no app, a não ser que a ideia seja a coexistência.
03Nome de exibiçãoO nome que o cliente vê passa por verificação da Meta e precisa ter relação com a marca.
04Templates por categoriaMarketing, utility e authentication têm preços e regras diferentes. A categoria errada custa caro.
05Janela de 24 horasResposta livre só dentro da janela. Fora dela, só template aprovado.
06A conta do mêsVolume por categoria, número de atendentes e moeda da fatura. Não compare só a tarifa por mensagem.
07Nada de API não oficialAutomatizar o app ou o WhatsApp Web viola os termos do WhatsApp e coloca o número em risco de banimento.
08Marketing em 2027Marketing sai da Cloud API entre abril e outubro de 2027. Pergunte ao provedor como ele vai migrar.
Ver como a API oficial do WhatsApp funciona na CCX

Quer ver isso funcionando no seu número?

Criando a conta pelo site, você ganha R$ 10 de crédito de teste.