Turnia Salud

Agentes de IA que atienden el WhatsApp (texto y audios) y el teléfono de clínicas y consultorios las 24 horas: dan turnos sobre la agenda real, confirman, cancelan, reprograman, toman datos de admisión, derivan urgencias y le escriben a los pacientes para llenar la agenda (recall, lista de espera, recordatorios, ausentes, reactivación).

Inspirado en el core de Assort Health, adaptado a Argentina: WhatsApp primero, obras sociales y prepagas, voseo.

Producto	Qué hace	Dónde está
Turnia Recepción (inbound)	Turnos 24/7, confirmación de asistencia, triage, FAQ, fuera de horario, recetas y pedidos → tareas, derivación a una persona	Agente en ElevenLabs + src/app/api/agent/tools
Turnia Activa (outbound)	Recall, lista de espera automática al cancelar, recordatorios, ausentes, reactivación, encuesta post-consulta	src/lib/campaigns.ts, panel → Campañas, n8n/
Turnia Circuitos	Admisión (DNI, cobertura, plan, afiliado, foto de credencial), órdenes médicas e indicaciones previas	herramienta registrar_paciente + prompt
Turnia Equipo	Bandeja de tareas con respuesta al paciente por WhatsApp, transcripciones, resúmenes, métricas, memoria del paciente	Panel /panel

Cómo funciona

Paciente (WhatsApp / teléfono / web)
        │
        ▼
ElevenLabs Agent ──(1) webhook de inicio──► /api/elevenlabs/initiation   → memoria del paciente + catálogo
        │        ──(2) herramientas───────► /api/agent/tools/*            → turnos, admisión, tareas (Postgres)
        │        ──(3) post-conversación──► /api/elevenlabs/post-call     → transcripción, resumen, métricas
        ▼
Panel de la clínica (/panel)        n8n ◄── eventos (turno reservado, tarea urgente…)
                                    n8n ──► /api/automations/*  (recordatorios, recall… programados)

• Stack: Next.js 16 (Vercel) · Postgres (Neon o Supabase, conexión directa con DATABASE_URL) · ElevenLabs Agents (voz + WhatsApp) · n8n (automatizaciones).
• La lógica delicada (no dar dos veces el mismo turno, horarios por profesional, feriados, coberturas) vive en el código y en la base (una constraint de Postgres impide turnos superpuestos).
• n8n queda para lo que más vas a querer tocar sin código: horarios de las campañas y avisos al equipo.

---

Puesta en marcha (sin programar)

1. Base de datos (Postgres)

La app se conecta directo a Postgres con una sola variable, DATABASE_URL, solo desde el servidor.

Neon (la que usa este deploy, gratis desde Vercel):

1. En Vercel → tu proyecto → Storage → Create Database → Neon. La integración carga sola DATABASE_URL en Vercel.
2. En Neon → SQL Editor, pegá todo supabase/schema.sql y tocá Run.
3. (Para probar) Nueva query con supabase/seed.sql → Run. Crea una clínica demo con 4 profesionales, horarios y pacientes ficticios. Si la clínica demo ya existe, no la toca.

Supabase (alternativa): corré los mismos dos archivos en Supabase → SQL Editor y cargá en Vercel como DATABASE_URL la cadena de Project Settings → Database → Connection string → Transaction pooler (puerto 6543).

Después de la primera vez no hace falta volver a pegarlo: cada deploy de producción en Vercel aplica schema.sql solo, antes del build (scripts/migrate-db.mjs, en una transacción). Crea lo que falta y actualiza bases de versiones anteriores sin borrar datos; nunca corre seed.sql. En el log del build aparece [db] Base actualizada…. Si la base no responde, el build se corta y queda publicado el deploy anterior (para publicar igual: SKIP_DB_MIGRATION=1 en Vercel). Los previews no tocan la base. A mano: DATABASE_URL=… npm run db:migrate.

2. Deploy en Vercel

1. En Vercel: Add New → Project → Import este repositorio de GitHub.
2. En Environment Variables cargá (ver .env.example):

Variable	De dónde sale
DATABASE_URL	La carga la integración de Neon (o la cadena del pooler de Supabase)
ELEVENLABS_API_KEY	ElevenLabs → Developers → API Keys
AGENT_TOOLS_SECRET	Inventalo: un texto largo y aleatorio
PANEL_PASSWORD	La contraseña que quieras para el panel
ELEVENLABS_WEBHOOK_SECRET	Lo obtenés en el paso 3 (podés agregarlo después)

3. Deploy. Cuando termine, abrí https://tu-app.vercel.app/panel e ingresá con PANEL_PASSWORD.

3. Agente en ElevenLabs

1. En el panel → Configuración → Crear / actualizar agente. Esto crea en tu cuenta de ElevenLabs el agente "Turnia · …" con sus 10 herramientas, el prompt en rioplatense, una voz argentina y el webhook de inicio. Si cargaste un teléfono para pasar llamadas, suma la transferencia a una persona (solo en llamadas).
2. En ElevenLabs → Agents → Settings → Post-call webhook: creá un webhook con la URL https://tu-app.vercel.app/api/elevenlabs/post-call. Copiá el secreto que te muestra, cargalo en Vercel como ELEVENLABS_WEBHOOK_SECRET y hacé Redeploy.
3. Ingresá al panel y probalo en https://tu-app.vercel.app/demo (chat o voz). La demo requiere sesión del panel. Los turnos que reserves aparecen en el panel → Agenda, y la conversación en → Conversaciones.

Cada vez que cambies datos de la clínica (horarios, feriados, precios, textos) no hace falta tocar nada: el agente los lee al empezar cada conversación. Solo volvé a tocar Crear / actualizar agente si cambia la URL de la app, el teléfono para pasar llamadas o actualizás el código.

4. WhatsApp

Hay dos formas de conectarlo. Se elige en Panel → Configuración → Cómo se conecta WhatsApp:

This is the beginning of the README. Read the rest at the original. Read the full README ↗