Añade docs/retell-setup.md: guía de activación del agente de voz
Pasos en el panel de Retell, prompt del agente listo para pegar (con las
variables dinámicas {{empresa_nombre}}/{{cliente_nombre}}/{{tipo_reforma}}/
{{provincia}}), variables que envía la app, compliance pendiente y cómo se
conecta (RETELL_API_KEY/FROM_NUMBER/AGENT_ID en Dokploy).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Carlos Narro
90
docs/retell-setup.md
Normal file
90
docs/retell-setup.md
Normal file
@@ -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`.
|
||||
Reference in New Issue
Block a user