API oficial do WhatsApp: o que é, para quem serve e quanto custa

Carlos Eduardo

Última atualização: 9 nov 2026 · 13 min de leitura

API oficial do WhatsApp: o que é, para quem serve e quanto custa

Temas:Inteligência artificial PDF e documentos Segurança e privacidade

Última atualização: 9 de novembro de 2026.

A API oficial do WhatsApp é a porta de entrada da Plataforma do WhatsApp Business: APIs de nível empresarial, com a API de Nuvem à frente, que ligam os sistemas da empresa ao WhatsApp para atender em volume. A Meta cobra por mensagem entregue, conforme a categoria e o DDI do número de destino. Para destinatários +55, a tabela em reais vigente desde 1º de outubro de 2026 mantém R$ 0,3217 para marketing e cobra R$ 0,035 em utilidade, autenticação e serviço, com 1.000 mensagens de serviço grátis por mês em cada número. O começo fica em Painel de Apps da Meta > Criar app, ou com um parceiro de tecnologia.

A API oficial do WhatsApp sem jargão de programador

Uma tomada que a Meta deixa disponível para outros programas: essa é a imagem mais próxima do que a API faz. O app WhatsApp Business é aberto no celular, tem tela, botões e menus; a API oficial do WhatsApp não tem nada disso. Quem a usa é um sistema: o software de atendimento, a loja virtual, um agente de inteligência artificial ou outro programa que precise mandar e receber mensagens de forma automática.

Na visão geral da plataforma, a Meta lista três peças: a API de Nuvem, a API de Mensagens de Marketing para o WhatsApp e a API de Gerenciamento Empresarial. Na documentação, o roteiro de introdução é justamente o da API de Nuvem, e ele é voltado a desenvolvedores que criam na plataforma.

Portanto, a API não é um aplicativo para baixar; é uma ligação entre sistemas, configurada uma vez e usada todos os dias pelo software da empresa. Também convém tirar da cabeça a ideia de licença para mandar mensagem a qualquer pessoa: as regras de adesão, de modelos aprovados e da janela de 24 horas valem do primeiro ao último envio, e elas aparecem mais adiante, nos próximos tópicos.

App Business ou API: o volume decide

Se a empresa atende pelo celular, com conversas que alguém da equipe responde uma a uma, o app gratuito voltado a pequenas empresas costuma resolver. Ele já vem com mensagem de saudação, mensagem de ausência e respostas rápidas, além de um catálogo de produtos com carrinho para o cliente montar o pedido dentro da conversa.

A Plataforma do WhatsApp Business mira outro porte: médias e grandes empresas, com muitas conversas acontecendo ao mesmo tempo. Dá para acessá-la diretamente ou contratar um provedor que cuide da integração. Na prática, alguns sinais indicam que a API oficial do WhatsApp começou a fazer sentido:

Avisos disparados pelo sistema: confirmações e atualizações ligadas a uma transação, que saem sem ninguém digitar.
Códigos de verificação: a categoria de autenticação existe justamente para confirmar a identidade do cliente.
Atendimento por equipe ou por IA: respostas dadas por pessoas ou por uma solução de inteligência artificial ligada à conta.
Volume alto de envios: campanhas e notificações que um celular não acompanha.

Nenhum desses sinais obriga a largar o app de vez: como o tópico sobre coexistência mostra, o mesmo número pode funcionar nos dois lados.

Como a Meta cobra cada mensagem

Desde 1º de julho de 2025, o modelo atual cobra por mensagem, por categoria e por mercado, e somente pelo que a empresa manda ao usuário. O que o cliente escreve para a empresa não entra na conta. Além disso, a fatura considera só a mensagem entregue: um envio que não chegou ao aparelho não é cobrado. O mercado, por sua vez, é definido pelo código telefônico do país de quem recebe.

Categorias de mensagem

Marketing: mensagens de modelo com objetivo promocional.
Utilidade: mensagens de modelo com objetivo informativo ou de transação.
Autenticação: modelos de mensagem para verificação de identidade.
Serviço: qualquer mensagem sem modelo que não venha da plataforma do Meta Business Agent, escrita por atendentes ou por uma solução de IA de terceiros.
Meta Business Agent: mensagens sem modelo produzidas pela plataforma de agentes da própria Meta.

A janela de 24 horas

Quando o cliente manda uma mensagem, abre-se uma janela de atendimento de 24 horas, e cada nova mensagem dele reinicia esse relógio. Dentro dela, a empresa pode responder com texto livre, sem modelo. Fora dela, só os modelos de mensagem podem ser entregues, e eles valem a qualquer momento. Por isso, quem deixa o cliente esperando por mais de um dia precisa recorrer a um modelo aprovado para retomar a conversa.

Mensagens que não entram na fatura

Quem atende bastante pelo chat sente logo o efeito da cota: cada número de telefone comercial recebe 1.000 mensagens de serviço gratuitas por mês. O saldo não acumula: o que sobrar some na virada do mês, e a cobrança começa na 1.001ª mensagem de serviço daquele número. Existe ainda a janela de ponto de entrada gratuito, aberta quando o cliente chega por um anúncio de clique para o WhatsApp, que pode durar até 7 dias. Mesmo nela, as mensagens do Meta Business Agent continuam sendo cobradas.

Há ainda ajustes finos. Utilidade e autenticação são as únicas categorias com níveis de volume. Já em marketing, a API de Nuvem segue as tarifas publicadas, enquanto a API de Mensagens de Marketing permite um recurso de preço máximo, com valor que pode variar por mensagem.

Preço por mensagem no Brasil, em reais

Na conta brasileira, o peso maior vem do marketing, cobrado a cada envio entregue. A tabela em reais vigente desde 1º de outubro de 2026 mantém R$ 0,3217 para marketing no Brasil, o mesmo valor que aparece na tarifa de marketing das transmissões comerciais, calculada sobre a tabela de julho de 2026. As demais categorias custam bem menos:

Categoria	Quem inicia e quando a empresa pode enviar	Tarifa por mensagem entregue (Brasil, BRL)
Marketing	A empresa, com modelo aprovado, a qualquer momento	R$ 0,3217
Utilidade	A empresa, com modelo aprovado, a qualquer momento	R$ 0,035
Autenticação	A empresa, com modelo aprovado, a qualquer momento	R$ 0,035
Serviço	O cliente abre a conversa; a empresa responde sem modelo dentro da janela de 24 horas	R$ 0,035 (as primeiras 1.000 do mês são grátis por número)
Meta Business Agent	O cliente abre a conversa; o agente da Meta responde sem modelo	US$ 2,00 por 1 milhão de tokens
Mensagem do cliente	O cliente, quando quiser	Não cobrada

Com esses valores, montamos algumas contas simples. Mil mensagens de marketing entregues a números brasileiros somam R$ 321,70, enquanto mil mensagens de utilidade custam R$ 35,00. No serviço, uma empresa que respondeu 3.000 mensagens no mês paga só pelas 2.000 que passaram da cota gratuita: R$ 70,00 naquele número.

Agora, um mês misturado, só com destinatários brasileiros: uma loja que manda 500 mensagens de marketing (R$ 160,85), 2.000 avisos de utilidade (R$ 70,00) e responde 1.800 mensagens de serviço, das quais 800 passam da cota (R$ 28,00), paga R$ 258,85 à Meta naquele número. Volumes muito altos de utilidade podem cair nos níveis de volume, cujas faixas ficaram fora desta conta.

No Meta Business Agent, a lógica muda para tokens: a taxa global é de US$ 2,00 por milhão, e uma mensagem costuma consumir entre 20.000 e 25.000 tokens. Pela estimativa da Meta, isso dá de 4 a 5 centavos de dólar por mensagem, sem cota gratuita.

Afinal, essa tabela vai mudar? A Meta só atualiza preços no 1º dia de cada trimestre, ou seja, em 1º de janeiro, 1º de abril, 1º de julho ou 1º de outubro, com aviso mínimo de um mês para a planilha de tarifas. A moeda da conta, escolhida entre 16 opções na criação da conta de mensagens, não pode ser trocada depois; vale anotar numa planilhinha qual foi a escolhida.

Primeiros passos no Painel de Apps da Meta

Mesmo sem programar, dá para entender o roteiro oficial, ainda que a execução fique nas mãos de um desenvolvedor ou de um parceiro. Os pré-requisitos são uma conta do Facebook ou uma conta Meta gerenciada, a inscrição como desenvolvedor e um aparelho com WhatsApp para enviar e receber as mensagens de teste. Com isso em mãos, a sequência é esta:

Primeiro, no Painel de Apps da Meta, clique em Criar app, informe nome e email, escolha o caso de uso Conectar-se com clientes pelo WhatsApp e selecione um portfólio empresarial existente ou crie um novo.
Em seguida, abra Começar a usar a API e conecte o app a uma conta de mensagens, existente ou nova, pela opção Criar uma conta do WhatsApp Business. Guarde a identificação dessa conta.
Depois, use Gerar token de acesso para obter um token temporário, preencha o número De e o número Para e clique em Enviar mensagem.
Por fim, configure um ponto de extremidade de webhook, que é por onde o seu sistema recebe estados como entregue e lida.

Quem não é desenvolvedor encontra na própria visão geral da plataforma um atalho: as apresentações de parceiros, onde a Meta indica empresas que fazem a integração. Dessa maneira, a escolha passa a ser de fornecedor, e não de código. Peça a proposta por escrito e confira se ela separa a tarifa da Meta de qualquer valor cobrado pelo próprio parceiro.

Mesmo número no celular e na API

Para quem já atende pelo app, a coexistência evita trocar de número. Por essa integração de usuários do app, o cliente empresarial passa a enviar altos volumes de mensagens pelo sistema e continua conversando de forma individual pelo app WhatsApp Business, com o histórico sincronizado entre os dois.

Versão do app: 2.24.17 ou posterior.
Quem faz a integração: um Parceiro de Soluções ou Provedor de Tecnologia.
Velocidade: números usados no app e na API de Nuvem ao mesmo tempo ficam com taxa de transferência fixa de 20 mensagens por segundo.
Custo: a conversa um a um feita pelo app continua gratuita; o que sai pela API de Nuvem segue a tabela da API.

Porém, a janela de 24 horas só abre quando o cliente escreve para uma empresa que já concluiu a integração à API de Nuvem. Uma mensagem recebida antes da integração, portanto, não abre a janela pela API.

Regras de envio que valem para qualquer empresa

Quem pode receber uma mensagem da empresa pela API? Só quem deu o número e a permissão para ser contatado. A política deixa a empresa como única responsável por definir o método de adesão e por cumprir as leis aplicáveis às suas comunicações. Na rotina, isso vira quatro cuidados:

Adesão registrada: guarde quando e como cada cliente aceitou receber mensagens.
Saída respeitada: pedidos para bloquear, parar ou deixar de receber, feitos dentro ou fora do WhatsApp, precisam ser atendidos.
Modelos aprovados: só eles podem iniciar conversas, e o WhatsApp pode analisar, aprovar, pausar ou recusar modelos a qualquer momento.
Caminho até uma pessoa: a automação é permitida na janela de 24 horas, desde que exista uma rota clara para atendente humano, telefone, email, suporte na web, loja física ou formulário.

Então, a lista de contatos de qualquer campanha precisa nascer de clientes que pediram para receber mensagens, e o texto precisa estar num modelo já aprovado no momento do envio.

Promessas de atalho que ficam fora da plataforma

Ferramentas de disparo em massa que funcionam lendo um QR code, versões modificadas do WhatsApp e listas de números compradas circulam com a promessa de economizar a tarifa. Nenhuma delas aparece na documentação oficial da plataforma, e listas compradas batem de frente com a exigência de adesão. A responsabilidade pela adesão, de todo modo, continua sendo da própria empresa.

Se o objetivo é só avisar clientes que já salvaram o número da empresa numa lista de transmissão com até 256 contatos, o próprio app atende sem API. Para volume, integração com sistemas e relatórios de entrega, o caminho legítimo é a API oficial do WhatsApp, pelo painel da Meta ou por um parceiro indicado por ela.

Perguntas frequentes

O que muda no custo quando é o cliente quem escreve primeiro?

Mensagens recebidas nunca geram cobrança. A resposta livre enviada nas 24 horas seguintes cai em serviço, salvo quando quem responde é o Meta Business Agent, cobrado por tokens. Cada linha comercial tem mil respostas de serviço por mês sem pagar nada; da milésima primeira em diante, para destinatários +55 o valor é de três centavos e meio de real por resposta.

A Meta cobra mensalidade para usar a API?

A página oficial de preços traz apenas valores por mensagem entregue e, no agente da Meta, por tokens consumidos. Nenhuma assinatura mensal consta ali. Se a empresa contratar um parceiro de tecnologia, o que ele eventualmente cobrar fica fora dessa planilha e precisa ser negociado à parte.

Posso mandar promoção para quem nunca falou com a minha empresa?

Somente com permissão prévia dessa pessoa e usando um modelo de marketing aprovado. Sem esse consentimento, o envio vai contra as regras empresariais do WhatsApp, por mais que o sistema tecnicamente consiga entregá-lo.

Enviar para um número de Portugal sai pela tarifa brasileira?

O DDI de quem recebe é o que escolhe a linha da planilha. Um contato com +351 é cobrado pela tarifa do mercado ao qual esse código pertence, ainda que a empresa seja daqui; os valores em reais desta página valem para destinatários +55.

Ainda consigo responder pelo celular depois de ligar a API?

Com a coexistência configurada por um parceiro de integração e o app Business atualizado, o atendimento individual pelo celular continua, e as conversas aparecem nos dois ambientes. Responder pelo aplicativo, conversa por conversa, segue sem custo.

Fontes