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

# Atención humana con Jelou

> Transfiere la conversación desde el workflow a la Bandeja de entrada de Jelou, con asignación directa o por cola.

El nodo **Jelou** es la opción nativa de atención humana: entrega la conversación a un operador dentro de la **Bandeja de entrada** de Jelou. Lo usas cuando tu equipo atiende directamente desde Jelou y quieres que el workflow decida cuándo escalar y a quién.

Al ejecutarse, el nodo mueve la sesión del usuario a la Bandeja de entrada y termina la ejecución del workflow. Desde allí, el operador atiende directamente. Si el usuario debe volver a un flujo automatizado, se hace derivando la conversación a otro workflow desde la Bandeja de entrada — no ocurre automáticamente al cerrar el caso.

<Note>
  Este nodo aparece en la barra inferior bajo **Atención humana > Jelou**. Es la misma capacidad histórica del nodo **Transferir a asesor**, empaquetada dentro del menú de handoff junto con HubSpot y Genesys.
</Note>

***

## Requisitos previos

* Al menos un **operador activo** en la Bandeja de entrada.
* Si vas a asignar por equipo, tener el equipo creado en **Configuración > Equipos**.
* El canal del workflow debe estar conectado a un canal soportado por el panel (por ejemplo, WhatsApp o Web Widget). Los canales **Slack**, **Teams** y **Custom** no admiten este nodo.

***

## Configuración

El panel del nodo se organiza en tres pestañas:

* **Configuración** — define cómo se asigna la conversación al operador.
* **Avanzado** — controla el comportamiento cuando la asignación falla y el manejo de errores por defecto.
* **Eventos** — registra eventos de seguimiento para tus métricas.

### Tipo de asignación

Define cómo llega la conversación al operador:

| Tipo        | Comportamiento                                                                                                    |
| :---------- | :---------------------------------------------------------------------------------------------------------------- |
| **Directa** | La conversación entra directo a la bandeja del operador seleccionado.                                             |
| **Cola**    | La conversación entra a una cola de espera; el operador la toma manualmente desde la bandeja general o de equipo. |

### Asignar por

Determina el destinatario según el tipo elegido.

**Cuando el tipo es Directa:**

| Opción        | Descripción                                                                                          |
| :------------ | :--------------------------------------------------------------------------------------------------- |
| **Equipo**    | Se asigna a un miembro del equipo elegido. Tienen prioridad los operadores con menos chats abiertos. |
| **Operador**  | Se asigna a un operador específico.                                                                  |
| **Aleatorio** | Se elige al azar entre operadores activos, priorizando a los que tienen menos carga.                 |

**Cuando el tipo es Cola:**

| Opción      | Descripción                                                                     |
| :---------- | :------------------------------------------------------------------------------ |
| **General** | Cae en la cola general; cualquier operador puede tomarla.                       |
| **Equipo**  | Cae en la cola de un equipo específico; solo los miembros de ese equipo la ven. |

### Prioridad (solo en Cola)

Un slider de **0 a 10** que define la urgencia dentro de la cola:

* **0** — Urgente. Se atiende primero.
* **10** — Prioridad más baja.

Úsalo para que casos sensibles (pagos, reclamos, VIP) se muestren arriba en la bandeja del equipo.

***

## Salidas del nodo

El nodo Jelou expone una salida de éxito y varias salidas de error, cada una conectable a un flujo distinto de recuperación:

| Salida                     | Cuándo se activa                                                              |
| :------------------------- | :---------------------------------------------------------------------------- |
| **Asignación exitosa**     | La conversación entró correctamente al panel y quedó asignada o en cola.      |
| **Operador no encontrado** | El operador o equipo configurado no existe o no está activo.                  |
| **Fuera de horario**       | No hay operadores dentro del horario definido para el equipo.                 |
| **Error general**          | Cualquier otro fallo de la asignación no cubierto por las salidas anteriores. |

<Tip>
  Conecta cada salida de error a un mensaje distinto: por ejemplo, "estamos fuera de horario, escríbenos entre 9:00 y 18:00" para **Fuera de horario**, y un mensaje genérico de reintento para **Error general**.
</Tip>

***

## Pestaña Avanzado

### Crear conversación cuando no sea posible asignar

Toggle que controla qué pasa cuando la asignación falla:

* **Activado (por defecto)** — Se crea un registro en la bandeja **"Por recuperar"** de Monitoreo. Un supervisor puede retomar el caso manualmente.
* **Desactivado** — La conversación no queda registrada en Monitoreo si no logra asignarse.

<Warning>
  Desactivar este toggle hace que las conversaciones no asignadas se pierdan del panel de Monitoreo. Úsalo solo si tienes un mecanismo alterno de seguimiento (por ejemplo, un webhook o una base de datos).
</Warning>

### Manejo de errores por defecto

Define el nodo al que debe saltar el workflow cuando ocurre un error que no tenga una salida específica conectada. Sirve como red de seguridad para no dejar la conversación sin respuesta.

***

## Casos de uso

<AccordionGroup>
  <Accordion title="Un flujo con varios equipos: usa un Condicional antes del handoff">
    Un workflow que atiende ventas, soporte y reclamos con **un único nodo Jelou** en lugar de tres workflows separados.

    Antes del handoff, un nodo **Condicional** evalúa una variable como `{{$memory.motivo_contacto}}` y guarda el equipo destino en `{{$memory.equipo_destino}}`. Luego, en el nodo Jelou:

    * **Tipo de asignación**: Directa
    * **Asignar por**: Equipo
    * **Equipo**: `{{$memory.equipo_destino}}`

    | Camino del Condicional | Regla                                           | Valor guardado en `{{$memory.equipo_destino}}` |
    | :--------------------- | :---------------------------------------------- | :--------------------------------------------- |
    | Ventas                 | `{{$memory.motivo_contacto}}` igual a `venta`   | `Ventas`                                       |
    | Soporte                | `{{$memory.motivo_contacto}}` igual a `soporte` | `Soporte Técnico`                              |
    | Reclamos               | `{{$memory.motivo_contacto}}` igual a `reclamo` | `Postventa`                                    |
    | **Si no**              | —                                               | `Atención General`                             |

    El workflow enruta a los tres equipos con un solo nodo de handoff. Mantener la lógica en un Condicional evita duplicar el flujo por cada equipo y facilita agregar un cuarto camino después.
  </Accordion>

  <Accordion title="Asignar operador VIP a clientes premium">
    Un workflow que reserva un asesor específico para clientes premium y usa la cola general para el resto.

    El Condicional evalúa `{{$user.plan}}`:

    | Camino    | Regla                              | Rama del handoff                                              |
    | :-------- | :--------------------------------- | :------------------------------------------------------------ |
    | Premium   | `{{$user.plan}}` igual a `premium` | Nodo Jelou en modo **Directa > Operador > Ana (asesora VIP)** |
    | **Si no** | —                                  | Nodo Jelou en modo **Cola > General**, prioridad 5            |

    Dos nodos Jelou distintos, cada uno con su configuración, alimentados desde un único Condicional.
  </Accordion>

  <Accordion title="Escalar a supervisor cuando falla la asignación">
    Un workflow que intenta primero asignar al equipo de soporte y, si falla, escala automáticamente a un supervisor.

    * Primer nodo Jelou: **Directa > Equipo > Soporte Técnico**.
    * La salida **Fuera de horario** se conecta a un mensaje que informa el horario y termina.
    * La salida **Operador no encontrado** y **Error general** se conectan a un segundo nodo Jelou: **Directa > Operador > Supervisor de guardia**.

    Con esta cadena, ningún caso queda sin atender aunque el equipo principal no esté disponible.
  </Accordion>

  <Accordion title="Cola priorizada por urgencia detectada">
    Un workflow de reclamos que ajusta la prioridad en la cola según lo urgente que suene el mensaje.

    Un nodo **AI Agent** analiza el mensaje del usuario y guarda un score en `{{$memory.urgencia}}` (`alta`, `media`, `baja`). Luego un Condicional dirige a tres nodos Jelou distintos, todos en modo **Cola > Equipo > Reclamos**, cambiando la prioridad:

    | Camino  | `{{$memory.urgencia}}` | Prioridad |
    | :------ | :--------------------- | :-------- |
    | Urgente | `alta`                 | 0         |
    | Normal  | `media`                | 5         |
    | Baja    | `baja`                 | 9         |

    Los operadores ven los casos urgentes arriba de la bandeja del equipo sin necesidad de intervenir manualmente.
  </Accordion>
</AccordionGroup>

***

## Buenas prácticas

<Tip>
  Cuando debas enrutar a varios operadores o equipos, prefiere **un solo nodo Jelou** alimentado por un Condicional antes que múltiples workflows paralelos. El workflow queda más simple de mantener y los cambios en la lógica de enrutamiento se hacen en un solo lugar.
</Tip>

<Tip>
  Conecta siempre la salida **Fuera de horario** a un mensaje explícito con el horario de atención. Es el error más frecuente en handoffs y el que más frustra al usuario cuando queda en silencio.
</Tip>

<Note>
  Usa variables de `{{$memory}}` o `{{$user}}` para poblar el campo **Equipo** o **Operador** en lugar de valores estáticos. Así puedes decidir el destinatario dinámicamente sin tocar la configuración del nodo.
</Note>

***

## Relacionados

<CardGroup cols={2}>
  <Card title="Nodo Condicional" icon="code-branch" href="/guides/nodos/condicional">
    Cómo definir caminos y reglas para enrutar antes del handoff.
  </Card>

  <Card title="Integración con HubSpot" icon="plug" href="/connect/panel-multi-agente/hubspot">
    Handoff hacia el Inbox de HubSpot en lugar del panel de Jelou.
  </Card>

  <Card title="Integración con Genesys" icon="headset" href="/connect/panel-multi-agente/genesys">
    Handoff hacia agentes de Genesys Cloud.
  </Card>

  <Card title="Bandeja de entrada" icon="users" href="/connect/panel-multi-agente/transferencia-de-casos">
    Cómo trabajan los operadores dentro del panel una vez recibida la conversación.
  </Card>
</CardGroup>
