> **Can't find what you're looking for?** Use `search_docs` on the docs MCP server at `https://naturgy-comer-documentation-p5mde.vercel.app/api/mcp` to find what you need.

# TeLeo

TeLeo es la consola web de atención humana para las conversaciones de texto
escaladas desde Super App. El cliente mantiene su canal de chat; TeLeo recibe el
contexto mínimo, permite que una persona continúe la conversación y devuelve las
respuestas públicas al workflow de HappyRobot.

Este es el subdominio de TeLeo dentro de [Super App](/use-cases/super-app). Su
propósito es reunir en un único lugar el modelo de ticket, la operación de la
cola, los contratos de integración, la seguridad y las pruebas. TeLeo no es un
workflow conversacional, no sustituye al Dispatcher y no es el canal de voz de
Connect.

## Estado documental

| Área | Estado | Lectura correcta |
|---|---|---|
| Consola humana de texto | As-is documentado | La aplicación y su modelo de atención están descritos; el entorno y los permisos efectivos deben confirmarse antes de ampliar tráfico. |
| Ticketing | As-is documentado | Un ticket une sesión, cliente, contexto, mensajes, asignación y ciclo de vida. |
| Datos | As-is documentado | La app utiliza HappyRobot Twin; no mantiene una base de datos de negocio propia. |
| Integración con HappyRobot | As-is con contrato por validar | Existen fronteras de ingesta, mensajes, webhooks y señales; cada tenant debe validarlas. |
| Omega | Integración acotada | Se documenta el enlace saliente a la ficha cuando llega un identificador autorizado; no se asume un iframe ni un token de agente. |
| Roadmap | To-be / histórico | Las fases futuras no demuestran capacidades publicadas. |

## Qué contiene este subdominio

| Tipo | Para qué sirve | Entrada |
|---|---|---|
| Tutoriales | Recorrer un escalado completo como agente | [Tutoriales de TeLeo](/use-cases/super-app/teleo/tutorials) |
| Guías prácticas | Integrar, operar, configurar y diagnosticar | [Guías prácticas de TeLeo](/use-cases/super-app/teleo/how-to) |
| Explicaciones | Entender arquitectura, ciclo, roles y seguridad | [Explicaciones de TeLeo](/use-cases/super-app/teleo/explanations) |
| Referencia | Consultar API, datos, estados, eventos y pruebas | [Referencia de TeLeo](/use-cases/super-app/teleo/reference) |

## Recorrido de alto nivel

```text
Cliente en Super App
  → workflow de texto
  → creación idempotente de ticket
  → consola TeLeo / cola de agentes
  → respuesta humana por webhook
  → cliente
```

La sesión de HappyRobot se correlaciona con un ticket y sus mensajes. Twin
almacena las entidades de la aplicación; Salesforce, Mulesoft, Omega y otros
backends siguen siendo propietarios de sus datos de negocio. La presencia de un
ticket o un `session_id` no autoriza el acceso a otra conversación.

## Límites importantes

* TeLeo atiende **texto**; la transferencia humana de voz sigue el recorrido de
  Connect.
* El workflow decide cuándo escalar, qué resumen entregar y qué fallback usar.
* La consola no autentica por sí sola al cliente ni confirma operaciones de
  negocio.
* Las etiquetas, carpetas y roles de la UI no sustituyen la autorización del
  backend.
* Las credenciales se mantienen en servicios server-only y nunca se copian en
  prompts, ejemplos, tickets de prueba o logs.
* Una implementación o un endpoint documentado no prueba que el tenant esté
  habilitado para producción.

Empieza por la [arquitectura de TeLeo](/use-cases/super-app/teleo/explanations/architecture)
o por el [primer recorrido de atención](/use-cases/super-app/teleo/tutorials/primer-recorrido).