API oficial ou não oficial do WhatsApp: qual escolher em 2026
Custos, aprovação de templates, limites e o que cada modelo permite fazer: compare a Cloud API da Meta com uma API não oficial e escolha com segurança.
Você precisa colocar o WhatsApp dentro do seu sistema e, na primeira busca, encontra dois mundos que parecem falar da mesma coisa. De um lado, a API oficial da Meta, com conta comercial, modelos de mensagem aprovados e cobrança por mensagem. Do outro, APIs que conectam um número comum pelo protocolo do WhatsApp Web, sem aprovação e com preço fixo por número.
As duas enviam e recebem mensagens por HTTP. O que muda é quem aprova o que você envia, como a conta chega no fim do mês, quanto você pode enviar e qual risco você aceita correr. Escolher errado custa caro nos dois sentidos: semanas esperando aprovação para mandar um lembrete simples, ou um número restringido porque uma campanha fria saiu por um canal que não foi feito para isso.
Este guia compara os dois modelos critério a critério, diz com franqueza quando a API oficial é a escolha certa e mostra o que a apiwpp, uma API não oficial, faz para reduzir o risco de quem escolhe o outro caminho.
Os dois modelos, lado a lado
API oficial: a WhatsApp Cloud API
A API oficial faz parte da WhatsApp Business Platform da Meta e hoje é oferecida principalmente como Cloud API, hospedada pela própria Meta. O número é registrado na plataforma e vinculado a uma conta comercial. A partir daí:
- Para iniciar uma conversa, ou para escrever depois que a janela de atendimento de 24 horas fechou, a empresa precisa usar um modelo de mensagem aprovado pela Meta.
- A cobrança é feita por mensagem, conforme a categoria (marketing, utilidade, autenticação) e o país do destinatário. Os valores mudam com frequência: consulte a tabela oficial de preços da Meta em vez de confiar em números de terceiros.
- Muitas empresas usam a Cloud API por meio de um provedor parceiro da Meta, que pode cobrar a própria mensalidade além das tarifas da Meta.
API não oficial: o protocolo do WhatsApp Web
Uma API não oficial conecta o número da mesma forma que o WhatsApp Web: como um aparelho conectado. Você escaneia um QR code, ou digita um código de pareamento, e o serviço passa a enviar e receber em nome daquele número.
Na apiwpp é assim que funciona: o número continua sendo um WhatsApp comum, a sessão fica salva e criptografada nos servidores e o celular pode ficar desligado. Não há aprovação de conta nem de mensagens. Você paga por número conectado, por mês, com mensagens ilimitadas dentro dos limites de ritmo da fila. A contrapartida é clara: a apiwpp não tem vínculo com o WhatsApp nem com a Meta, e o número segue sujeito às regras antispam do WhatsApp como qualquer usuário.
Tabela comparativa
| Critério | API oficial (Cloud API) | API não oficial (apiwpp) |
|---|---|---|
| Como o número se conecta | Registrado na plataforma da Meta | Aparelho conectado, por QR code ou código de 8 caracteres |
| Aprovação da conta | Conta comercial na Meta | Nenhuma: cadastro e teste de 7 dias |
| Mensagens iniciadas pela empresa | Só com modelos aprovados pela Meta | Texto livre, mídia ou templates próprios, sem aprovação |
| Selo de conta verificada | Possível, conforme os critérios da Meta | Não existe |
| Cobrança | Pela Meta, por mensagem, por categoria e país | Por número, por mês |
| Volume | Pensada para volumes altos, com limites definidos pela Meta | Limitado pela fila de cada número |
| Risco de restrição do número | Baixo, dentro das políticas da Meta | Existe; a fila e o aquecimento reduzem, sem eliminar |
| Tempo até a primeira mensagem | Depende das etapas de cadastro e aprovação | Minutos: conectar o número e chamar a API |
A tabela resume, mas três critérios merecem mais atenção, porque são eles que decidem a maioria dos projetos: custo, aprovação e volume.
Custos: por mensagem ou por número
Os dois modelos cobram coisas diferentes, e comparar só o valor de tabela engana.
Na Cloud API, o custo acompanha o volume. Cada mensagem de modelo entregue tem uma tarifa que depende da categoria e do país, e a conta do mês é o resultado de quantas mensagens saíram de cada tipo. É um modelo justo para quem manda pouco e previsível para quem tem um volume estável, mas exige acompanhar as categorias: a mesma mensagem pode custar diferente se for classificada como marketing ou como utilidade.
Na apiwpp, o custo acompanha o número de números. Você paga um valor fixo por número conectado por mês, no plano LITE ou PRO, e envia quanto a fila permitir, sem tarifa por mensagem. Adicionar um número no meio do mês é cobrado de forma proporcional, e tudo vem numa fatura só por organização, paga por PIX, boleto ou cartão. Os valores atuais estão em preços, com uma calculadora por quantidade de números.
Para comparar os dois de verdade, faça a conta com o seu cenário:
- Quantas mensagens por mês o seu sistema envia, e de que tipo (confirmação, lembrete, cobrança, promoção)?
- Quantas dessas mensagens são iniciadas por você e quantas são respostas a quem escreveu?
- Quantos números você precisa, e por quê (um por cliente, um por unidade, um por equipe)?
Com essas três respostas, o custo da Cloud API sai da tabela da Meta e o da apiwpp sai da calculadora. O guia sobre quanto custa uma API de WhatsApp detalha os modelos de cobrança, incluindo a opção de hospedar a própria API.
Aprovação e templates
Na Cloud API, a palavra "template" significa um modelo de mensagem que a Meta revisa antes do uso. Ele é obrigatório para iniciar conversas e para retomar o contato depois da janela de atendimento. A aprovação protege o destinatário, mas também engessa: mudar o texto de um aviso pede uma nova revisão.
Na apiwpp, um template é só uma mensagem salva com variáveis, que qualquer sistema do projeto reutiliza. Não passa por aprovação. Você cria uma vez:
curl -X POST https://api.apiwpp.com/connections/$ID/templates \
-H "Authorization: Bearer $APIWPP_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"confirmacao_consulta","body":"Olá {{nome}}, até amanhã às {{hora}}."}'
E envia pelo nome, passando as variáveis:
curl -X POST https://api.apiwpp.com/connections/$ID/send \
-H "Authorization: Bearer $APIWPP_KEY" \
-H "Content-Type: application/json" \
-d '{"to":"5511988887777","template":"confirmacao_consulta","variables":{"nome":"Maria","hora":"10h"},"clientRef":"consulta-8812-lembrete"}'
A resposta chega na hora com 202, porque o envio vai para a fila do número:
{ "jobId": "c2a4e6f8-1b3d-4f5a-8c7e-9d0b1a2c3e4f", "scheduledAt": 1790251205000, "position": 1 }
Se faltar alguma variável, a API responde 400 com a lista em missingVariables, e nada é enviado. O clientRef garante que, se o seu sistema repetir a requisição, a mesma mensagem não saia duas vezes.
Liberdade de texto não é licença para qualquer conteúdo. Sem a revisão da Meta, quem filtra o que é aceitável é você, e quem julga é o destinatário: uma mensagem que as pessoas não querem receber vira denúncia, e denúncia pesa contra o número.
Limites e volume
A Cloud API foi desenhada para volume. A Meta define quantas conversas novas cada número pode iniciar por dia e amplia esse limite conforme a qualidade das mensagens e a verificação da empresa. Os critérios estão na documentação oficial da Meta.
Numa API não oficial, o limite prático é o que um número comum aguenta sem parecer robô. Por isso a apiwpp coloca cada número atrás de uma fila com ritmo anti-bloqueio. Os valores padrão são 3 mensagens por minuto, 60 por hora e 200 por dia por número, com intervalo aleatório de 3 a 8 segundos entre envios e pelo menos 30 segundos entre duas mensagens para a mesma pessoa. Destinatários novos têm um teto de 100 a cada 24 horas.
Na prática, isso significa que a apiwpp atende bem quem conversa com a própria base: confirmações de pedido, lembretes de agendamento, avisos de cobrança, atendimento integrado ao sistema. Precisa de mais capacidade? Cada número tem a própria fila, e você pode conectar mais números para operações separadas. O que não funciona é dividir uma lista fria entre vários números para contornar o ritmo: isso só multiplica as denúncias.
O que cada modelo permite fazer
No dia a dia de uma integração, os dois modelos cobrem o essencial: enviar texto e mídia, receber mensagens no seu sistema e acompanhar o status de entrega. As diferenças aparecem nas bordas.
Na apiwpp, hoje, você pode:
- enviar texto com indicador de "digitando…", imagem, vídeo, áudio (inclusive como mensagem de voz), documento, figurinha e localização, a partir de uma URL https pública;
- usar templates próprios com variáveis e reagir a mensagens;
- receber tudo por webhooks assinados com HMAC, com novas tentativas, histórico e reenvio: mensagens recebidas, status de entrega, reações, eventos de grupo e o estado da conexão;
- verificar se um número tem WhatsApp antes de enviar, com até 100 números por chamada, e deixar a resolução do nono dígito com a API;
- no plano PRO, editar e apagar para todos as mensagens enviadas pela API, marcar como lidas e mostrar presença.
Enquetes e administração de grupos estão no roteiro como "em breve", e ainda não fazem parte do produto. Se o seu fluxo depende de botões e listas interativas hoje, a Cloud API é o caminho.
Quando a API oficial é a escolha certa
Se o seu caso exige o selo verificado ou envio em altíssimo volume, a API oficial (Cloud API) é a escolha certa. Em mais detalhe, escolha a oficial quando:
- Você faz marketing em volume. Campanhas para listas grandes, com gente que nunca falou com a empresa, pedem um canal com regras formais para isso. Uma API não oficial não é ferramenta de disparo em massa.
- O selo de conta verificada importa. Bancos, grandes varejistas e marcas muito imitadas ganham confiança com a verificação da Meta.
- Nenhum risco de restrição é aceitável. Se perder o número por alguns dias paralisa a operação, o respaldo das políticas da Meta vale o custo por mensagem.
- Você precisa de mensagens interativas agora. Botões e listas nativos são recursos da plataforma oficial.
- A equipe já tem processos para aprovar modelos e acompanhar a cobrança por categoria.
Quando a não oficial faz sentido
Uma API não oficial vence quando a empresa conversa com quem já é cliente e quer começar sem burocracia:
- Você fala com a sua própria base. Confirmações, lembretes, segunda via, atualizações de pedido e respostas a quem escreveu são o uso para o qual o WhatsApp foi feito.
- Custo previsível importa. Um valor fixo por número é fácil de orçar e de repassar, principalmente para agências e SaaS que cobram os próprios clientes por número.
- Você quer começar hoje. Sem aprovação de conta nem de mensagens, o primeiro envio acontece minutos depois de conectar o número.
- O texto muda com frequência. Ajustar um aviso é editar um template, não esperar uma revisão.
- O número já existe. Clientes conhecem aquele número, e ele pode continuar sendo o mesmo.
Se o caminho for hospedar a própria API com um projeto open source em vez de usar um serviço gerenciado, o guia sobre Evolution API, Baileys e WPPConnect compara o que cada opção exige.
Como a apiwpp reduz o risco
Escolher o modelo não oficial não significa aceitar o risco sem proteção. A apiwpp aplica, por padrão, as regras que uma integração bem escrita deveria aplicar sozinha:
- Fila por número. O ritmo descrito acima vale para todo envio, sem depender de disciplina do seu código.
- Aquecimento de 14 dias. Um número recém-conectado começa com 5 mensagens por hora e 20 por dia, e os limites sobem por etapas até os valores normais. Veja o aquecimento de número.
- Teto de destinatários novos. Passado o limite de conversas novas do dia, o envio responde
429com o erronew_recipient_cap_reachede o cabeçalhoRetry-After, e nada entra na fila. Contatos conhecidos nunca são barrados. - Proxy brasileiro por número. Cada número sai por um IP brasileiro, e o plano PRO permite um IP dedicado como adicional.
- Aviso de bloqueio temporário. Quando o WhatsApp bloqueia novas conversas por um tempo, a apiwpp detecta, avisa pelo evento
connection.statuse recusa os envios sem tentá-los até o bloqueio terminar.
Tudo isso reduz o risco; nada garante que o WhatsApp nunca vai restringir um número. O guia como evitar o bloqueio do número mostra o que fazer do seu lado.
Dá para usar as duas
Dá, com números diferentes, e é uma arquitetura comum. A empresa usa a Cloud API para comunicações de alto volume ou para campanhas, e um número conectado à apiwpp para o relacionamento do dia a dia: confirmações, lembretes e atendimento integrado ao sistema.
Para isso funcionar bem, trate o canal como um detalhe de implementação. Crie no seu código uma interface de envio única, com implementações para cada provedor, e decida o canal pelo tipo de mensagem. Os dois lados entregam eventos por webhook, então o seu sistema recebe as respostas no mesmo lugar. O comparativo apiwpp ou API oficial resume os critérios num formato de consulta rápida.
Como começar hoje
- Liste as mensagens que o seu sistema precisa enviar e marque quais vão para quem já é cliente e quais são campanhas para contatos novos.
- Se a maior parte é campanha fria ou depende de selo verificado, comece pela Cloud API e consulte a tabela oficial da Meta.
- Se a maior parte é conversa com clientes, estime o número de números e compare o custo em preços.
- Leia a integração com Node.js para ver o envio e o webhook em poucas linhas de código.
- Crie sua conta na apiwpp e conecte o primeiro número: são 7 dias de teste com os recursos do PRO (exceto IP dedicado), sem cartão.
Perguntas frequentes
A apiwpp é a API oficial do WhatsApp?
Não. A apiwpp conecta o seu número pelo protocolo do WhatsApp Web, como um aparelho conectado, e não tem vínculo com o WhatsApp nem com a Meta. Você não precisa de aprovação da Meta nem de templates aprovados, e paga por número em vez de por mensagem. Se o seu caso exige o selo verificado ou envio em altíssimo volume, a API oficial (Cloud API) é a escolha certa.
Qual das duas é mais barata?
Depende do seu volume e do tipo de mensagem. A Cloud API cobra por mensagem, com tarifas da Meta por categoria e país; a apiwpp cobra um valor fixo por número por mês, com mensagens ilimitadas dentro dos limites da fila. Faça a conta com o seu cenário usando a tabela oficial da Meta e a calculadora da página de preços.
Usar uma API não oficial é proibido?
A apiwpp usa o mesmo protocolo do WhatsApp Web, mas não é autorizada nem endossada pela Meta, e o número continua sujeito às regras do WhatsApp. O uso responsável, com opt-in, conversa com clientes e ritmo de envio humano, é o que mantém o número ativo. Nenhuma API não oficial pode garantir que um número nunca será restringido.
Preciso de aprovação para enviar templates na apiwpp?
Não. Na apiwpp um template é uma mensagem salva com variáveis, como {{nome}}, criada pela API e enviada pelo nome. Ela não passa pela revisão da Meta, por isso você pode ajustar o texto quando quiser. O cuidado com o conteúdo fica com você.
Posso começar pela apiwpp e migrar para a API oficial depois?
Pode. As integrações são diferentes, então será preciso adaptar o código de envio e de webhooks, e o número precisa ser registrado na plataforma da Meta. Isolar o envio numa interface própria desde o início torna essa troca muito mais simples.
Quantas mensagens a apiwpp envia por dia?
O padrão é de até 200 mensagens por dia por número, com no máximo 60 por hora e 3 por minuto, depois do aquecimento de 14 dias. Destinatários novos têm um teto de 100 a cada 24 horas. Para mais capacidade, conecte mais números para operações separadas.
Leia também: