<\> Casa do Dev
Notícias abrir
Ferramentas abrir
Vagas abrir
Aprender abrir
Comunidade abrir
Guia de Compras abrir

API do WhatsApp em 2026: como usar a oficial e quanto custa por mensagem

DA

5 min

Entusiasta das Tecnologias

API do WhatsApp em 2026: como usar a oficial e quanto custa por mensagem

A plataforma se chama WhatsApp Business Platform e tem duas pontas: a Cloud API, hospedada pela própria Meta de graça para o desenvolvedor, e os provedores BSP, que adicionam painel e fila. Para começar um projeto pequeno, a Cloud API pura resolve.

Neste artigo

API do WhatsApp em 2026: como usar a oficial e quanto custa por mensagem

Muita gente pergunta nos fóruns de dev se dá para mandar mensagem pelo WhatsApp no próprio sistema. Dá, mas só direito pela API oficial da Meta em 2026, porque as bibliotecas não oficiais que imitam o WhatsApp Web colocam o número em risco de banimento.

A plataforma se chama WhatsApp Business Platform e tem duas pontas: a Cloud API, hospedada pela própria Meta de graça para o desenvolvedor, e os provedores BSP, que adicionam painel e fila. Para começar um projeto pequeno, a Cloud API pura resolve.

API oficial do WhatsApp: o que você precisa para começar

Segundo a documentação oficial da Cloud API, o fluxo básico em 2026 é este: criar uma conta de desenvolvedor da Meta, registrar um número de telefone que não esteja em uso no app pessoal, verificar esse número por SMS ou ligação, e criar um app dentro do painel para obter o token de acesso.

Depois disso as mensagens entram e saem por requisições HTTPS com webhooks para receber respostas, e a documentação de início rápido cobre o primeiro envio em minutos.

A Cloud API não cobra hospedagem: você paga apenas as mensagens da tabela da Meta. O limite padrão de envio é de cerca de 80 mensagens por segundo por número, suficiente para a maioria dos casos de uso.

O que mudou no preço em julho de 2025

Até junho de 2025 a cobrança era por conversa de 24 horas, em qualquer categoria. Desde 1º de julho de 2025, os templates de marketing, utilitário e autenticação passaram a ser cobrados por mensagem entregue, um a um, segundo a página oficial de preços. Isso muda a conta de bots que mandam várias mensagens na mesma conversa.

As conversas de atendimento continuam com a regra da janela de 24 horas: a primeira mensagem iniciada pelo cliente abre a janela e as respostas dentro dela não geram cobrança extra de conversa, e há um limite de 1.000 conversas de serviço gratuitas por mês por número.

Os valores por mensagem variam por país e por categoria e mudam com o tempo, então a fonte certa é sempre a tabela por país na documentação oficial, não valor fixo de blog.

Limites de envio por tier

O número começa no tier baixo e sobe conforme a qualidade das entregas. Os limites são de conversas iniciadas pela empresa por dia, por número de telefone:

TierConversas iniciadas por dia
Inicial250
Tier 11.000
Tier 210.000
Tier 3100.000
Ilimitadosem teto

Subir de tier exige manter taxa de entrega alta e baixa taxa de bloqueio. O detalhe está na documentação de tiers e limites.

Por que não usar bibliotecas não oficiais

Bibliotecas como Baileys e similares conectam no protocolo do WhatsApp Web, que é feito para o navegador, não para servidores. A Meta considera isso abuso da plataforma, e o número usado assim pode ser banido em definitivo, com perda de todas as conversas.

Para produção, use sempre a API oficial; para testes locais, prefira o número sandbox de teste que a própria documentação oferece.

Casos de uso que fazem sentido para devs

  • Confirmação de pedido e alerta de entrega: template utilitário, barato e dentro da janela do cliente.
  • Recuperação de carrinho abandonado: template de marketing, que exige opt-in prévio do número.
  • Código de login em dois fatores: template de autenticação, com rota de entrega alternativa por SMS.
  • Atendimento com atendente humano: conversa de serviço dentro da janela de 24 horas.
  • Notificações de sistema para o próprio time: melhor mandar por e-mail ou push, porque o WhatsApp cobra e o usuário bloqueia fácil.

Como começar em 5 passos

  1. Crie a conta de desenvolvedor da Meta e um app no painel.
  2. Adicione e verifique um número de telefone dedicado.
  3. Gere o token temporário e teste com o número de teste antes de production.

4.

Configure o webhook para receber mensagens e eventos de entrega.

  1. Publique o app para produção e acompanhe os tiers e a qualidade no painel.

Para complementar o estudo de APIs e integrações, veja o roadmap de backend para a primeira vaga e publique o projeto no passo a passo de subir projeto no GitHub.

Estude mais no catálogo de cursos do portal e confira as vagas no catálogo de vagas.

Perguntas frequentes

A Cloud API da Meta é grátis para hospedar?

Sim. A Meta hospeda a Cloud API sem custo de servidor para o desenvolvedor; você paga somente as mensagens enviadas conforme a tabela de preços por categoria e país. Quem cobra mensalidade é provedor BSP, que é opcional.

Posso usar meu número pessoal do WhatsApp na API?

Não. O número precisa ser dedicado e verificado na plataforma, e não pode estar ativo no app pessoal ao mesmo tempo. Usar número pessoal em automação não oficial é o caminho mais rápido para o banimento.

O que acontece se eu mandar mensagem fora da janela de 24 horas?

Fora da janela, a conversa de serviço passa a ser cobrada, e templates de marketing, utilitário e autenticação são cobrados por mensagem entregue desde julho de 2025, independentemente da janela. Consulte sempre a tabela oficial antes de estimar custo.

Dá para receber mensagem de graça?

Sim. Mensagens recebidas dos usuários e os eventos de webhook são gratuitos; a cobrança recai sobre as mensagens que a empresa envia, conforme categoria e tier. O plano de teste da documentação permite ensaiar tudo sem custo.

Produtos relacionados

Este conteúdo tem links de afiliado: se você comprar por eles, podemos receber uma comissão sem custo extra para você. A escolha dos produtos segue critérios próprios e não é influenciada por comissão.

O que você achou deste artigo?

Responda a Pergunta do Dia Teste seu conhecimento e mantenha sua streak. Crie seu Dev Card público Perfil dev compartilhável em um único link.

Depois dessa formação...

Veja vagas em tecnologia →

Vagas relacionadas

Ver todas as vagas →
DA

Escrito por

Dagmar Cirino

Entusiasta das Tecnologias

Publicado em

Sou o Cirino, e desenvolvo soluções e produtos utilizando linguagens de programação e ferramentas de analytics e monitoração baseadas em Cloud. Trabalho com tecnologia desde 2010,...

Ver perfil do autor

COMPARTILHAR