Neste artigo
- API do WhatsApp em 2026: como usar a oficial e quanto custa por mensagem
- API oficial do WhatsApp: o que você precisa para começar
- O que mudou no preço em julho de 2025
- Limites de envio por tier
- Por que não usar bibliotecas não oficiais
- Casos de uso que fazem sentido para devs
- Como começar em 5 passos
- A Cloud API da Meta é grátis para hospedar?
- Posso usar meu número pessoal do WhatsApp na API?
- O que acontece se eu mandar mensagem fora da janela de 24 horas?
- Dá para receber mensagem de graça?
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:
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
- Crie a conta de desenvolvedor da Meta e um app no painel.
- Adicione e verifique um número de telefone dedicado.
- 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.
- 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.