Ia Vendedora Clinica Langgraph — Development skill for Claude Code

Agente IA — Clínica Moreira

Agente de IA baseado em LangGraph para a Clínica Moreira (clínica odontológica). Gerencia agendamentos via WhatsApp através de webhooks do Chatwoot, com transcrição de áudio, respostas por TTS e follow-ups automáticos.

Convertido dos workflows originais em n8n para uma arquitetura baseada em grafos com TypeScript.

Stack

• Runtime: Bun
• HTTP: ElysiaJS
• Orquestração: LangGraph com checkpointing em PostgreSQL
• LLM: OpenAI (GPT para agente + Whisper para transcrição)
• TTS: ElevenLabs
• CRM/Mensageria: Chatwoot (WhatsApp)
• Calendário: Google Calendar API
• Observabilidade: Langfuse (opcional)
• Banco de dados: PostgreSQL 16

Pré-requisitos

• Bun >= 1.0
• PostgreSQL 16+ (ou Docker)
• Contas nos serviços externos: OpenAI, Chatwoot, Google Calendar, ElevenLabs

Início Rápido

# 1. Clone o repositório
git clone 
cd claude-code-com-lucao

# 2. Instale as dependências
bun install

# 3. Configure as variáveis de ambiente
cp .env.example .env
# Edite .env com suas credenciais

# 4. Suba o PostgreSQL (via Docker)
docker compose up -d

# 5. Crie as tabelas no banco
bun run setup

# 6. Inicie o servidor
bun run dev

O servidor estará disponível em `http://localhost:3000`.

Scripts

Comando	Descrição
bun run dev	Servidor com hot reload (--watch)
bun run start	Servidor em modo produção
bun run setup	Cria as tabelas no PostgreSQL
bun run typecheck	Verificação de tipos TypeScript
bun test	Executa todos os testes
bun run visualize	Gera visualização dos grafos

Arquitetura

Grafo Principal (`src/graphs/main-agent/`)

Processa mensagens recebidas do Chatwoot em um pipeline de 16 nós:

enfileirar → esperarDebounce(16s) → verificarStale → tentarLock [→ esperarRetry ↩]
→ buscarReferenciada