> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thaliq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Inbox

> Atende conversaciones que requieren intervencion humana — asignacion, reasignacion, mensajes en vivo

El **Inbox** (`thaliq.com/workspace/inbox`) es donde el equipo humano atiende las conversaciones que el agente no puede resolver solo o que fueron explicitamente escaladas.

<Info>
  El Inbox es **chat-first**: la lista de conversaciones esta a la izquierda, el chat panel a la derecha, y los mensajes humanos llegan en tiempo real via SSE.
</Info>

## Quien ve el Inbox

| Rol                            | Ve                                                                 |
| ------------------------------ | ------------------------------------------------------------------ |
| **AGENT**                      | Solo las conversaciones asignadas a el                             |
| **SUPERVISOR · ADMIN · OWNER** | Todas las conversaciones del tenant + tabs assigned/unassigned/all |
| **EDITOR · VIEWER**            | No ven Inbox                                                       |

Los SUPERVISORs ademas ven team stats agregados (carga por agente humano, tiempo de respuesta promedio, etc.).

## Tabs del Inbox

| Tab             | Contenido                                                    |
| --------------- | ------------------------------------------------------------ |
| **Asignadas**   | Conversaciones que tenes a tu cargo                          |
| **Sin asignar** | Conversaciones liberadas o escaladas que esperan ser tomadas |
| **Todas**       | Todas las conversaciones activas (solo SUPERVISOR+)          |

## Tomar una conversacion

1. Click en la tab **Sin asignar**
2. Seleccionar la conversacion
3. Click en **Tomar** — la conversacion queda asignada a vos y la IA pausa
4. Empezas a chatear como humano. El usuario final ve los mensajes con identificacion de "agente humano"

## Reasignar y liberar

| Accion        | Efecto                                                                                 |
| ------------- | -------------------------------------------------------------------------------------- |
| **Reasignar** | Pasa la conversacion a otro miembro (SUPERVISOR+)                                      |
| **Liberar**   | Devuelve el control a la IA — la conversacion sigue, el agente toma el siguiente turno |

## SSE en tiempo real

El Inbox suscribe a dos streams via Server-Sent Events:

* **Por conversacion** — eventos de la conversacion abierta (mensajes nuevos, status, asignacion)
* **Tenant-wide** — para SUPERVISORs, eventos de todas las conversaciones del tenant en paralelo

Esto significa que no hay polling: cuando llega un mensaje nuevo o cambia el status, la UI se actualiza al instante.

## Como llega una conversacion al Inbox

Hay dos caminos:

1. **Escalada explicita** — el agente, via instruccion o tool, decide pasar la conversacion a humano (`handoff`).
2. **Action rechazada con `onReject: stop`** — si una accion HITL es rechazada con `stop`, la conversacion se pausa esperando intervencion.

En ambos casos la conversacion aparece en **Sin asignar** hasta que alguien la toma.

## Intervencion humana mid-stream

Cuando un humano toma una conversacion:

* La IA deja de generar respuestas automaticas
* Los mensajes que envia el humano se persisten en DynamoDB con marca `human`
* El usuario final ve un mensaje "estas hablando con un agente humano"
* Al **liberar**, la IA retoma con el contexto completo (incluyendo lo que dijo el humano)

## Que sigue

<CardGroup cols={2}>
  <Card title="Instrucciones HITL" icon="list-check" href="/platform/instructions">
    Como configurar acciones interactivas que pueden escalar a humano.
  </Card>

  <Card title="Team" icon="users" href="/platform/team">
    Roles y permisos del equipo humano.
  </Card>
</CardGroup>