Objetivos de aprendizado
Depois de ler este artigo, você vai conseguir:
- Entender o que é a API oficial do WhatsApp e o que ela exige
- Saber quais mensagens a Meta cobra e quais são gratuitas
- Estimar o custo mensal e decidir quando a API oficial 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 de modelo entregue. A página oficial de preços não lista mensalidade da plataforma, só o preço por mensagem.
Os modelos (templates) são mensagens aprovadas previamente pela Meta, e cada um pertence a uma de três categorias:
| Categoria | Para que serve | Quando é cobrada |
|---|---|---|
| Marketing | Promoções, ofertas, reengajamento | Sempre que entregue |
| Utilidade | Confirmação de pedido, status de entrega, lembrete de pagamento | Fora da janela de atendimento; dentro dela é gratuita |
| Autenticação | Códigos de verificação (OTP) | Sempre que entregue |
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.
Quais mensagens são gratuitas?#
Duas situações zeram a cobrança:
- Janela de atendimento (24 horas). Abre quando o usuário escreve para você. Enquanto ela está aberta, mensagens sem modelo e modelos de utilidade são gratuitos. Passadas as 24 horas, você só pode enviar modelos, e eles são cobrados.
- Janela de ponto de entrada gratuito (72 horas). Vale quando o usuário chega por um anúncio Click to WhatsApp ou por um botão de chamada na Página do Facebook, pelo app de celular (desktop e web não contam). Se você responde em até 24 horas, abre-se uma janela de 72 horas em que todas as mensagens, modelos incluídos, são gratuitas.
Na prática, um bot de suporte em que o cliente sempre começa a conversa custa pouco ou nada em taxas da Meta. A conta cresce 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 este artigo não crava um preço por mensagem: baixe a tabela do trimestre atual e use a conta abaixo.
O script estima o custo mensal. 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 };
// Mensagens ENTREGUES por mês que são cobradas.
// Utilidade enviada dentro da janela de 24 h é gratuita: não conte.
const volume = { marketing: 2000, utility: 1500, authentication: 800 };
let total = 0;
for (const [category, count] of Object.entries(volume)) {
const cost = count * rates[category];
console.log(`${category}: ${count} 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.230,00 (na moeda da tabela), dos quais 1.000,00 vêm de marketing. É 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.
Hospedagem de bots
Seu bot online 24/7, com reinício automático
Perguntas frequentes
A API oficial do WhatsApp é paga?
Sim, mas por uso. Desde 1º de julho de 2025 a Meta cobra cada mensagem de modelo (template) entregue, com preço por categoria e país. A página de preços da Meta não lista mensalidade da plataforma. Texto livre dentro da janela de 24 horas não é cobrado.
Quais mensagens são gratuitas na API oficial?
Mensagens sem modelo enviadas enquanto a janela de atendimento de 24 horas está aberta, e modelos de utilidade enviados dentro dessa janela. Quando o cliente chega por anúncio Click to WhatsApp ou botão da Página do Facebook e você responde em 24 horas, abre-se uma janela de 72 horas com todas as mensagens gratuitas.
Preciso de um provedor (BSP) para usar a API oficial?
Não é obrigatório. Você pode usar a Cloud API direto, com um portfólio empresarial na Meta e um número comercial. Provedores oferecem painel e suporte, com tabela própria; confira o que cobram além da Meta.
Posso usar meu número pessoal na API oficial?
Não como número pessoal. A Cloud API exige um portfólio empresarial e um número de telefone comercial, que pode ser real ou virtual.
Quanto custa uma mensagem de marketing no Brasil?
O valor pode mudar a cada trimestre, e a Meta publica a tabela em reais (CSV e PDF) na página de preços. Consulte-a antes de calcular, porque estimativas de terceiros divergem muito entre si.
Mais em Bots
Ver todos os 33 artigos- Quanto custa hospedar um bot do Discord?O custo de hospedar um bot do Discord depende de RAM, tempo online, banco de dados e serviços externos. Veja como estimar o seu e onde o gasto aparece.
- Rodar bot no celular (Termux) ou no PC vs hospedar: o que mudaUm bot no PC ou no celular (Termux) fica offline quando o aparelho desliga, dorme ou perde a rede. Compare as três opções e veja quando cada uma serve.
- Como deixar um bot do Discord online 24/7Para deixar um bot do Discord online 24/7, rode o processo numa máquina sempre ligada com reinício automático. Veja PC, VPS com pm2 ou systemd e hospedagem.
- Por que meu bot do Discord fica offline (e como resolver)Bot do Discord offline quase sempre é processo caído, token inválido, intent não habilitada ou falta de memória. Veja como diagnosticar cada causa e corrigir.