API oficial do WhatsApp: o que é, quanto custa e quando vale a pena

A API oficial do WhatsApp é a interface que a Meta mantém para empresas enviarem e receberem mensagens a partir de código. O nome técnico é WhatsApp Business Platform, e o jeito mais comum de usá-la é a Cloud API, hospedada pela própria Meta.

O preço não sai de uma tabela única: depende da categoria da mensagem, do país do destinatário e de quem abriu a conversa. A Meta pode alterar preços e regras a cada trimestre, então confira a página oficial antes de calcular.

O que é a API oficial do WhatsApp e o que ela exige?#

É a forma autorizada de automatizar o WhatsApp para negócios. Você não pareia um celular nem escaneia QR code: chama a Graph API da Meta com um token para enviar, e recebe mensagens e status de entrega por webhook (uma URL pública com HTTPS válido).

Os requisitos, segundo a documentação da Cloud API:

• um portfólio empresarial na Meta;
• um número de telefone comercial, real ou virtual;
• um servidor seu para receber os webhooks.

Ao começar, a Meta cria uma conta e um número de teste, que enviam modelos sem pedir forma de pagamento. Em produção, cada número tem um limite padrão de mensagens por segundo e um ritmo máximo de envio para o mesmo usuário; os valores atuais estão na documentação da Cloud API. Para comparar com as bibliotecas não oficiais, veja Baileys, whatsapp-web.js ou API oficial.

O que a Meta cobra?#

Desde 1º de julho de 2025, a cobrança é por mensagem entregue. A página oficial de preços não lista mensalidade da plataforma, e a Meta não cobra pelas mensagens que o usuário envia para você.

Cada mensagem que a empresa envia cai em uma categoria. Três delas são modelos (templates), mensagens aprovadas previamente pela Meta que podem sair a qualquer momento; a quarta é a resposta livre, sem modelo:

O valor depende da categoria e do código de país do destinatário. Utilidade e autenticação têm faixas de volume: quanto mais você envia, menor o preço. Marketing não tem. As respostas do Meta Business Agent, o agente de IA da própria Meta, formam uma categoria à parte, cobrada por tokens.

Quais mensagens são gratuitas?#

A janela de atendimento de 24 horas abre quando o usuário escreve para você, e cada nova mensagem dele reinicia o relógio. Com ela aberta, você pode responder com texto livre; fechada, só com modelos. Ela define o que você pode enviar, mas desde outubro de 2026 não zera mais a conta sozinha.

Duas situações ainda saem de graça:

1. Faixa gratuita de serviço. Cada número comercial tem 1.000 mensagens de serviço gratuitas por mês. A sobra não acumula, e a cobrança começa na 1.001ª.
2. Janela de ponto de entrada gratuito. Quando o usuário chega por um anúncio Click to WhatsApp, pelo app de celular Android ou iOS (desktop e web não contam), e você responde dentro da janela de atendimento, essa resposta não é cobrada e abre uma janela que pode durar até 7 dias. Enquanto ela está aberta, mensagens de marketing, utilidade, autenticação e serviço são gratuitas.

Na prática, um bot de suporte pequeno, em que o cliente sempre começa a conversa, pode caber inteiro na faixa gratuita. A conta cresce quando as respostas passam de 1.000 no mês ou quando é a empresa que inicia o contato.

Como estimar o custo mensal?#

A Meta publica a tabela de preços em reais (BRL), em CSV e PDF, na página de preços. Ela só altera preços em 1º de janeiro, abril, julho ou outubro, com pelo menos um mês de aviso. Por isso nenhum preço por mensagem aparece aqui: baixe a tabela do trimestre atual e use a conta abaixo.

O script estima o custo mensal de um número. Preencha rates com os valores da tabela oficial; os do exemplo são fictícios, só para a conta rodar.

// node estimate.js
// ATENÇÃO: taxas fictícias. Troque pelos valores da tabela oficial da Meta (BRL).
const rates = { marketing: 0.5, utility: 0.1, authentication: 0.1, service: 0.05 };

// Mensagens ENTREGUES por mês em um número comercial.
// Não conte as enviadas na janela de ponto de entrada gratuito.
const volume = { marketing: 2000, utility: 1500, authentication: 800, service: 3000 };
const FREE_SERVICE = 1000; // mensagens de serviço gratuitas por mês, por número

let total = 0;
for (const [category, count] of Object.entries(volume)) {
  const billed = category === "service" ? Math.max(0, count - FREE_SERVICE) : count;
  const cost = billed * rates[category];
  console.log(`${category}: ${billed} x R$ ${rates[category].toFixed(2)} = R$ ${cost.toFixed(2)}`);
  total += cost;
}
console.log(`Total estimado: R$ ${total.toFixed(2)} por mês`);

Com esses números fictícios, o total seria 1.330,00 (na moeda da tabela). Marketing responde por 1.000,00; as 3.000 respostas de serviço custam só 100,00, porque as primeiras 1.000 saem de graça. É isso que a conta mostra: marketing costuma dominar o total, então reduzir disparos promocionais pesa mais no custo do que qualquer outro ajuste. E só entra na conta a mensagem entregue.

Que custos escondidos existem?#

• Provedor (BSP). Você não é obrigado a usar um, mas muitos oferecem painel, caixa de entrada e suporte. Confira se cobram mensalidade ou margem sobre o preço da Meta e peça a tabela completa antes de contratar.
• Servidor. O webhook precisa de uma aplicação sempre no ar. É um custo pequeno, mas existe.
• Moeda. Desde 1º de julho de 2026, a Meta oferece a localização de cobrança do Brasil: clientes elegíveis podem criar contas em BRL, faturadas pela Facebook Brasil. Contas elegíveis que ainda faturam em outra moeda têm um prazo para migrar. Confira na página de preços se o seu caso é elegível e qual é o prazo.
• Aprovação de modelos. Modelo rejeitado atrasa campanhas; o custo é o tempo da sua equipe.

Quando a API oficial vale a pena?#

Vale quando o número é de um negócio que não pode ficar fora do ar: atendimento, vendas, notificações de pedido, códigos de verificação. O custo por mensagem é previsível, e você evita o risco de banimento do número que vem com os clientes não oficiais.

Não compensa quando o projeto é pessoal, de estudo, ou precisa rodar em um número que não pode virar comercial. Nesses casos, as bibliotecas não oficiais custam só o servidor, mas trazem o risco de ban e de quebras sem aviso. A decisão de fundo está no comparativo Baileys, whatsapp-web.js ou API oficial, e a implementação passo a passo em como fazer um bot de WhatsApp.

Em disparos em massa, a conta de marketing pesa e a qualidade dos modelos importa. Se o bot precisa ficar online o tempo todo, veja também como hospedar um bot de WhatsApp 24/7.

Como fazer isso na Square Cloud#

Fora as taxas da Meta, o que resta é hospedar o servidor que recebe o webhook. A Square Cloud é hospedagem self-service: você faz o deploy e controla memória, variáveis e reinícios no painel. Ela suporta a Cloud API oficial, além de Baileys, WPPConnect e whatsapp-web.js. A Meta continua cobrando as mensagens; a hospedagem é um custo à parte.

Para o webhook, a aplicação web ganha um subdomínio squareweb.app com HTTPS, que pode servir de URL de callback. Os containers ficam sempre ligados, sem modo de suspensão, com reinício automático (ligado por padrão no deploy pelo painel) quando o processo encerra com erro.

Todos os planos são pagos e cobrados em reais. O Hobby custa R$ 12,49 por mês, com 1 GB de RAM compartilhado entre as suas aplicações (mínimo de 512 MB por aplicação web). Você faz o deploy por ZIP, CLI, GitHub ou extensão do VS Code. Os detalhes estão na página de hospedagem de bots de WhatsApp.