Kit de Operação Comercial — Hermes

Prospecção por e-mail, WhatsApp e Instagram com CRM, cadência e rotinas agendadas. Versão 1.0 · 05/11/2026
Baixar o pacote (.tar.gz) Ver manual completo
O pacote tem 14 skills e 5 scripts. Não contém nenhuma credencial — todo acesso é configurado na VPS de destino, pelo dono da conta.

Operação pronta (subir isto primeiro)

As skills ensinam o agente. Este pacote executa: dispara a abordagem, espera, lê a resposta, registra no CRM e continua a conversa — com painel para acompanhar quem entrou.

Baixar ops-kit.tar.gz Manual da operação 
tar -xzf ops-kit.tar.gz -C /opt && cd /opt/ops-kit && bash install.sh
Depois do install, para ligar todas as integrações de uma vez (Composio, WhatsApp/Evolution e tela virtual para Instagram):
bash /opt/ops-kit/setup_completo.sh tudo
O kit nasce em simulação: DRY_RUN=1. Nada sai de verdade até você trocar para 0 no .env. O instalador mostra a senha do painel uma única vez.

Instalar as skills

Envie o arquivo para a VPS e rode:

mkdir -p /tmp/kit && tar -xzf kit-hermes-cliente.tar.gz -C /tmp/kit
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/

Na sessão do Hermes, recarregar as skills:

/reload-skills

2. E-mail (começar por aqui)

Preencher o bloco EMAIL_*. Use senha de aplicativo, nunca a senha da conta.

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>
Teste obrigatório: envie um e-mail para o próprio endereço e leia de volta antes de qualquer disparo.

3. WhatsApp (Evolution API)

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
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"}'
python3 ~/.hermes/scripts/evolution_qr.py
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"]}'
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.

4. Instagram (por último)

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. O agente nunca digita senha. Conta dedicada, nunca a principal. Começar com 5 mensagens/dia, teto de 20.

5. Composio (MCP)

hermes mcp add composio --url URL_DO_SERVIDOR_COMPOSIO
hermes mcp test composio

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

6. CRM do cliente

O cliente continua no CRM que já usa. O agente só faz POST no endpoint existente a cada mudança de estágio — ou usa a API REST, se houver. O CRM é a fonte da verdade; o agente não mantém lista paralela.

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

7. Rotinas agendadas

hermes cron create "every 20m"

8. Segurança