apiwpp ou API oficial do WhatsApp (Cloud API): comparativo
Aprovação, templates, selo, forma de cobrança e risco: o que muda entre a Cloud API oficial da Meta e a apiwpp, e quando cada uma é a escolha certa.
Atualizado em
Quem precisa integrar o WhatsApp a um sistema encontra dois caminhos. O primeiro é a API oficial, a WhatsApp Business Platform da Meta, hoje oferecida principalmente como Cloud API. O segundo são as APIs não oficiais, como a apiwpp, que conectam o número pelo mesmo protocolo do WhatsApp Web, como um aparelho conectado.
Não existe uma resposta certa para todo mundo. Este comparativo mostra o que muda em cada critério e diz com clareza quando a API oficial é a melhor escolha.
Como cada modelo funciona
Na Cloud API, o número é registrado na plataforma da Meta, vinculado a uma conta comercial. As mensagens que a empresa inicia fora da janela de atendimento precisam usar modelos de mensagem aprovados pela Meta, e a cobrança é feita pela Meta por mensagem, conforme a categoria e o país. Os valores e as regras mudam com frequência: consulte a tabela oficial de preços da Meta antes de fazer contas.
Na apiwpp, o número continua sendo um WhatsApp comum. Você o conecta por QR code ou por um código de pareamento de 8 caracteres, como faria no WhatsApp Web, e a sessão fica salva e criptografada nos servidores. Não há aprovação de conta nem de mensagens: você envia texto, mídia, localização e templates próprios com variáveis pela API, e recebe as respostas por webhook. A cobrança é por número conectado, por mês.
Tabela comparativa
| Critério | API oficial (Cloud API) | apiwpp |
|---|---|---|
| Como o número se conecta | Registrado na plataforma da Meta | Aparelho conectado, por QR code ou código de pareamento |
| Aprovação | Conta comercial na Meta | Nenhuma: cadastro e teste grátis de 7 dias |
| Mensagens fora da janela de atendimento | Modelos aprovados pela Meta | Texto livre ou templates próprios, sem aprovação |
| Cobrança | Pela Meta, por mensagem (ver tabela oficial) | Por número, por mês, com mensagens ilimitadas dentro dos limites da fila |
| Selo de conta oficial | Possível, conforme os critérios da Meta | Não existe |
| Volume | Pensada para volumes altos, com limites definidos pela Meta | Limitado pela fila de cada número (por minuto, hora e dia) |
| Risco para o número | Baixo, dentro das políticas da Meta | Existe: a fila e o aquecimento reduzem o risco, sem eliminá-lo |
Quando a API oficial é a escolha certa
A Cloud API é o caminho mais seguro quando o WhatsApp é um canal crítico e de alto volume. Escolha a oficial se:
- você precisa de campanhas de marketing em volume para listas grandes;
- a sua empresa precisa do selo de conta oficial ou de um vínculo formal com a Meta;
- o risco de ter um número restringido não é aceitável para a operação;
- a equipe já tem processos para aprovar modelos de mensagem e acompanhar a cobrança por mensagem.
A apiwpp não é uma ferramenta de disparo em massa: a fila limita o ritmo e a quantidade de destinatários novos por dia justamente para proteger o número. Se o seu plano é enviar para milhares de contatos que nunca falaram com a empresa, a API oficial é a resposta honesta.
Quando a apiwpp faz mais sentido
Uma API não oficial vence quando a empresa conversa com quem já é cliente e quer começar sem burocracia:
Escolha a API oficial se
- o volume é muito alto e inclui marketing;
- o selo de conta oficial importa;
- nenhum risco de restrição é aceitável.
Escolha a apiwpp se
- você envia notificações, lembretes e respostas para clientes;
- quer começar hoje, sem aprovação de conta ou de mensagens;
- prefere um custo fixo por número a pagar por mensagem.
Outros pontos que pesam a favor da apiwpp nesses cenários: o celular do número pode ficar desligado, as mensagens recebidas chegam por webhooks assinados com HMAC e novas tentativas, e o envio é idempotente com o clientRef, o que evita mensagens duplicadas quando o seu sistema repete uma requisição.
Como a apiwpp reduz o risco de bloqueio
Todo número conectado tem uma fila com limites padrão de 3 mensagens por minuto, 60 por hora e 200 por dia, com um 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 por dia, e um número recém-conectado passa por um aquecimento de 14 dias, com limites que começam baixos e crescem por etapa. Cada número sai por um proxy brasileiro.
Esses cuidados reduzem o risco, mas nenhuma API não oficial pode garantir que o WhatsApp nunca vai restringir um número. Os detalhes estão em fila anti-bloqueio e no guia como evitar o bloqueio do número.
Dá para usar as duas?
Dá, com números diferentes. Uma estratégia comum é usar a API oficial para comunicações de alto volume e um número conectado à apiwpp para o relacionamento com clientes, como confirmações, lembretes e atendimento integrado ao seu sistema.
Para entender os conceitos, veja no glossário o que é a WhatsApp Cloud API e uma API não oficial. Para comparar custos, o guia do blog API oficial ou não oficial aprofunda cada modelo, e o guia quanto custa uma API de WhatsApp põe os modelos de cobrança lado a lado.
Como testar a apiwpp antes de decidir
O teste grátis dura 7 dias, inclui 1 número e os recursos do plano PRO, e não pede cartão. Em poucos passos dá para ver se o modelo atende o seu caso:
- Crie a conta e um projeto, com a chave de API e o endereço do webhook.
- Conecte um número por QR code ou código de pareamento.
- Envie uma mensagem com
POST /connections/{id}/send. A resposta202trazjobId,scheduledAteposition, e o eventomessage.deliveryinforma quando a mensagem foi entregue e lida. - Responda pelo celular e veja a mensagem chegar ao seu sistema pelo evento
message.incoming.
Os exemplos prontos estão em Node.js e Python, e os valores por número, na página de preços.
Perguntas frequentes
Preciso de aprovação para começar na apiwpp?
Não. Não há aprovação de conta nem de modelos de mensagem: você cria a conta, conecta o número por QR code ou código de pareamento e já pode enviar pela API, dentro dos limites da fila.
A apiwpp é a API oficial do WhatsApp?
Não. A apiwpp conecta o número pelo protocolo do WhatsApp Web, como um aparelho conectado, e não tem vínculo com o WhatsApp nem com a Meta. Por isso não exige aprovação de conta nem de modelos de mensagem.
Qual é mais barata?
Depende do volume e do tipo de mensagem. A Cloud API cobra por mensagem, com valores definidos pela Meta; a apiwpp cobra por número, com mensagens ilimitadas dentro dos limites da fila. Compare com a tabela oficial da Meta e com a página de preços da apiwpp.
Posso enviar campanhas de marketing pela apiwpp?
Para listas frias e grandes volumes, não é a ferramenta certa: a fila limita o ritmo e os destinatários novos por dia para proteger o número. Para campanhas desse tipo, a API oficial é a escolha recomendada.
Posso migrar da apiwpp 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. Muitas empresas começam pela apiwpp e mantêm os dois canais com números diferentes.
Outros comparativos
Todos: Comparativos →Os critérios para comparar APIs de WhatsApp gerenciadas, como cobrança, fila anti-bloqueio, webhooks assinados, idempotência, proxy e documentação, com a posição da apiwpp em cada um e um roteiro de migração.
A Evolution API é um servidor open source que você hospeda e opera; a apiwpp é uma API gerenciada cobrada por número. Veja o custo total de cada modelo, o que a apiwpp opera por você e quando hospedar faz sentido.
O app WhatsApp Business é feito para atender à mão, no celular. Uma API leva as mensagens para dentro do seu sistema, com envio automático e webhooks. Na apiwpp, o número continua no app e a API entra como um aparelho conectado.