Code

Una coda è una lista d’attesa denominata all’interno di una sede. Quando un cliente si mette in coda, riceve un biglietto con un numero sequenziale. Il personale a uno sportello chiama i biglietti dalla coda uno alla volta. Il display annuncia ogni chiamata.

Anatomia di una coda

Ogni coda ha:

Nome — l’etichetta leggibile mostrata a clienti e personale (es. “Senza appuntamento”, “Appuntamenti”).
Slug — un identificatore adatto agli URL usato nell’URL di adesione del cliente. Generato automaticamente dal nome della coda.
URL di adesione per il cliente — l’URL completo che i clienti visitano per mettersi in questa coda:
```
https://customer.jonot.io/{org-slug}/{location-slug}/{queue-slug}/
```
Questo URL è codificato anche nel QR code che condividi all’ingresso.
Limite di capacità (facoltativo) — il numero massimo di biglietti che possono essere in stato WAITING contemporaneamente. Quando la coda è piena, i nuovi tentativi di adesione vengono respinti con un messaggio “coda piena”. Lascia vuoto per illimitato.
Tempo di servizio previsto — i minuti tipici per servire un cliente (1–1440), impostati nel modulo di creazione/modifica della coda. Alimenta la stima del tempo di attesa del cliente finché la coda non ha ancora abbastanza cronologia in tempo reale per misurare il proprio ritmo (vedi Stima del tempo di attesa).

Più code per sede

Una sede può avere un numero qualsiasi di code. Questo ti permette di gestire linee di servizio separate in parallelo — ad esempio:

Una clinica con le code “Visita generale” e “Ritiro farmacia”
Un ufficio pubblico con le code “Passaporto” e “Rinnovo carta d’identità”
Una banca con le code “Clientela privata” e “Clientela business”

Ogni coda ha la propria lista d’attesa indipendente. Uno sportello viene abbinato a una coda specifica al momento dell’abbinamento, quindi gli sportelli che servono “Senza appuntamento” non vedono i biglietti di “Appuntamenti”.

La coda come unità di gestione

La coda è l’unità centrale attorno a cui sono organizzati dispositivi e personale:

I chioschi sono abbinati a una coda — i clienti che toccano il chiosco si mettono in quella coda specifica.
Gli sportelli sono abbinati a una coda — il personale chiama i biglietti da quella coda.
I display mostrano tutte le chiamate attive di una sede, oppure le chiamate della coda di uno sportello specifico, oppure un pannello combinato fino a 5 code.

La creazione e la gestione delle code avviene in Admin nella scheda Code della sede. Consulta Creare una coda per le istruzioni passo passo.

Limite di capacità

Puoi limitare quanti clienti possono aspettare in una coda contemporaneamente impostando un limite di capacità (il campo Massimo in attesa nel modulo di creazione/modifica della coda). Quando il limite viene raggiunto:

Il flusso di adesione del cliente mostra un messaggio “coda piena”.
Il chiosco mostra uno stato di coda piena.
Non è possibile mettersi in coda finché un biglietto in attesa non esce (viene chiamato, annullato o spostato).

Il limite viene applicato in modo atomico — due clienti che tentano di mettersi in coda esattamente nello stesso momento non possono far superare entrambi il limite. Lascia il campo vuoto per una coda illimitata (impostazione predefinita).

Stato della coda

Ogni coda ha uno stato manuale che il personale controlla indipendentemente dagli orari di apertura:

Attiva — lo stato normale. I clienti possono mettersi in coda e gli sportelli possono chiamare i biglietti.
In pausa — interrompe temporaneamente l’accettazione. Le nuove adesioni vengono rifiutate, ma chiunque sia già in attesa mantiene il proprio posto. Usalo per una breve pausa o per smaltire un arretrato prima di far entrare altre persone.
Chiusa — interrompe l’accettazione come una pausa, ma segnala che la coda è terminata per ora. I biglietti in attesa vengono mantenuti anziché annullati. Riaprire una coda chiusa è un’azione di Admin — uno sportello non può riaprirla da solo.

Quando una coda è in pausa o chiusa, un cliente già in attesa vede un banner di stato sul proprio biglietto, e chiunque tenti di mettersi in coda viene respinto con un messaggio corrispondente anziché un errore generico. Un banner In pausa rassicura il cliente che il suo posto è mantenuto e che la coda riprenderà; un banner Chiusa è più cauto — il biglietto viene conservato ma potrebbe non essere servito, quindi al cliente viene chiesto di verificare con il personale.

Impostare lo stato:

In Admin, un amministratore dell’organizzazione o un responsabile di sede imposta lo stato (Attiva / In pausa / Chiusa) dal modulo di modifica della coda.
Allo sportello, il personale può alternare tra Attiva e In pausa con un singolo pulsante Metti in pausa la coda / Riprendi la coda — la via rapida per una pausa momentanea senza lasciare lo sportello. La chiusura (e la riapertura da chiusa) resta in Admin.

I cambi di stato hanno effetto immediato e vengono trasmessi in tempo reale a ogni sportello, display e cliente connesso.

Orari di apertura

Gli orari di apertura di una sede fungono da blocco basato sul tempo per tutte le sue code. Quando la sede è fuori dai suoi orari configurati, i tentativi di adesione vengono respinti con un messaggio “fuori orario” e il selettore di code rivolto ai clienti mostra uno stato “Chiuso — apre alle [ora]”. Sportello e display mostrano un’etichetta Chiuso (orari).

Gli orari vengono configurati sulla sede (non per coda) in Admin → [Sede] → Orari:

Fuso orario — fuso orario IANA (es. Europe/Rome). Tutti gli orari vengono valutati in questo fuso orario, con correzione per l’ora legale.
Pianificazione settimanale — intervalli di apertura/chiusura per ogni giorno della settimana. Un giorno senza intervalli è completamente chiuso. Sono supportati più intervalli per giorno (es. per rappresentare una pausa pranzo: 08:00–12:00 e 13:00–17:00).
Orari a cavallo della mezzanotte — è supportato un intervallo in cui l’orario di chiusura è dopo mezzanotte (es. venerdì 20:00–02:00). Inserisci l’orario di chiusura usando un valore orario normale (02:00); quando l’orario di chiusura è uguale o precedente all’orario di apertura, l’editor lo tratta automaticamente come il giorno successivo e mostra un suggerimento giorno successivo accanto al campo di chiusura.

Eccezioni per data

Le eccezioni per singole date (festività, orari speciali) sono gestite nella sezione Eccezioni per data dell’editor degli orari:

Eccezione di chiusura — segna una data specifica come completamente chiusa indipendentemente dalla pianificazione settimanale (es. una festività).
Eccezione con orari personalizzati — sostituisce la pianificazione settimanale per una data specifica con un diverso insieme di intervalli. Un’eccezione di chiusura in una data specifica ha la precedenza su uno sconfinamento a cavallo della mezzanotte del giorno precedente.

Le eccezioni appaiono in un elenco sotto la pianificazione settimanale e possono essere aggiunte, modificate o eliminate in qualsiasi momento.