Self-hosted · Multi-chip · Auditoria forense

WhatsApp como infraestrutura.
Nao como gambiarra.

Hub central que centraliza N chips e expoe API REST + Webhook unificado. Suas apps consomem como qualquer servico moderno — sem Puppeteer, sem Cloud API paga, sem ficar refem.

POST /v1/messages
# Envia mensagem de texto pelo chip do operador
curl -X POST https://hub.empresa.com/v1/messages \
  -H "Authorization: Bearer ak_live_4f2a..." \
  -H "Content-Type: application/json" \
  -d '{"chip_id":"01HZTQ...", "to":"5511...", "type":"text", "content":{"text":"oi"}}'

# 202 Accepted — vai pra fila com rate limit + jitter por chip
{"id": "01HZ...", "status": "queued"}

Por que existe

WhatsApp e o canal mais usado do Brasil. Sua infra deveria refletir isso.

Times serios precisam de infra real — nao Puppeteer rodando em VPS moribunda nem Cloud API que cobra por mensagem e exige aprovacao de template.

🛡️

Auditoria forense imutavel

Toda mutacao admin grava em audit_events append-only com trigger Postgres bloqueando UPDATE/DELETE. Voce reconstroi qualquer historico — quem fez o que, quando, como.

📡

Webhook assinado HMAC SHA-256

Apps consomem eventos message.received, chip.disconnected, chip.qr_loop etc. Cada delivery assinada com secret por app + retry exponencial 7x.

Anti-ban serio (nao gambiarra)

Throttle por chip + jitter ±30% + presence (composing/recording) + warmup gradual + detector automatico de ban via sliding window.

🔌

Multi-chip com isolamento

1 fila BullMQ por chip, rate limit isolado, vinculos finos com app_chip_access. App A usa chip X pra vendas, app B usa chip Y pra suporte — sem cruzamento.

📱

App mobile companion

APK Android (Expo) com push em tempo real quando chip cai. Pareamento por codigo no proprio celular, sem precisar de QR em outro device.

🏠

100% self-hosted, zero lock-in

Roda em qualquer VM Linux. Postgres + Redis + MinIO + Node 22 em Docker Compose. Voce e dono do dado, do chip, do throughput. Custo: VPS de R$30/mes.

Como funciona

3 passos. Sem mistério.

1

Suba o hub

Docker Compose em uma VM Linux (~R$30/mes). Postgres + Redis + MinIO + Node. Em 10min ja esta de pe.

2

Vincule chips

Cria um chip via API ou dashboard, escaneia QR (ou digita pairing code). Em segundos esta `connected`.

3

Apps consomem

Cada app integradora recebe `api_key` + `webhook_secret`. Manda mensagem via REST, escuta eventos no webhook.

Estabilidade real: em prod com 2 chips, hub absorveu 19 badSessions transient em 24h sem nenhum chip cair. Cada queda terminal dispara push em ~5s pro app mobile do operador. Voce dorme tranquilo.

Comparativo

Qual o trade-off real?

Sem dourar a pílula. Cada caminho tem custo. Veja em que cenarios WPP Hub vence — e quando voce talvez prefira outra opcao.

Recurso WPP Hub Twilio / Z-API whatsapp-web.js Cloud API (Meta)
Self-hosted
Multi-chip nativo ⚠️ por numero pago ✅ DIY ⚠️ por numero aprovado
Auditoria forense imutavel ✅ append-only DB ⚠️ logs Meta
Anti-ban embarcado ✅ throttle+jitter+warmup ⚠️ implicit ❌ DIY N/A
Custo por mensagem $0 R$0,06-0,30 $0 R$0,06-0,40
Mensagem livre (sem template) ⚠️ janela 24h ❌ template aprovado
RAM por chip ~30-80MB N/A ~300-500MB Chromium N/A
Aprovacao Meta necessaria ✅ pra alguns recursos ✅ obrigatoria

WPP Hub usa Baileys (engenharia reversa do protocolo multidevice). Risco conhecido: WhatsApp pode mudar protocolo e exigir update. Mitigacao: pinning de versao + monitoramento + auto-recovery em badSession transient.

Pra times que querem fazer direito

Tem caso de uso real?
Vamos conversar.

Operamos hoje pra clinicas, advocacias e e-commerces que tratam WhatsApp como canal serio. Te mostramos como seria sua integracao em uma chamada de 30min.

10 min
do zero ao primeiro webhook
~R$30/mes
VPS minima pra rodar
100% seu
codigo, dado, throughput