Galeria de Diagramas · F2A WhatsApp

Decisão · qual plug

Plug 1 · Evolution

Não-oficial · open source
Custo zero do plug · self-hosted na VPS · risco ban médio-alto · perfil: técnico, baixo orçamento.

Plug 2 · Z-API

Não-oficial · SaaS BR
R$ 55-99/mês · setup 5 min · suporte PT-BR · risco ban médio · perfil: leigo, paga paz.

Plug 3 · Cloud API

Oficial Meta · CNPJ
Atendimento grátis · marketing pago por msg · setup 1-3 sem · risco zero · perfil: negócio sério.

Superestrutura comum (VPS)

  VPS HospedaInfo · R$ 47,92/mês (cupom KPA20)
  8 GB RAM · 4 vCPU · Easypanel pré-instalado
  │
  └─ Easypanel (porta 3000) — pronto
      ├─ n8n         · workflows
      ├─ Postgres    · chat + PGVector
      └─ Redis       · buffer 8s

  ▲
  │ SSH MCP + n8n MCP
  │
  Claude Code (laptop)

Fluxo · Plug 1 Evolution

  Chip dedicado (Android velho)
       │ QR code
       ▼
  Evolution API v2.3.7
       │ webhook MESSAGES_UPSERT
       ▼
  n8n workflow
       ├─ filter @g.us / fromMe
       ├─ Smart Redis Buffer 8s
       ├─ Postgres histórico
       ├─ MiMo v2.5-pro
       └─ POST /sendText → Evolution

Fluxo · Plug 2 Z-API

  Chip dedicado
       │ QR code
       ▼
  Z-API instance
       │ webhook (timeout 5s ⚠)
       ▼
  n8n workflow
       ├─ Respond 200 IMEDIATO ⚠
       ├─ Wait + processa em bg
       ├─ filter / buffer / histórico
       ├─ MiMo v2.5-pro
       └─ POST send-text → Z-API

Gotcha CRÍTICO: Z-API expira webhook em 5s. Workflow deve responder 200 ANTES de chamar IA, processar em background depois.

Plug 3 Cloud · 2 modos

Atendimento reativo (grátis)

  Cliente manda msg
       │
       ▼
  webhook Meta → n8n
       │
       ▼
  Janela 24h ABERTA
  responde livre
  (texto/áudio/img/botão)
       │
       ▼
  MiMo v2.5-pro
       │
       ▼
  POST /messages

Disparo ativo (pago)

  Schedule trigger
       │
       ▼
  Postgres SELECT leads
       │
       ▼
  Loop por lead:
   ├─ HTTP POST template HSM
   │  approved
   ├─ Delay 2-5s
   └─ Log no Postgres

Agente IA + RAG 2 camadas

Camada 1 · determinística

Postgres + SQL exato. Pra: preço, ID cliente, status, números autorizados.

latência < 10ms · alucinação ZERO

Camada 2 · semântica (RAG)

PGVector. Pra: playbooks, FAQ, objeções. Embedding 1x na ingestão · top-K filtrado por metadata.

latência 50-100ms · top-K relevante

Pipeline da resposta

  msg entra
   │
   ├─ filtro (grupo/fromMe/blacklist)
   ├─ Smart Redis Buffer (8s)
   ├─ Lookup Camada 1 (SQL)
   ├─ RAG Camada 2 (PGVector top-3)
   ├─ Histórico últimas 20
   ├─ MiMo v2.5-pro
   ├─ Postgres INSERT
   └─ HTTP POST → plug WhatsApp

POW · arquitetura Claude Code

  Você no Claude Code (laptop)
  ─────────────────────────────
  "dispara: oi galera"
  "kanban"                ──► agente .md
  "forecast"
       │
       ▼ Bash tool
  13 scripts Python stdlib
  urllib + sqlite3 + csv + re
       │
       ▼
  data.db (7 tabelas)
       │
       ▼ urllib HTTP
  Provider escolhido
  (Evolution / Z-API / Cloud / Zappfy)

Sem MCP custom · sem Docker · só Python stdlib + agente .md em .claude/agents/

Fluxo · campanha de live (D-7 → D0)

  D-7  ► Grava 5 copies + agenda 5 jobs
            "agenda dispara amanhã 9h30..."
       │
       ▼  Watcher dispara automático em bg

  D-6/-5/-3/-1  ► Notificação Telegram:
            "✅ Campanha D-X disparada"
       │
       ▼

  D-1 18h  ► "pull inbox && triage"
            47 inbound · 12 → SQL
       │
       ▼

  D0 19h   ► "kanban"
            SQL (47) prontos pra ofertar
       │
       ▼

  D0 20h   ► Live abre com 47 leads quentes

  Pedro durante a campanha: 5 min/dia.