# Kit de Operação Comercial — Hermes
Versão 1.0 · 05/11/2026

Pacote para replicar em outra VPS a operação que já roda aqui: prospecção por Instagram, WhatsApp e e-mail, com CRM, cadência e rotinas agendadas.

Não inclui credenciais. Todo acesso é configurado na VPS de destino, pelo dono da conta.

---

## 1. O que vem no kit

**Skills (14)** — conhecimento operacional que o agente carrega sozinho quando o assunto aparece:

- `whatsapp-send-operations` — envio e leitura de WhatsApp via Evolution API
- `gumercindo-commercial-ops` — pipeline comercial, cadência, linguagem de abordagem
- `instagram-api-publishing-operations` — publicação e limites da API do Instagram
- `instagram-content-positioning-operations` — posicionamento e conteúdo
- `social-selling-and-publishing` — operação de social selling
- `gumercindo-crm-operations` — CRM, estágios, ingestão de lead
- `email-operations` — IMAP/SMTP, triagem de caixa
- `client-video-edit-delivery` — edição de vídeo para cliente
- `video-post-production-operations` — pós-produção
- `native-mcp` — conexão de servidores MCP (Composio e outros)
- `self-hosted-docker-app-operations` — subir aplicação em Docker na VPS
- `validated-contact-list-operations` — construção de lista validada
- `agent-operations-playbook` — operação geral de agentes
- `agent-reach` — acesso a conteúdo web bloqueado

**Scripts**

- `ig_watch.py` + `ig_alvos.json` — vigia de conversas do Instagram por alvo
- `evolution_qr.py`, `evolution_status.py`, `evolution_paircode.py` — conexão da instância Evolution

---

## 2. Instalar o kit

```bash
mkdir -p /tmp/kit && tar -xzf kit-hermes-cliente.tar.gz -C /tmp/kit
```

```bash
mkdir -p ~/.hermes/skills ~/.hermes/scripts && cp -r /tmp/kit/kit-hermes-cliente/skills/* ~/.hermes/skills/ && cp /tmp/kit/kit-hermes-cliente/scripts/* ~/.hermes/scripts/
```

Depois, na sessão do Hermes:

```
/reload-skills
```

---

## 3. E-mail (o canal mais estável — começar por ele)

Preencha o bloco `EMAIL_*` no arquivo de ambiente:

```bash
nano $(hermes config env-path)
```

```
EMAIL_IMAP_HOST=imap.seudominio.com
EMAIL_IMAP_PORT=993
EMAIL_SMTP_HOST=smtp.seudominio.com
EMAIL_SMTP_PORT=587
EMAIL_USER=contato@seudominio.com
EMAIL_PASSWORD=senha-de-aplicativo
EMAIL_FROM=Nome <contato@seudominio.com>
```

Use **senha de aplicativo**, nunca a senha da conta. Em Gmail: Conta → Segurança → Verificação em duas etapas → Senhas de app.

Teste obrigatório antes de qualquer disparo: enviar um e-mail para o próprio endereço e ler de volta.

---

## 4. WhatsApp (Evolution API)

```bash
docker run -d --name evolution --restart always -p 127.0.0.1:8085:8080 -e AUTHENTICATION_API_KEY=troque-esta-chave -v evolution_data:/evolution/instances atendai/evolution-api:latest
```

Criar a instância:

```bash
curl -s -X POST http://127.0.0.1:8085/instance/create -H "apikey: SUA_CHAVE" -H "Content-Type: application/json" -d '{"instanceName":"cliente","qrcode":true,"integration":"WHATSAPP-BAILEYS"}'
```

Conectar (QR ou código de pareamento):

```bash
python3 ~/.hermes/scripts/evolution_qr.py
```

Webhook para o Hermes receber as mensagens:

```bash
curl -s -X POST http://127.0.0.1:8085/webhook/set/cliente -H "apikey: SUA_CHAVE" -H "Content-Type: application/json" -d '{"url":"http://127.0.0.1:8080/webhooks/evolution","webhookByEvents":false,"events":["MESSAGES_UPSERT","CONNECTION_UPDATE","SEND_MESSAGE"]}'
```

**Regra de operação:** as duas primeiras semanas em modo sombra — o agente registra e sugere, ninguém envia automático. Número novo que dispara no primeiro dia é banido.

---

## 5. Instagram (por último, de propósito)

Navegador dedicado, sem tocar no navegador de ninguém:

```bash
mkdir -p /opt/chrome-ig && google-chrome --headless=new --no-sandbox --disable-gpu --disable-dev-shm-usage --remote-debugging-port=9446 --user-data-dir=/opt/chrome-ig --window-size=1366x900 about:blank
```

O login é feito **manualmente** pelo dono da conta, com tela visível (VNC ou desktop da VPS). O agente nunca digita senha.

Limites que não se negociam:

- conta dedicada, nunca a principal
- 15 a 20 mensagens por dia, começando por 5
- nenhum link na primeira mensagem
- uma abordagem por perfil, sem repetição
- opt-out explícito e imediato

---

## 6. Composio (MCP)

```bash
hermes mcp add composio --url <URL_DO_SERVIDOR_COMPOSIO>
```

```bash
hermes mcp test composio
```

As conexões de cada app (Gmail, Drive, Instagram) são autorizadas pelo dono no painel do Composio — não por chave colada em chat.

---

## 7. CRM existente do cliente

O cliente **não precisa de um CRM novo**. Duas formas de ligar:

**A. Webhook (mais simples)** — o agente faz `POST` no endpoint do CRM a cada mudança de estágio:

```
POST https://crm-do-cliente/api/leads
{ "nome": "...", "telefone": "...", "canal": "instagram", "estagio": "respondeu", "observacao": "..." }
```

**B. API REST** — se o CRM tiver API, mapear os campos uma vez e registrar no `AGENTS.md` do projeto.

Em qualquer das duas: o CRM é a fonte da verdade. O agente não mantém lista paralela.

---

## 8. Rotinas agendadas

```bash
hermes cron create "every 20m"
```

Rotinas recomendadas:

- **Vigia de respostas** (20 min) — lê conversas, responde quem respondeu, registra no CRM
- **Prospecção** (dias úteis, 1x/dia) — aborda até 6 perfis novos com fit
- **Follow-up** (1x/dia) — retoma quem parou de responder em 2, 5 e 10 dias
- **Relatório** (1x/dia, fim do dia) — quantas abordagens, respostas, reuniões

---

## 9. Limites e segurança

- Nunca `GATEWAY_ALLOW_ALL_USERS=true` — allowlist por ID
- Nada é enviado sem aprovação humana nas primeiras semanas
- Limite diário por canal, aquecimento gradual
- Opt-out em toda mensagem; quem pede para sair sai na hora
- LGPD: só dado público de perfil; dado sensível fica no sistema do cliente
- Credencial só no `.env` (chmod 600), nunca em chat, planilha ou documento

---

## 10. Ordem de implantação

1. E-mail → valida a cadência inteira sem risco de bloqueio
2. WhatsApp → modo sombra, depois liberação gradual
3. Instagram → conta dedicada, rampa de 5 para 20 por dia
4. CRM → conectar na etapa 1, antes de qualquer envio
5. Rotinas → só depois que o canal está estável