Bilety

Bilet to wpis klienta w kolejce. Z informacji o bilecie korzysta ekran klienta, wyświetlacz i stanowisko.

Co zawiera bilet

• Numer biletu — numer pokazywany klientowi, drukowany na biletach z kiosku, widoczny na wyświetlaczu i na liście oczekujących na stanowisku. Każda kolejka ma własną numerację. Numery zawsze rosną i nigdy nie są resetowane.
• Hash biletu — losowy ciąg 22 znaków. Ten hash daje klientowi anonimowy dostęp do jego biletu. Zobacz niżej.
• Stan — jedna z sześciu wartości (zobacz niżej).
• Kolejka — kolejka, do której należy bilet.
• Znaczniki czasu — kiedy bilet został utworzony, wywołany, zakończony itd.
• Adnotacje (opcjonalne) — metadane wprowadzone przez personel: imię i nazwisko klienta, liczba osób oraz notatka w dowolnym tekście. Zobacz Adnotacje do biletu.

Stany biletu

Bilet może przechodzić przez następujące stany:

Stan	Końcowy?	Znaczenie
WAITING	Nie	Klient znajduje się w kolejce i czeka na wywołanie.
CALLED	Nie	Stanowisko wywołało ten bilet; klient powinien podejść do stanowiska.
SKIPPED	Nie	Stanowisko pominęło ten bilet. Można wywołać ponownie — personel może przywrócić go do WAITING.
COMPLETED	Tak	Stanowisko oznaczyło obsługę jako zakończoną.
CANCELED	Tak	Klient anulował własne miejsce w kolejce.
NO_SHOW	Tak	Stanowisko potwierdziło nieobecność klienta. W statystykach liczony osobno od SKIPPED.

Przejścia między stanami

WAITING  → CALLED   → COMPLETED
                    ↘ SKIPPED   → WAITING  (stanowisko ponownie wywołuje klienta)
                               ↘ NO_SHOW  (stanowisko potwierdza nieobecność)
                               ↘ CANCELED (klient anuluje odroczone miejsce)
WAITING  → CANCELED  (z inicjatywy klienta)
CALLED   → CANCELED  (z inicjatywy klienta)
SKIPPED  → CANCELED  (z inicjatywy klienta — usuwa z puli biletów możliwych do ponownego wywołania)

SKIPPED a NO_SHOW

SKIPPED oznacza, że personel pominął klienta, ale nadal może wywołać go później. Personel może przywrócić bilet do kolejki akcją Przywróć do kolejki w widoku wyszukiwania na stanowisku. Może też nacisnąć Cofnij w ciągu 5 sekund od pominięcia. Powiadomienia push pozostają aktywne dla pominiętego biletu, więc klient dostaje powiadomienie po tym, jak personel przywoła i wywoła bilet, nawet gdy strona biletu jest zamknięta.

NO_SHOW oznacza, że personel potwierdził nieobecność klienta. To stan końcowy, więc zwykły przebieg przywoływania już nie obejmuje tego biletu. Statystyki liczą go osobno. Używaj go, gdy masz pewność, że klient odszedł.

Zobacz Obsługa nieobecności, aby poznać pełny przebieg pracy na stanowisku.

Adnotacje do biletu

Personel może dodać do biletu następujące szczegóły akcją Dodaj adnotację na stanowisku:

• Imię i nazwisko klienta — zawsze widoczne na stanowisku. Wyświetlacz pokazuje skróconą formę, na przykład „Imię N.”, tylko wtedy, gdy ustawienie Wzywaj po imieniu kolejki jest włączone. Nigdy nie pokazuje pełnego imienia i nazwiska.
• Liczba osób — zawsze widoczna na stanowisku i przesyłana do wyświetlacza (informacja o niskiej wrażliwości).
• Notatka — tekst dla personelu. Widoczna tylko na stanowisku, nigdy na wyświetlaczu ani na ekranie klienta.

Powód pominięcia (wpisywany w polu Powód pominięcia (opcjonalnie), gdy bilet zostaje pominięty) trafia do pola notatki biletu i jest widoczny w widoku wyszukiwania na stanowisku.

Adnotacje możesz dodawać i aktualizować w dowolnym momencie, dopóki bilet nie osiągnie stanu końcowego.

Przenoszenie biletu

Personel może przyciskiem Przenieś na stanowisku przenieść bilet w stanie WAITING do innej kolejki w tej samej lokalizacji. Używaj tego, gdy klient dołączył do niewłaściwej kolejki lub potrzebuje innej usługi.

Zasady przenoszenia:

• Przenieść można wyłącznie bilety w stanie WAITING. Bilety w stanie CALLED musisz najpierw zakończyć, pominąć lub oznaczyć jako nieobecność.
• Kolejka źródłowa i docelowa muszą znajdować się w tej samej lokalizacji.
• Kolejka docelowa musi mieć status ACTIVE.
• Stanowisko musi być przypisane zarówno do kolejki źródłowej, jak i docelowej.
• Wymagana jest aktywna subskrypcja.

Pozycja po przeniesieniu — Jonot umieszcza bilet w nowej kolejce według pierwotnego czasu dołączenia powiększonego o 5 minut. Klient zachowuje większość już odczekanego czasu, ale nie wyprzedza osób, które w nowej kolejce czekają dłużej.

Hash biletu zostaje zachowany — adres URL strony biletu pozostaje ważny. W kolejce docelowej bilet otrzymuje nowy numer w kolejności. Aktualizacje w czasie rzeczywistym trafiają natychmiast do obu kolejek.

Zobacz sekcję Przenieś bilet do innej kolejki przewodnika po stanowisku, aby poznać instrukcje krok po kroku.

Hash biletu jako poświadczenie

Klienci nie potrzebują konta ani logowania, aby dołączyć do kolejki. Zamiast tego 22-znakowy hash biletu potwierdza, że bilet należy do danego klienta. Hash jest częścią adresu URL strony biletu:

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

API używa hasha, aby zezwolić na następujące akcje:

• ticketByHash — sprawdzenie swojego biletu i pozycji
• cancelTicket — anulowanie własnego biletu (działa dla biletów w stanie WAITING, CALLED i SKIPPED)

Klientowi wystarczy sam adres URL. Nie potrzebuje konta, aplikacji ani hasła.

Hash zawiera 128 bitów losowości, tyle samo co UUID v4. Dzisiejsze komputery nie są w stanie w praktyce odgadnąć hasha biletu innego klienta.

Weryfikacja przy nietypowym ruchu

Zwykle klienci dołączają bez weryfikacji. Jeśli pojedyncza kolejka odnotuje w krótkim czasie nietypowo dużo prób dołączenia, klienci korzystający z kodu QR lub linku mogą musieć przejść weryfikację „nie jestem robotem”, zanim dostaną bilet. Większość rzeczywistych klientów przechodzi ją niezauważalnie. Weryfikacja pojawia się wyłącznie przy takich skokach ruchu. Nigdy nie dotyczy stacjonarnego kiosku, ponieważ kiosk korzysta z zaufanego poświadczenia urządzenia.

Szacowany czas oczekiwania

Gdy bilet jest w stanie WAITING, strona biletu pokazuje klientowi szacowany czas oczekiwania. Ten sam szacunek widnieje na ekranie potwierdzenia po dołączeniu na kiosku, dzięki czemu klient opuszcza kiosk z liczbą do zapamiętania. Jest to szacunek, a nie gwarancja.

Serwer wylicza szacunek z ostatnich czasów obsługi w danej kolejce. Jeśli w ciągu ostatnich 90 minut zakończono wystarczająco dużo biletów, używa mediany. Mediana to wartość środkowa albo średnia dwóch wartości środkowych po posortowaniu czasów obsługi. Serwer mnoży ją przez pozycję klienta w kolejce (liczba osób przed + 0,5). Gdy przed klientem nie ma nikogo, szacunek wynosi zero. Gdy ostatnich danych jest za mało, serwer używa skonfigurowanego dla kolejki przewidywanego czasu obsługi. Szacunek ma wskaźnik pewności: high, gdy korzysta z ostatnich danych lub gdy klient jest następny, oraz low, gdy korzysta ze skonfigurowanej wartości.

Szacunek pokazujemy wyłącznie dla biletów w stanie WAITING w kolejce o statusie ACTIVE. Nie pojawia się, gdy kolejka jest wstrzymana, i znika, gdy bilet zostaje wywołany.

Doświadczenie klienta

1. Klient dołącza przez kod QR lub kiosk → Jonot wydaje bilet w stanie WAITING.
2. Klient otwiera stronę biletu → widzi swoją pozycję w kolejce oraz, jeśli jest dostępny, szacowany czas oczekiwania w czasie rzeczywistym.
3. Stanowisko wywołuje jego numer → bilet przechodzi w stan CALLED, a strona klienta aktualizuje się natychmiast.
4. Klient podchodzi do stanowiska. Po obsłudze personel oznacza bilet jako COMPLETED.
5. Jeśli klient nie reaguje, stanowisko może:
   • Pomiń → bilet przechodzi w stan SKIPPED (odroczenie z możliwością ponownego wywołania). Ekran klienta pokazuje, że został pominięty, wraz z opcjami oczekiwania lub ponownego dołączenia.
   • Nieobecność → bilet przechodzi w stan NO_SHOW (końcowy). Statystyki liczą to osobno od pominiętych biletów.
6. Personel może przywołać pominiętego klienta (bilet wraca do stanu WAITING na początku kolejki), a klient może anulować swoje miejsce i dołączyć ponownie na końcu.