Turnos

Un turno es una entrada en una cola emitida a un cliente cuando se une. Es la unidad central del sistema de colas — todo, desde la pantalla de sala hasta la interfaz del mostrador, gira en torno a los turnos.

Qué contiene un turno

• Número de turno — un entero secuencial visible para el cliente, que se muestra en el recibo del quiosco, en la pantalla de sala y en la lista de espera del mostrador. Los números están limitados a una cola y aumentan de forma monótona — nunca se reinician.
• Hash del turno — una cadena aleatoria de 22 caracteres con 128 bits de entropía. Este hash es la credencial de portador anónima del cliente (ver más abajo).
• Estado — uno de seis valores (ver más abajo).
• Cola — la cola a la que pertenece el turno.
• Marcas de tiempo — cuándo se creó el turno, se llamó, se completó, etc.
• Anotaciones (opcional) — metadatos introducidos por el personal: nombre del cliente, número de personas y una nota de texto libre. Ver Anotaciones del turno.

Estados del turno

Un turno pasa por los siguientes estados a lo largo de su ciclo de vida:

Estado	¿Terminal?	Significado
WAITING	No	El cliente está en la cola, esperando a que lo llamen.
CALLED	No	Un mostrador ha llamado a este turno; el cliente debe acercarse al mostrador.
SKIPPED	No	El mostrador ha pasado este turno. Se puede volver a llamar — el personal puede devolverlo a WAITING.
COMPLETED	Sí	El mostrador ha marcado el servicio como finalizado.
CANCELED	Sí	El cliente canceló su propio lugar en la cola.
NO_SHOW	Sí	El mostrador confirmó la ausencia del cliente. Se cuenta por separado de SKIPPED en las analíticas.

Transiciones de estado

WAITING  → CALLED   → COMPLETED
                    ↘ SKIPPED   → WAITING  (el mostrador vuelve a llamar al cliente)
                               ↘ NO_SHOW  (el mostrador confirma la ausencia)
                               ↘ CANCELED (el cliente cancela su lugar aplazado)
WAITING  → CANCELED  (iniciado por el cliente)
CALLED   → CANCELED  (iniciado por el cliente)
SKIPPED  → CANCELED  (iniciado por el cliente — se elimina del conjunto que se puede volver a llamar)

SKIPPED frente a NO_SHOW

SKIPPED es un aplazamiento que se puede volver a llamar — se pasó al cliente, pero el turno sigue activo. El personal puede volver a llamar al cliente usando la acción Devolver a la fila en la vista de búsqueda del mostrador, o pulsando Deshacer dentro de los 5 segundos siguientes al pase. La suscripción a notificaciones push de un cliente pasado se mantiene activa, de modo que la notificación push de recuperación → llamada le llega aunque haya cerrado la página del turno.

NO_SHOW es una ausencia confirmada y terminal. El turno se elimina del conjunto que se puede volver a llamar y se cuenta por separado en las analíticas. Úsalo cuando tengas la certeza de que el cliente se ha marchado.

Consulta Gestionar ausencias para conocer el flujo de trabajo completo del mostrador.

Anotaciones del turno

El personal puede adjuntar metadatos ligeros a cualquier turno usando la acción Anotar en el mostrador:

• Nombre del cliente — se muestra en el mostrador en todo momento. Se muestra en la pantalla de sala solo si el ajuste Llamar por nombre de la cola está activado, y entonces solo en una forma reducida (“Nombre A.”) — nunca el nombre completo.
• Número de personas — siempre visible en el mostrador y transmitido a la pantalla de sala (un recuento de baja sensibilidad).
• Nota — nota de texto libre para uso interno. Solo en el mostrador; nunca se envía a la pantalla de sala ni al cliente.

Un motivo de omisión (introducido en el campo Motivo para omitir (opcional) al omitir un turno) se guarda en el campo de nota del turno y es visible en la vista de búsqueda del mostrador.

Las anotaciones se pueden añadir o actualizar en cualquier momento mientras el turno no sea terminal.

Transferir un turno

Un turno en estado WAITING se puede transferir a una cola distinta de la misma ubicación usando el botón Trasladar en el mostrador. Es útil cuando un cliente se ha unido a la cola equivocada o cuando el triaje revela que necesita un servicio distinto.

Reglas de transferencia:

• Solo se pueden transferir los turnos WAITING. Los turnos CALLED deben completarse, omitirse o marcarse como ausencia primero.
• La cola de origen y la de destino deben estar en la misma ubicación.
• La cola de destino debe estar ACTIVE.
• El mostrador debe estar asignado tanto a la cola de origen como a la de destino.
• Se requiere una suscripción activa.

Posicionamiento tras la transferencia — el turno conserva la hora de unión original del cliente más una penalización de 5 minutos. Esto preserva la espera que ya ha cumplido, a la vez que evita que se adelante a clientes que llevan más tiempo esperando en la cola de destino.

El hash del turno se conserva — la URL de la página del turno del cliente sigue siendo válida. El turno recibe un nuevo número secuencial en la cola de destino. Las actualizaciones en tiempo real se transmiten a ambas colas de inmediato.

Consulta la sección Transferir un turno a otra cola de la guía del mostrador para ver las instrucciones paso a paso.

El hash del turno como credencial

Los clientes son anónimos — no se necesita iniciar sesión ni tener una cuenta para unirse a una cola. En su lugar, el hash del turno de 22 caracteres sirve como prueba de propiedad del cliente. Está incrustado en la URL de la página del turno:

https://customer.jonot.io/{org}/{location}/{queue}/{ticket-hash}/

Conocer el hash demuestra que ese turno es tuyo. La API usa el hash para autorizar:

• ticketByHash — consultar tu turno y tu posición
• cancelTicket — cancelar tu propio turno (funciona con turnos WAITING, CALLED y SKIPPED)

Este diseño es intencionado: elimina toda fricción al unirse a una cola. Sin cuenta, sin app, sin contraseña — solo una URL.

El hash tiene 128 bits de entropía (equivalente a un UUID v4), lo que hace computacionalmente inviable adivinar el hash del turno de otro cliente.

Verificación en caso de tráfico inusual

Unirse a la cola sigue siendo sencillo en el uso normal. Como medida contra abusos, si una sola cola recibe una ráfaga anormalmente alta de uniones en un periodo corto, es posible que se pida a los clientes que se unen a través de la web (código QR o enlace) que completen una rápida verificación “Soy humano” antes de que se emita su turno. La mayoría de los visitantes legítimos la superan de forma invisible. Esto solo aparece durante avalanchas — en tráfico normal no se muestra ninguna verificación — y nunca se aplica al quiosco presencial, cuyas uniones son de confianza por credencial de dispositivo.

Estimación del tiempo de espera

Cuando un turno está en estado WAITING, la página del turno del cliente muestra un tiempo de espera estimado. La misma estimación se muestra en la pantalla de confirmación posterior a la unión del quiosco, para que el cliente salga del quiosco con un número que recordar. Esto es una estimación de mejor esfuerzo, no una garantía.

La estimación se calcula a partir de los intervalos de servicio recientes de esa cola: si existen suficientes turnos completados en los últimos 90 minutos, el servidor deriva la mediana del tiempo de servicio y la multiplica por la posición del cliente en la cola (personas por delante + 0,5). Cuando el cliente es el siguiente en la fila (cero personas por delante), la estimación se muestra como cero. Cuando el historial reciente es escaso, se usa como respaldo el tiempo de servicio esperado configurado en la cola. La estimación lleva un indicador de confianza (high cuando se deriva de datos en vivo o cuando el cliente es el siguiente, low cuando recurre al valor predeterminado configurado).

La estimación solo se muestra para turnos WAITING en una cola ACTIVE. No se muestra cuando la cola está pausada, y desaparece en cuanto se llama al turno.

Experiencia del cliente

1. El cliente se une mediante código QR o quiosco → se emite un turno en estado WAITING.
2. El cliente abre la página del turno → ve su posición en la cola y, si está disponible, un tiempo de espera estimado en tiempo real.
3. Cuando el mostrador llama a su número, el turno pasa a CALLED → la página del cliente se actualiza de inmediato.
4. El cliente se acerca al mostrador. Tras el servicio, el mostrador lo marca como COMPLETED.
5. Si el cliente no responde, el mostrador puede:
   • Omitir → el turno pasa a SKIPPED (aplazamiento que se puede volver a llamar). La pantalla del cliente muestra que fue pasado, con opciones para esperar o volver a unirse.
   • Ausente → el turno pasa a NO_SHOW (terminal). Las analíticas lo cuentan por separado de los turnos omitidos.
6. Un cliente pasado puede ser recuperado por el personal (vuelve a WAITING al frente de la fila), o puede cancelar su lugar y volver a unirse al final.