Alternativas à Z-API: o que comparar ao escolher uma API de WhatsApp
Procurando uma alternativa à Z-API? Veja os critérios que importam numa API de WhatsApp gerenciada e como a apiwpp se posiciona em cada um.
Atualizado em
A Z-API é um serviço brasileiro conhecido de API de WhatsApp: gerenciado, sem precisar hospedar nada, e cobrado por instância, ou seja, por número conectado. Quem pesquisa uma alternativa normalmente já passou da fase de "funciona?" e está perguntando outra coisa: qual serviço protege melhor o número, qual entrega os eventos com mais confiança e qual cabe no orçamento quando a quantidade de números cresce.
Esta página não avalia a Z-API nem aponta defeitos dela. Os recursos e as condições de qualquer fornecedor mudam com o tempo, e a única fonte confiável sobre eles é a documentação do próprio fornecedor. O que fazemos aqui é listar os critérios que valem para qualquer API de WhatsApp gerenciada e mostrar, com fatos, onde a apiwpp está em cada um. Use a lista para comparar os serviços que você tem em mente.
O ponto de partida: o mesmo modelo
A Z-API e a apiwpp pertencem à mesma família: APIs não oficiais, que conectam o número pelo protocolo do WhatsApp Web, como um aparelho conectado, e operadas por uma empresa em vez de hospedadas por você. Nenhuma das duas é a Cloud API da Meta, então nenhuma exige aprovação de conta ou de modelos de mensagem, e nenhuma dá o selo de conta oficial.
Isso também significa que o risco de o WhatsApp restringir um número existe em qualquer serviço desse tipo. A diferença entre fornecedores está no que eles fazem para reduzir esse risco e em como entregam a integração. Se você ainda está decidindo entre oficial e não oficial, comece pelo comparativo apiwpp ou API oficial.
Os critérios que importam
1. Modelo de cobrança
APIs gerenciadas costumam cobrar por número conectado por mês, e não por mensagem. Pergunte: há cota de mensagens? Adicionar um número no meio do mês gera cobrança proporcional? Existe uma fatura só para vários números?
Na apiwpp: cobrança por número conectado, por mês, em dois planos (LITE e PRO), com mensagens ilimitadas dentro dos limites da fila e sem cobrança por mensagem. É uma assinatura por organização, com uma fatura para todos os números, paga por PIX, boleto ou cartão. Um número adicionado fica disponível na hora e o resto do mês é cobrado de forma proporcional; uma redução vale a partir da próxima fatura. Os valores estão em preços.
2. Proteção contra bloqueio
Este é o critério que mais pesa no dia a dia. Pergunte se o serviço controla o ritmo de envio por número ou se simplesmente repassa tudo o que o seu sistema manda.
Na apiwpp: cada número tem uma fila anti-bloqueio com limites padrão de 3 mensagens por minuto, 60 por hora e 200 por dia, intervalo aleatório de 3 a 8 segundos e pelo menos 30 segundos entre duas mensagens para a mesma pessoa. Destinatários novos têm teto de 100 a cada 24 horas; acima disso, o envio responde 429 com o cabeçalho Retry-After e nada entra na fila. Números recém-conectados passam por um aquecimento de 14 dias. Esses cuidados reduzem o risco, mas nenhum serviço não oficial pode garantir que um número nunca será restringido.
3. Webhooks confiáveis e assinados
Pergunte como o serviço prova que um evento veio dele, o que acontece quando o seu endpoint está fora do ar e se dá para ver e reenviar entregas que falharam.
Na apiwpp: os webhooks são assinados com HMAC-SHA256 sobre o horário e o corpo da requisição, com tolerância de 300 segundos contra repetição. A entrega é pelo menos uma vez, com até 6 tentativas em intervalos crescentes, registro de cada entrega e reenvio das que falharam, pela API ou pelo painel.
4. Idempotência
Timeouts e retentativas acontecem. Sem uma chave de idempotência, o seu cliente pode receber a mesma cobrança ou o mesmo aviso duas vezes.
Na apiwpp: o campo clientRef torna o envio idempotente. Repetir a requisição com o mesmo valor devolve o job original com "duplicate": true, sem enfileirar outra mensagem, e o valor fica reservado por 7 dias. Veja idempotência com clientRef.
5. Proxy e IP
O endereço de onde o número se conecta afeta a reputação dele. Pergunte se o serviço usa IPs brasileiros, se permite o seu próprio proxy e se oferece IP exclusivo.
Na apiwpp: cada número sai por um proxy brasileiro, você pode configurar o seu próprio proxy por conexão e o plano PRO oferece um IP dedicado por número como adicional.
6. Documentação e especificação
Pergunte se existe uma especificação formal da API, em que idioma está a documentação e se há clientes tipados.
Na apiwpp: especificação OpenAPI 3.1 pública em português e inglês, referência interativa e guias em português em docs.apiwpp.com, e clientes TypeScript e PHP gerados da especificação.
7. Suporte, status e nota fiscal
Pergunte por onde o suporte é feito, se existe uma página de status pública e se o fornecedor emite nota fiscal de serviço, caso a sua empresa precise dela.
Na apiwpp: o contato é pelo e-mail [email protected] e a status.apiwpp.com mostra a saúde dos componentes, com um teste que envia mensagens reais entre dois números a cada 10 minutos. Sobre nota fiscal, confirme com o nosso contato antes de assinar: preferimos não prometer algo que ainda não está confirmado nesta página.
Resumo da apiwpp por critério
| Critério | O que perguntar ao fornecedor | apiwpp |
|---|---|---|
| Cobrança | Por número? Há cota de mensagens? | Por número por mês, mensagens ilimitadas dentro da fila |
| Ritmo de envio | Existe fila por número? | Limites por minuto, hora e dia, e teto de destinatários novos |
| Aquecimento | Números novos têm limites menores? | 14 dias, com limites crescentes por etapa |
| Webhooks | Assinatura, novas tentativas, reenvio? | HMAC-SHA256, 6 tentativas, registro e reenvio |
| Idempotência | Dá para repetir sem duplicar? | clientRef, reservado por 7 dias |
| Proxy | IP brasileiro? Proxy próprio? | Proxy brasileiro, proxy próprio e IP dedicado (PRO) |
| Especificação | Existe OpenAPI? | OpenAPI 3.1 em português e inglês |
| Teste | Dá para testar sem cartão? | 7 dias, 1 número, recursos PRO, sem cartão |
Checklist de migração para a apiwpp
Trocar de API gerenciada é uma migração de integração, não de número. O número continua sendo o mesmo WhatsApp; muda o serviço que o mantém conectado.
- Crie a conta e um projeto. O teste de 7 dias inclui 1 número e os recursos PRO, sem cartão. Cada projeto tem as próprias chaves de API e o próprio webhook, o que ajuda se você atende vários clientes.
- Reconecte o número. Desconecte o serviço antigo no celular, em Aparelhos conectados, e pareie o número na apiwpp por QR code ou por código de pareamento de 8 caracteres. O aquecimento de 14 dias começa nesse pareamento, então planeje a migração para um período de volume menor.
- Troque o endpoint de envio. O envio passa a ser
POST /connections/{id}/send, com o destinatário emto(só dígitos, com país e DDD) e umclientRefestável por mensagem. - Troque o webhook. Configure o endereço no projeto, valide a assinatura HMAC e trate os tipos de evento que você usa, como
message.incoming,message.deliveryeconnection.status. - Trate as respostas da fila. O envio responde
202comjobId,scheduledAteposition; um429pede para reagendar depois doRetry-After; o eventomessage.send_failedavisa um envio aceito que não vai acontecer.
O envio mínimo fica assim:
curl -X POST "https://api.apiwpp.com/connections/$CONNECTION_ID/send" \
-H "Authorization: Bearer $APIWPP_KEY" \
-H "Content-Type: application/json" \
-d '{ "to": "5511999998888", "message": "Seu pedido 1042 foi enviado.", "clientRef": "pedido-1042-enviado" }'
Os exemplos completos por linguagem estão em Node.js, TypeScript e Python.
Perguntas frequentes
A apiwpp é igual à Z-API?
As duas são APIs de WhatsApp gerenciadas e não oficiais, que conectam o número pelo protocolo do WhatsApp Web. Os recursos, os limites e as condições de cada uma são diferentes; compare-os com a documentação de cada fornecedor, usando os critérios desta página.
Preciso de um número novo para migrar?
Não. Você desconecta o serviço antigo no celular e pareia o mesmo número na apiwpp. O aquecimento de 14 dias recomeça a partir do novo pareamento.
A apiwpp cobra por mensagem?
Não. A cobrança é por número conectado, por mês, com mensagens ilimitadas dentro dos limites da fila de cada número.
Consigo testar antes de migrar tudo?
Sim. O teste grátis de 7 dias inclui 1 número e os recursos PRO, sem cartão. Dá para conectar um número, integrar o envio e o webhook e só então migrar os demais.
A apiwpp garante que o número não será bloqueado?
Não. A fila, o aquecimento e o teto de destinatários novos reduzem o risco, mas nenhuma API não oficial pode garantir que o WhatsApp nunca vai restringir um número. O guia como evitar o bloqueio do número mostra as boas práticas.
Outros comparativos
Todos: Comparativos →A Cloud API da Meta exige conta comercial e templates aprovados e cobra por mensagem; a apiwpp conecta o número como aparelho conectado, sem aprovação, e cobra por número. Cada uma vence em cenários diferentes.
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.
Baileys e WPPConnect são projetos open source que falam o protocolo do WhatsApp Web. Montar uma API em produção sobre eles exige fila, webhooks confiáveis, separação por cliente, painel e cobrança. Veja o que falta construir e quando vale a pena.