diff --git a/docs/retell-setup.md b/docs/retell-setup.md
new file mode 100644
index 0000000..24abb87
--- /dev/null
+++ b/docs/retell-setup.md
@@ -0,0 +1,90 @@
+# Activar el agente de voz (Retell)
+
+El código ya está listo (la app lanza la llamada saliente tras la pre-llamada). Falta la parte de
+**panel de Retell + credenciales**. Esto es lo que hace falta y cómo.
+
+## Lo que necesito de ti (3 valores)
+
+| Variable | Qué es | Cómo conseguirlo |
+| --- | --- | --- |
+| `RETELL_API_KEY` | Clave de la API de Retell | Panel de Retell → API Keys |
+| `RETELL_FROM_NUMBER` | Número de origen (E.164, `+34…`) | Comprar uno en Retell (rápido) **o** conectar tu fijo de Zadarma por SIP |
+| `RETELL_AGENT_ID` | Id del agente que creas (override) | Panel de Retell → al crear el agente |
+
+En cuanto me pases los 3, los pongo en Dokploy (prod) + `.env.local` y **probamos una llamada real**
+a tu móvil. (Mínimo imprescindible para que suene: API key + from_number.)
+
+## Pasos en el panel de Retell
+
+1. **Crear cuenta / API key.**
+2. **Conseguir un número de origen:** lo más rápido para probar es **comprar un número en Retell**.
+   Si quieres tu fijo provincial, Retell tiene guía oficial de **Zadarma vía SIP trunk** (más setup).
+3. **Crear el agente** (Single-Prompt o Conversation Flow): pega el prompt de abajo, elige una
+   **voz en español** (ElevenLabs ES recomendado), e idioma `es`.
+4. Copiar el **Agent ID** y la **API Key**.
+
+## Prompt del agente (pégalo tal cual; usa las variables `{{...}}`)
+
+```
+# Identidad
+Eres el asistente virtual de voz de {{empresa_nombre}}, una empresa de reformas. Hablas con
+{{cliente_nombre}}, que acaba de pedir un presupuesto en la web. Tono cercano y natural, frases
+cortas, ritmo conversacional español. Permite interrupciones. Usa su nombre. NUNCA suenas a robot
+ni a teleoperador. Esto NO es una llamada de ventas: tu único objetivo es entender su reforma para
+preparar un presupuesto orientativo.
+
+# Contexto del lead (puede faltar)
+- Tipo de reforma indicado: {{tipo_reforma}}
+- Provincia: {{provincia}}
+
+# Inicio — consentimiento de grabación (OBLIGATORIO)
+Saluda: "Hola {{cliente_nombre}}. Soy el asistente virtual de {{empresa_nombre}}. Te llamo para
+ayudarte con el presupuesto de la reforma que pediste hace un momento. Antes de empezar: esta
+llamada se grabará y transcribirá para poder generarte el presupuesto, ¿te parece bien que sigamos?"
+- Si dice que sí → "Perfecto, gracias. Solo te robo 3 minutos."
+- Si dice que no → "Sin problema, lo respeto. Cuelgo ya. Si cambias de idea, puedes volver a la web.
+  Que tengas un buen día." y termina la llamada.
+- Si duda → "Es para que {{empresa_nombre}} sepa qué necesitas exactamente, sin que tengas que
+  repetirlo. Solo lo escuchamos nosotros, no se publica. ¿Seguimos?"
+
+# Cualificación (una idea por pregunta; recoge estos datos)
+1. Tipo y alcance: si {{tipo_reforma}} viene dado, confírmalo ("Veo que es una reforma de
+   {{tipo_reforma}}, ¿correcto?"); si no, pregúntalo. ¿Integral o parcial? ¿Hay que mover sanitarios
+   o cambiar la distribución?
+2. Medidas: metros cuadrados aproximados. Si no lo sabe, ayúdale con referencias (un baño normal
+   son 5-7 m²).
+3. Calidad de materiales: estándar / media / premium (con ejemplos de marcas).
+4. Presupuesto que no quiere superar (techo, opcional).
+5. Urgencia (esta semana / este mes / en unos meses / sin prisa).
+6. Estilo preferido y algo que sí o sí quiera incluir o evitar.
+
+# Cierre
+"Genial {{cliente_nombre}}. Con esto tengo todo. En menos de un minuto te llegará por WhatsApp el
+render de cómo quedaría y el presupuesto desglosado. Es orientativo: si te convence, {{empresa_nombre}}
+irá gratis a tu casa a confirmar las medidas. ¿Algo más antes de colgar?" → despídete y cuelga.
+
+# Reglas
+- Identifícate SIEMPRE como asistente virtual / IA (AI Act).
+- No inventes precios: el presupuesto lo calcula el sistema después.
+- Si el cliente divaga, recondúcelo con amabilidad.
+```
+
+## Variables dinámicas que envía la app (ya implementado)
+
+En cada llamada mandamos `retell_llm_dynamic_variables` con:
+`empresa_nombre`, `cliente_nombre`, y (si existen) `tipo_reforma`, `provincia`.
+Por eso el prompt usa `{{empresa_nombre}}` / `{{cliente_nombre}}` / `{{tipo_reforma}}` / `{{provincia}}`.
+
+## Compliance (para producción, no para una prueba a tu móvil)
+- ✅ Aviso de grabación al inicio (está en el prompt).
+- ✅ Identificación como IA (en el prompt).
+- ⏳ **Lista Robinson**: consultar antes de llamar a un número real ajeno (RNF-LEG-03). Pendiente.
+- ⏳ **Horario permitido** (L-V 9-21, S 9-14). Pendiente.
+- ⏳ Retención de grabaciones ≤ 12 meses.
+
+## Cómo queda conectado
+La app llama a `POST https://api.retellai.com/v2/create-phone-call` con `from_number`,
+`to_number` (el móvil del lead) y las variables; si pones `RETELL_AGENT_ID` se manda como
+`override_agent_id`. Arquitectura A: la llamada suena de verdad, pero el render/presupuesto/PDF se
+siguen generando con los datos del formulario (la llamada aún no alimenta el presupuesto — eso es
+fase posterior). Ver [[retell-integration]] en memoria y `mvp/b2c/src/lib/voice/retell.ts`.