A
Comparativo repos GitHub WhatsApp 2026
Não-oficiais (Baileys-based — risco ban ALTO em todos)
| Repo | Stars | Docs PT-BR | Veredito |
|---|---|---|---|
| Evolution API | 8.4k | Parcial | ★ Caminho A |
| WAHA | 6.6k | Não | Alt. pra dev |
| WPPConnect | 3.3k | SIM (BR) | Alt. leigo BR |
| Baileys | 9.5k | Não | Só pra devs |
| whatsapp-web.js | 21.9k | Tutoriais | Legado · NÃO |
Oficiais (Cloud API — risco ZERO)
- · Meta SDK Node oficial: ARQUIVADO desde 2023 — não usar
- · @great-detail/whatsapp (Node v8.4): Caminho C Node moderno
- · filipporomani/whatsapp-python (v4.3): Python · atenção AGPL
- · Composio WhatsApp Toolkit: ★ recomendado pra IA agent · 17 tools
B
Checklist anti-ban (não-oficial)
- ☐ Chip novo dedicado (R$ 30)
- ☐ Android antigo (não usar em iPhone primário)
- ☐ Aquecimento 7-14 dias antes
- ☐ Delay aleatório 8-30s entre respostas
- ☐ Nunca templates 100% idênticos
- ☐ Não comprar lista fria
- ☐ Limite ~100 msgs novas/dia início
- ☐ Não responder grupos
- ☐ Backup do banco de contatos
- ☐ Número 2 reserva já aquecido
C
Troubleshooting comum
- "Easypanel não abre na porta 3000"
- Firewall HospedaInfo bloqueando · liberar via painel da HospedaInfo
- "Evolution não conecta"
- Reiniciar instância, escanear QR de novo
- "Z-API timeout webhook"
- Workflow respondendo > 5s · adicionar Respond to Webhook 200 OK + processar em background
- "Cloud API: template REJECTED"
- Categoria errada (marketing escrito como utility) · ou idioma diferente
- "Claude API erro 401"
- API key vazada/revogada · regerar no console e atualizar credencial no n8n