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

A API oficial do WhatsApp, a Cloud API da Meta, cobra por mensagem de modelo entregue, e não por mensalidade da Meta. Respostas em texto livre dentro da janela de 24 horas são gratuitas.

Atualizado em 6 min de leitura

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
Nesta página

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.

janela de atendimento (24 h)texto livremodelo de utilidadegrátisjanela fechada:só modelos pagostexto livremarketingutilidadeautenticaçãoo cliente escreve24 h: a janela fecha
Dentro da janela que o cliente abre, texto livre e utilidade são grátis; depois dela, só sai modelo, e todo modelo é cobrado.

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:

  1. 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.
  2. 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.

js
// 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

Saiba mais

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.

Próximo artigoErro de intents no bot do Discord: o que são e como ativarO erro de intents no bot do Discord (código 4014) acontece quando o código pede um intent privilegiado desligado no portal. Veja como ativar e corrigir.