Inbox y Human Handoff
Cuando tu agent de AI no puede resolver completamente una conversación, puede transferir al usuario a un miembro humano del equipo. Esto se llama Human Handoff — conecta tu soporte impulsado por AI con personas reales cuando más se necesita.
Visión General
Human Handoff ofrece:
- Transferencia sin fricción del agent de AI a un miembro humano del equipo
- Chat en tiempo real con los usuarios finales en cualquier canal conectado
- Gestión de cola con seguimiento del estado
- Notificaciones in-app y por email cuando los usuarios piden ayuda
- Caducidad automática si ningún agent está disponible dentro del tiempo configurado
Requisitos
- Un agent de AI activo con Human Handoff habilitado
- Al menos un canal conectado (o el Website Widget)
- Un miembro del equipo disponible para responder en el panel de administración
Habilitar Human Handoff
Human Handoff se configura por agent.
- Ve a Agents y haz clic en tu agent para editarlo
- En la pestaña Configuration, desplázate hasta la sección Human Handoff
- Activa Enable Human Handoff
- Configura los ajustes:
| Ajuste | Descripción | Predeterminado |
|---|---|---|
| Handoff Message | Se muestra al usuario cuando comienza la transferencia | ”I’m connecting you with a human agent. Please hold on.” |
| Accept Message | Se envía automáticamente cuando un miembro del equipo acepta el chat | ”Hi! I’m {agent_name} from {org_name}. How can I help you?” |
| Resolve Message | Se muestra al usuario cuando el chat termina | ”You’re now back with the AI assistant. How can I help?” |
| Max Wait Time | Caduca automáticamente si nadie acepta (5, 15, 30, 60 o 120 minutos) | 30 minutos |
- Haz clic en Save Changes
Los mensajes admiten los marcadores {'{agent_name}'} y {'{org_name}'}, que se reemplazan automáticamente por los valores reales.
Para más detalles sobre los ajustes del agent, consulta Opciones de Configuración.
Cómo Funciona
El usuario pide hablar con una persona
→ El agent de AI detecta la solicitud
→ El handoff message se muestra al usuario
→ La sesión aparece en la cola del Inbox (estado: Queued)
→ Los miembros del equipo reciben una notificación in-app
→ Si no hay respuesta en 3 min, se envía un recordatorio por email
→ Un miembro del equipo abre el Inbox y hace clic en Accept
→ El accept message se envía al usuario
→ Chat en tiempo real entre el usuario y el miembro del equipo
→ El miembro del equipo hace clic en Resolve cuando termina
→ El resolve message se envía al usuario
→ El agent de AI retoma la conversaciónDurante un handoff, el agent de AI hace una pausa. Todos los mensajes del usuario se enrutan directamente al miembro humano del equipo. Cuando se resuelve, el agent de AI retoma automáticamente la conversación.
Usar la Página Inbox
Navega a Inbox en la barra lateral para ver la cola de handoff.
Estadísticas de la Cola
En la parte superior de la página verás:
- Queued — Número de usuarios esperando a un miembro del equipo
- Active — Número de chats que se están atendiendo en este momento
- Agents online — Cuántos miembros del equipo tienen abierta la página Inbox
Tu estado en línea se rastrea automáticamente mientras tengas la página Inbox abierta. No hace falta una acción manual de “ponerse en línea”.
Filtrado
Usa el desplegable de filtro de estado para ver sesiones específicas:
| Filtro | Muestra |
|---|---|
| Queued & Active | Conversaciones que requieren atención (predeterminado) |
| Queued Only | Usuarios esperando a que alguien acepte |
| Active Only | Conversaciones que se están atendiendo en este momento |
| Resolved | Conversaciones completadas |
| Expired | Sesiones que expiraron |
| All | Todas |
Tabla de la Cola
Cada fila muestra el agent de AI que escaló, el canal del usuario, el estado de la sesión, el motivo de la escalación, el tiempo de espera y qué miembro del equipo está asignado (si hay alguno).
Haz clic en cualquier fila para abrir la página de detalle del chat.
Aceptar y Conversar
Cuando haces clic en una sesión en cola, se abre la página de detalle del chat.
Aceptar una Sesión
Haz clic en el botón verde Accept del encabezado. Esto:
- Cambia el estado de la sesión de Queued a Active
- Envía el accept message al usuario en su canal
- Abre la entrada de mensaje para que puedas empezar a conversar
Solo un miembro del equipo puede aceptar una sesión. Una vez aceptada, queda asignada a ti.
Interfaz de Chat
La página de detalle del chat tiene dos secciones:
Panel de Chat (izquierda):
- Los mensajes están agrupados por remitente con estilos distintos:
- Mensajes del usuario (oscuro) — a la izquierda
- Mensajes del bot de AI (claro) — a la derecha
- Mensajes del agent humano (azul) — a la derecha, etiquetados con tu nombre
- Escribe en el área de texto inferior y pulsa Enter para enviar
- Los mensajes se entregan en tiempo real en el canal del usuario
Barra Lateral de Contexto (derecha, solo escritorio):
- Timeline — Marcas de tiempo de creación, aceptación y resolución, con temporizador en vivo del tiempo de espera
- Session — Estado, canal, número de mensajes, agent asignado
- Participants — Usuario final, agent de AI y agent humano
- Escalation Reason — Por qué la AI decidió hacer el handoff (si se proporciona)
Resolver Sesiones
Cuando hayas atendido el problema del usuario:
- Haz clic en el botón Resolve del encabezado
- Aparece un diálogo de confirmación
- Opcionalmente, añade una nota interna (no se muestra al usuario — para los registros de tu equipo)
- Haz clic en Resolve para confirmar
Después de resolver:
- Se envía el resolve message al usuario
- La conversación vuelve al agent de AI
- La sesión pasa al estado Resolved
Qué Sucede Cuando Nadie Está Disponible
Si ningún miembro del equipo acepta dentro del Max Wait Time configurado:
- El estado de la sesión cambia a Expired
- El usuario recibe un mensaje de que no hay agent disponible
- La conversación vuelve automáticamente al agent de AI
Configura el Max Wait Time según la disponibilidad de tu equipo. Si tienes personal limitado, es mejor un tiempo más corto (5–10 minutos) que dejar a los usuarios esperando.
Notificaciones
Notificaciones In-App
Cuando un usuario solicita un agent humano, todos los miembros del equipo de tu organización reciben una notificación in-app a través de la campana de notificaciones del encabezado del panel de administración.
Recordatorios por Email
Si una sesión de handoff permanece en cola durante 3 minutos sin ser aceptada, se envía un recordatorio por email a todos los miembros del equipo de tu organización. Esto asegura que alguien sea notificado incluso si no está actualmente en el panel de administración.
Canales Soportados
Human Handoff funciona con todos los canales conectados:
| Canal | Método de Entrega |
|---|---|
| Telegram | Mensajes enviados por bot |
| Discord | Mensajes enviados al canal |
| Slack | Mensajes enviados al canal |
| Mensajes enviados por API | |
| Meta (Facebook Messenger) | Mensajes enviados por la página |
| Google Chat | Mensajes enviados al espacio |
| Website Widget | Los mensajes aparecen en el widget de chat |
En el Website Widget los mensajes se entregan vía streaming en tiempo real. En todos los demás canales, los mensajes se envían directamente a través de la API del canal.
FAQ
¿Qué planes incluyen Human Handoff?
Human Handoff está disponible en todos los planes, incluido el de prueba. Habilítalo por agent en la pestaña Configuration.
¿Pueden varios miembros del equipo gestionar handoffs?
Sí. Cualquier miembro del equipo de tu organización puede aceptar sesiones en cola. El contador “Agents online” muestra cuántos miembros del equipo tienen actualmente la página Inbox abierta.
¿Qué pasa si cierro el navegador durante un chat activo?
La sesión permanece Active. Cuando vuelvas a la página Inbox, podrás continuar la conversación donde la dejaste.
¿Puede el usuario darse cuenta de que está hablando con una persona?
El usuario recibe el accept message configurado cuando te unes. Más allá de eso, la experiencia depende de cómo escribas los mensajes de handoff y de tu estilo de conversación.
¿La AI ve los mensajes del agent humano?
Los mensajes del agent humano se almacenan en el historial de la conversación. Cuando la AI retoma tras la resolución, tiene contexto del intercambio del handoff.
¿Puedo revisar sesiones de handoff anteriores?
Sí. Usa el filtro de estado en la página Inbox para ver sesiones Resolved o Expired. Haz clic en cualquier sesión para revisar la conversación completa.
¿Qué hace que la AI active un handoff?
El agent de AI decide escalar cuando un usuario pide explícitamente hablar con una persona (p. ej., “Can I talk to a real person?”). La AI usa una verificación de clasificación para confirmar que el usuario realmente quiere hablar con una persona antes de crear el handoff.