API do WhatsApp: 40 perguntas e respostas

Atualizado em 28/10/2026

Esta página reúne as 40 perguntas mais comuns sobre a API oficial do WhatsApp, com respostas curtas e diretas, agrupadas por tema: acesso, preço, templates, limites, coexistência, parte técnica e conta. Cada resposta se sustenta sozinha e aponta para o artigo que aprofunda o assunto. Os valores e regras foram conferidos na documentação oficial da Meta em 28/10/2026.

Acesso

1. O que é a API oficial do WhatsApp?

É a WhatsApp Business Platform da Meta, usada hoje por meio da Cloud API: uma API HTTP hospedada pela Meta que permite enviar e receber mensagens a partir do seu sistema, com eventos entregues por webhook. É o único caminho que a Meta autoriza para automatizar o WhatsApp de uma empresa. Veja o guia completo da API oficial do WhatsApp.

2. API do WhatsApp e app WhatsApp Business são a mesma coisa?

Não. O app WhatsApp Business é um aplicativo gratuito, operado manualmente no celular, sem endpoint nem webhook. A API (WhatsApp Business Platform, Cloud API) é para sistemas: integração com CRM, chatbot, notificações e vários atendentes. Os nomes estão explicados em WhatsApp Business API, Business Platform e Cloud API.

3. Como conseguir acesso à API do WhatsApp?

Você precisa de um portfólio empresarial na Meta, de um número registrado na Cloud API, de uma conta de mensagens com forma de pagamento e de um app com permissão para usar esses ativos. Dá para fazer direto pelo painel de desenvolvedores da Meta ou pelo Cadastro Incorporado de um provedor. O passo a passo está em como conseguir acesso à API do WhatsApp.

4. Posso criar minha própria API do WhatsApp?

Sim, desde que ela seja uma camada do seu sistema sobre a Cloud API oficial: app na Meta, token de usuário do sistema, webhook e número registrado. Criar um canal próprio por engenharia reversa do aplicativo viola os Termos de Serviço. Detalhes em posso criar minha própria API do WhatsApp?.

5. É melhor contratar direto da Meta ou por um provedor?

Direto, você não paga taxa de acesso, mas mantém app, tokens, webhook e usa os canais de suporte da Meta para desenvolvedores. O provedor cobra pela camada dele e oferece suporte, painel e, em muitos casos, coexistência. A comparação completa está em direto da Meta ou por um provedor.

6. Usar API não oficial (Baileys, WPPConnect) dá banimento?

Pode dar. Essas bibliotecas emulam o WhatsApp Web, e os Termos de Serviço do WhatsApp proíbem acesso automatizado não autorizado, por isso os números ficam sujeitos a banimento sem aviso. A comparação está em API oficial x API não oficial, e a migração em como migrar para a API oficial.

Preço

7. A API do WhatsApp é gratuita?

O acesso é gratuito, mas as mensagens não. A Meta cobra por mensagem entregue, conforme a categoria e o país do destinatário. Há exceções, como a franquia mensal de mensagens de serviço e a janela de ponto de entrada gratuito de anúncios. Veja o que é de graça na API do WhatsApp.

8. Como a Meta cobra pelas mensagens?

Por mensagem entregue, com preço definido pela categoria (marketing, utilidade, autenticação, serviço ou Meta Business Agent) e pelo país do destinatário. A Meta só altera preços no primeiro dia de um trimestre: 1º de janeiro, abril, julho ou outubro. A explicação completa está em quanto custa a API do WhatsApp no Brasil.

9. Quanto custa uma mensagem para o Brasil?

Desde 1º/10/2026, para destinatários no Brasil: marketing custa R$ 0,3217; utilidade, autenticação e serviço custam R$ 0,0350 por mensagem. Os valores são da tabela da Meta, sem impostos e sem a taxa de eventuais intermediários. Detalhes em preço da API do WhatsApp no Brasil.

10. Mensagens de serviço são cobradas?

Desde 1º/10/2026, cada número tem uma franquia de 1.000 mensagens de serviço entregues por mês; a partir da 1.001ª, elas são cobradas. A franquia não acumula de um mês para o outro e não cobre templates de utilidade. Sem forma de pagamento, a Meta para de entregar mensagens de serviço quando a franquia acaba.

11. Template de utilidade dentro da janela de atendimento é grátis?

Não mais. Desde 1º/10/2026, templates de utilidade enviados dentro da janela de atendimento passaram a ser cobrados. Eles continuam gratuitos dentro da janela de ponto de entrada gratuito. O que mudou está em mensagens de utilidade na janela de atendimento.

12. O que é a janela de ponto de entrada gratuito?

É uma janela aberta quando o cliente chega por um anúncio de clique para o WhatsApp (em Android ou iOS) e a empresa responde dentro da janela de atendimento. Ela pode ficar aberta por até 7 dias, e nesse período a Meta não cobra mensagens de marketing, utilidade, autenticação ou serviço. Veja como medir esses anúncios em rastrear anúncios Click-to-WhatsApp.

13. O preço muda conforme o país do cliente?

Sim. O preço é definido pelo código de país do destinatário, não pelo país da empresa. Uma mensagem de marketing para um número do México tem tarifa diferente de uma para o Brasil. As tabelas estão em preço da API do WhatsApp por país.

Quer testar enquanto lê? Crie sua conta na Vectalk e envie a primeira mensagem pela API oficial. Criar conta grátis →

Templates

14. O que é um template?

É um modelo de mensagem aprovado pela Meta, obrigatório para iniciar conversa ou falar com o cliente fora da janela de 24 horas. Ele tem categoria, idioma, texto com variáveis e, opcionalmente, cabeçalho, rodapé e botões. Veja templates da API do WhatsApp.

15. Quais são as categorias de template?

Marketing, utilidade e autenticação. Utilidade cobre mensagens ligadas a uma transação ou conta do cliente; autenticação, códigos de verificação; o resto é marketing. A categoria define o preço, e a Meta pode reclassificar o template. Veja como a Meta classifica seu template.

16. Quanto tempo a Meta leva para aprovar um template?

A análise é automática e, segundo a documentação, pode levar até 24 horas. Templates editados passam por nova análise. Para evitar idas e vindas, veja os motivos comuns de reprovação.

17. Quantos templates posso ter?

Portfólios não verificados podem ter até 250 templates por conta de mensagens. Portfólios verificados, com nome de exibição aprovado em pelo menos um número, chegam a 6.000. Também há limite de 100 templates criados por hora em cada conta. Modelos prontos por setor estão em 60 modelos de template de WhatsApp.

18. Posso usar a API para cobrar dívidas?

Cobrança de dívida de terceiros é proibida pela Política de Mensagens Comerciais. Já o lembrete de fatura do próprio cliente, como boleto ou mensalidade a vencer, é utilidade. Veja régua de cobrança pelo WhatsApp sem ser bloqueado.

19. A Cloud API vai deixar de enviar marketing?

Sim. A Meta anunciou que a Cloud API deixa de suportar mensagens de marketing em 13 de outubro de 2027, e contas de mensagens criadas a partir de 13 de abril de 2027 já não poderão enviar marketing por ela. O caminho é a Marketing Messages API; utilidade, autenticação e serviço continuam na Cloud API. Veja como migrar os disparos de marketing.

Limites

20. O que é a janela de 24 horas?

É o período aberto a cada mensagem do cliente. Dentro dele, a empresa pode responder com qualquer tipo de mensagem (texto, mídia, botões). Fora dele, só templates aprovados. Cada nova mensagem do cliente reinicia o prazo. Veja janela de 24 horas do WhatsApp.

21. Qual é o limite de mensagens da API?

Portfólios novos começam com 250 destinatários únicos por 24 horas fora da janela de atendimento. Os níveis seguintes são 2.000, 10.000, 100.000 e ilimitado. O limite é do portfólio e vale para todos os números dele. Detalhes em limites de mensagens da API do WhatsApp.

22. Como aumentar o limite de mensagens?

Para chegar a 2.000, verifique a empresa ou envie 2.000 mensagens entregues fora da janela, para números únicos, em 30 dias, com templates de boa qualidade. Acima disso, o aumento é automático: é preciso manter qualidade e usar pelo menos metade do limite atual nos últimos 7 dias. Veja o planejamento em Black Friday no WhatsApp.

23. Quantas mensagens por segundo a API envia?

Até 80 mensagens por segundo por número, por padrão, com ampliações de capacidade disponíveis. Números em coexistência com o app ficam fixos em 20 mensagens por segundo. Passar desse ritmo gera o erro 130429; enviar rápido demais para o mesmo destinatário gera o 131056. Veja throughput e rate limit.

24. Por que meu template de marketing não foi entregue?

Uma causa comum é o limite de marketing por usuário: a Meta limita quantos templates de marketing uma mesma pessoa recebe de empresas em um período, e o envio falha com o erro 131049. O ajuste está em limite de marketing por usuário.

25. Meu número pode ser bloqueado na API oficial?

O uso da API não causa bloqueio, mas a política sim: denúncias, bloqueios de usuários e envio sem consentimento derrubam a qualidade e podem levar a restrições. A Política de Mensagens Comerciais exige opt-in e respeito a pedidos de descadastro. Veja número bloqueado na API do WhatsApp.

Coexistência

26. O que é coexistência?

É usar o mesmo número no app WhatsApp Business e na Cloud API ao mesmo tempo: a equipe continua no celular e o sistema responde pela API. A Meta documenta o onboarding pelo Cadastro Incorporado, feito por parceiros. Veja coexistência no WhatsApp.

27. O que deixa de funcionar com a coexistência?

Segundo a Meta, conversas em grupo não são sincronizadas, listas de transmissão ficam só para leitura, mensagens temporárias e de visualização única são desativadas nas conversas individuais e os aparelhos vinculados são desconectados no onboarding. O detalhamento está em o que sincroniza e o que não.

28. Posso usar na API um número que já está no WhatsApp?

Se o número está no app WhatsApp Business, dá para conectá-lo por coexistência. Se está no WhatsApp comum, é preciso excluir a conta do app antes de registrar o número na Cloud API. Veja como liberar um número que já está no WhatsApp.

Parte técnica

29. Como enviar uma mensagem pela API?

Com um POST para /{phone_number_id}/messages na Graph API, com token no cabeçalho Authorization e corpo JSON com messaging_product: "whatsapp", destinatário, tipo e conteúdo. Fora da janela, o tipo precisa ser template. Exemplos em cURL, Node.js e Python estão em como enviar mensagem pela API.

30. Como recebo as mensagens dos clientes?

Por webhook: você cadastra uma URL HTTPS, responde ao desafio de verificação e assina os campos da conta (como messages). A Meta envia um POST com JSON para cada mensagem recebida e cada mudança de status. Veja webhook da API do WhatsApp.

31. Como garantir que o webhook veio da Meta?

Validando o cabeçalho X-Hub-Signature-256, que traz um HMAC SHA-256 do corpo da requisição gerado com o segredo do app. Compare com o HMAC calculado sobre o corpo bruto, antes de qualquer parse. O passo a passo com código está em validar a assinatura do webhook.

32. Como gerar um token que não expira?

Criando um usuário do sistema nas configurações do negócio, atribuindo a ele o app e a conta do WhatsApp e gerando um token com as permissões business_management, whatsapp_business_messaging e whatsapp_business_management. O token temporário do painel expira rápido. Veja token permanente com usuário do sistema.

33. Como baixar a foto ou o áudio que o cliente enviou?

O webhook traz o ID da mídia, não o arquivo. Você consulta esse ID na Graph API para obter a URL e baixa o arquivo com o mesmo token no cabeçalho. O fluxo completo está em receber e baixar mídia pela API.

34. Dá para colocar um chatbot com IA na API?

Sim. O webhook recebe a mensagem, seu sistema chama o modelo de IA e responde pela API dentro da janela de 24 horas. Desde julho de 2026 também existe a categoria Meta Business Agent, para respostas geradas pela plataforma de IA da própria Meta. Um tutorial com código está em conectar o ChatGPT à API oficial.

Conta

35. Preciso verificar a empresa na Meta?

Não para começar, mas a verificação muda o que você consegue fazer: é um dos caminhos para subir o limite de 250 para 2.000 destinatários e libera mais números e templates. Veja verificação da empresa no Meta Business.

36. Quantos números posso registrar?

Portfólios novos podem registrar dois números. O teto passa a 20 quando a empresa é verificada ou atinge o limite de 2.000 mensagens. Cada número precisa ter código de país e de área e receber SMS ou ligação. Veja como registrar o número na Cloud API.

37. O que mudou na WABA em 2026?

Desde 23/09/2026, a antiga WABA foi separada em conta do WhatsApp, que guarda o número, e conta de mensagens, que guarda templates, cobrança e webhooks. Isso muda como parceiros acessam a conta e como se troca de provedor. Veja conta do WhatsApp x conta de mensagens.

38. Como trocar de provedor sem perder o número?

Com a nova estrutura, trocar de provedor é compartilhar a conta do WhatsApp com o novo parceiro, que passa a operar com a conta de mensagens dele. O número continua sendo seu durante a troca. Veja como trocar de provedor da API.

39. Como funciona o nome de exibição?

É o nome que aparece para o cliente. Ele é informado no registro do número e passa por análise da Meta, com status como pendente, aprovado ou recusado. Veja as regras em nome de exibição na API do WhatsApp.

40. Onde peço suporte à Meta?

Todos os desenvolvedores podem usar o suporte para desenvolvedores da Meta, o fórum da comunidade e o formulário de bugs. O Direct Support, com chamados, é descrito como canal de desenvolvedores enterprise, como parceiros; clientes de parceiros devem acionar o próprio parceiro. Veja suporte da Meta para WhatsApp Business.

Como a Vectalk ajuda

A Vectalk é um proxy da Cloud API oficial da Meta: sua aplicação envia para https://apis.vectalk.com.br/api/messages o mesmo payload da Meta, e a Vectalk repassa. Você paga a Vectalk, e a Vectalk paga a Meta. Os webhooks seguem o formato da documentação da Meta, e o número pode ficar em coexistência com o app WhatsApp Business. Comece pelo guia rápido ou crie a conta em apps.vectalk.com.br/register. Dúvidas de conta e cobrança ficam na Central de Ajuda.

---

Fontes oficiais consultadas em 28/10/2026: Sobre a WhatsApp Business Platform, Get started, Preços, Limites de mensagens, Visão geral da Cloud API, Templates, Marketing Messages API, Números de telefone comerciais, Coexistência, Evolução do modelo de contas, Suporte, Termos de Serviço do WhatsApp, Política de Mensagens Comerciais.