# Deteccao: Stack WhatsApp

Define em qual runtime o bot vai rodar. Decisao MAIS importante da entrevista — muda 100% do codigo gerado.

## 3 stacks suportadas

### 1. Evolution API (recomendado padrao)

**O que e:** servidor self-hosted (Docker) baseado em Baileys. Conecta no WhatsApp Web via QR Code. Vira API REST + webhook.

**Quando recomendar:**
- Mentorada tem VPS (Hostinger, DigitalOcean, AWS)
- Volume <10k msgs/mes
- MVP / primeira automacao
- Quer maximo controle e flexibilidade
- Bolso apertado

**Quando NAO recomendar:**
- Sem time tecnico minimo
- Ticket >R$5k onde 1 ban custa demais
- Volume >50k msgs/mes
- Regulamentacao estrita (saude, financas)

**Custo:** VPS R$30-80/mes (suporta Evolution + bot + Redis). Zero por mensagem.

**Risco:** ban do numero. Mitigavel com:
- Aquecimento 15 dias (REGRA #5)
- Anti-ban playbook (`engine/anti-ban.md`)
- Limites diarios respeitados
- Multi-instancia (`engine/multi-instancia.md`)

**Setup tipico:** Docker Evolution → Webhook na VPS da mentorada → Bot Node.js → Claude/Gemini → SQLite/Postgres.

### 2. Cloud API oficial Meta

**O que e:** API oficial da Meta (Facebook). WhatsApp Business legalmente aprovado. Sem risco de ban.

**Quando recomendar:**
- Volume alto previsto (>5k msgs/mes)
- Ticket alto (>R$3k) — 1 cliente paga o ano de API
- Empresa formalizada (CNPJ obrigatorio)
- Zero tolerancia a downtime
- Setores regulados (saude, financeiro, juridico)

**Quando NAO recomendar:**
- MVP / teste de hipotese
- Volume baixo (<2k msgs/mes — fica caro)
- Quer iniciar conversa fria (templates demoram pra aprovar)

**Custo:** ~R$0,40 por **conversa de 24h** (nao por mensagem). 1000 leads/mes = ~R$400/mes.

**Limites criticos:**
- **Janela de 24h:** apos o lead mandar uma msg, voce tem 24h pra responder livre. Depois disso, so via template aprovado.
- **Templates aprovados:** pra iniciar conversa ou reabrir apos 24h, mensagem precisa ser pre-aprovada pela Meta (24-72h de revisao).
- **Categorias:** marketing, utility, authentication. Cada uma tem regras diferentes.

**Setup tipico:** Meta Business Manager → Phone Number aprovado → Webhook verificado pela Meta → Bot Node.js → Claude/Gemini → Postgres.

### 3. Z-API / UltraMsg / outros providers gerenciados

**O que e:** servico de terceiro que gerencia a infra de WhatsApp por voce. Voce so consome API.

**Quando recomendar:**
- Mentorada sem time tecnico
- Quer comecar HOJE sem dor de cabeca de Docker/VPS
- Volume pequeno-medio (1k-20k msgs/mes)
- Aceita custo recorrente

**Quando NAO recomendar:**
- Volume alto (custo escala)
- Precisa de feature que o provider nao oferece
- Quer migrar de provider depois (vendor lock-in)

**Custo:** R$120-300/mes dependendo do plano e provider.

**Risco:** depende do provider. Z-API tem reputacao melhor que outros.

**Setup tipico:** assina o provider → conecta via QR Code → webhook do provider chama seu bot → bot Node.js → AI → CRM.

## Como decidir (arvore de decisao)

```
Volume mensal esperado?
├─ <2k msgs → Evolution API (custo baixo, MVP)
├─ 2k-10k msgs → Evolution OU Z-API (depende de time tecnico)
├─ 10k-50k msgs → Cloud API (custo justifica + zero ban)
└─ >50k msgs → Cloud API obrigatorio
```

```
Ticket medio?
├─ <R$500 → Evolution ou Z-API (custo de Cloud API mata margem)
├─ R$500-R$3k → Evolution se tem time, Cloud API se tem dinheiro
└─ >R$3k → Cloud API recomendado (1 venda paga meses de API)
```

```
Tolerancia a risco de ban?
├─ Alta (MVP, teste) → Evolution
├─ Media (operacao em crescimento) → Evolution com anti-ban rigoroso
└─ Zero (negocio dependente) → Cloud API
```

## Perguntas pra fazer na entrevista

1. **Qual seu volume esperado de mensagens por mes?** (faixas: <2k, 2-10k, 10-50k, >50k)
2. **Voce tem VPS rodando hoje?** (Sim/Nao → se sim, Evolution e tranquilo)
3. **Voce tem CNPJ ativo?** (Cloud API exige CNPJ)
4. **Qual seu ticket medio?** (define se custo de Cloud API faz sentido)
5. **Voce ja teve numero banido antes?** (se sim, FORCAR Cloud API)
6. **Qual setor?** (saude/financeiro/juridico → forte sugestao Cloud API)

## Override

Mentorada pode forcar uma escolha. Skill avisa risco mas respeita decisao.

Excecao: se setor for regulado (saude/financeiro) E ticket >R$5k, skill RECUSA Evolution e exige Cloud API.

## Output

Salva em `briefing.md` como:

```yaml
stack_whatsapp:
  escolhida: evolution | cloud_api | z_api
  razao: "volume baixo + MVP" | "ticket alto + setor regulado" | "sem time tecnico"
  custo_estimado_mes: R$ 60
  risco_ban: baixo | medio | alto | zero
  setup_minutos: 60 (Evolution) | 120 (Cloud API + BSP) | 30 (Z-API)
```

Skill usa esse output pra escolher `templates/runtime-evolution/` OU `templates/runtime-cloud-api/`.
