Assessor Pessoal

Assistente pessoal IA via WhatsApp (Evolution API). Processa mensagens recebidas, consulta base de conhecimento em PostgreSQL, responde via Claude e executa tarefas de produtividade.

Stack: Node.js + Express

IA: Anthropic Claude

Canal: WhatsApp via Evolution API

Banco: PostgreSQL

Porta: 3002

Express Anthropic Claude SDK Evolution API (WhatsApp) PostgreSQL node-cron

Especificação do Produto

Missão

Agente IA orquestrador da BlackCat (Claudinho) — gerencia tarefas, memória, comunicação entre agentes e briefings do Victor.

Usuários-alvo

Victor Martucci

Status

✅ Ativo 24/7 — via Telegram e WhatsApp

Funcionalidades principais

Morning briefing diário (05:50 BRT) via WhatsApp
Orquestração de agentes especializados (Beatriz, Lucas, Alex, Jota)
Memória persistente entre sessões
Integração com todos os projetos BlackCat
Heartbeat de monitoramento
Gestão de lembretes e crons
Delegação inteligente de tarefas

Próximos passos

Painel web de controle do agente
Histórico de conversas searchable
Métricas de uso por agente

Endpoints

GET/health

Healthcheck: {"ok": true, "service": "assessor-pessoal"}

POST/webhook

Webhook da Evolution API. Recebe mensagens WhatsApp, processa com Claude e responde.

Fluxo: Recebe mensagem → identifica usuário autorizado → consulta histórico no DB → chama Claude → responde via Evolution API.

Variáveis de Ambiente

Variável	Descrição
ANTHROPIC_API_KEY	Chave da API Claude (Anthropic)
ANTHROPIC_MODEL	Modelo Claude a usar
EVOLUTION_API_URL	URL base da Evolution API
EVOLUTION_API_KEY	Chave de autenticação Evolution
EVOLUTION_INSTANCE	Instância WhatsApp na Evolution
NUMERO_VICTOR	Número WhatsApp autorizado do Victor
DATABASE_URL	PostgreSQL connection string
PORT	Porta do servidor (padrão: 3002)

Arquitetura

WhatsApp ──► Evolution API ──► /webhook (assessor-pessoal:3002)
                                     │
                              PostgreSQL (contexto/histórico)
                                     │
                              Anthropic Claude API
                                     │
                              Evolution API ──► WhatsApp (resposta)

Gerado automaticamente — BlackCat Corp • Voltar ao índice