Jakie zdarzenia recepcji system publikuje
Webhook zdarzeń recepcji publikuje sześć typów zdarzeń: guest_registered, station_group_updated, station_group_aborted, station_training_failed, station_training_completed i guest_entered. Każdy typ odpowiada innemu momentowi w drodze gościa przez recepcję: od rejestracji, przez grupowe szkolenie na stanowisku, po wejście na teren zakładu.
Odbiorca nie musi obsługiwać wszystkich typów. Typowy workflow w narzędziu integracyjnym rozdziela komunikaty według pola typu zdarzenia i kieruje każdy do osobnego kanału lub szablonu wpisu.
Które zdarzenie oznacza, że gość się zarejestrował?
Zdarzenie guest_registered pojawia się po zakończeniu rejestracji gościa. Celowo nie niesie numeru telefonu gościa, ponieważ trafia do kanału klienta, a nie do systemu, który ma prawo do danych kontaktowych. Dla ochrony wystarcza informacja, kto i kiedy zarejestrował wizytę.
Co oznaczają zdarzenia z grupą na stanowisku rejestracji?
Zdarzenia station_group_updated i station_group_aborted opisują grupę szkoleniową na stanowisku rejestracji: pierwsze informuje o zmianie jej stanu, drugie o przerwaniu. Zdarzenia station_training_completed i station_training_failed zamykają szkolenie sukcesem albo porażką. Zdarzenie guest_entered potwierdza wejście gościa.
Co zawiera pojedyncze zdarzenie
Każde zdarzenie recepcji jest przesyłane jako JSON. Zawiera adres serwera, z którego pochodzi, czas zdarzenia w formacie ISO 8601 w strefie Europe/Warsaw oraz gotowy tekst, który można wstawić do wpisu bez dalszej obróbki. Dzięki temu najprostszy odbiorca składa się z dwóch kroków: odebrać komunikat i opublikować pole z tekstem.
Gotowy tekst nie zastępuje pozostałych pól. Jeżeli ochrona chce filtrować wpisy według typu zdarzenia albo liczyć wejścia w ciągu zmiany, odbiorca powinien korzystać z pola czasu i typu, a nie parsować tekst.
Czy w zdarzeniu są dane osobowe gościa?
Zdarzenie rejestracji gościa nie zawiera numeru telefonu. Zakres pozostałych danych ustala się przy konfiguracji odbiorcy, a minimalizacja jest zasadą: do kanału zakładu trafia tyle informacji, ile potrzebuje ochrona do reakcji.
W jakiej strefie czasowej jest czas zdarzenia?
W strefie Europe/Warsaw, w formacie ISO 8601. Odbiorca w innej strefie powinien przeliczać czas jawnie, a nie zakładać czasu lokalnego serwera.
Limity czasu w zdarzeniach recepcji
Jak i kiedy zdarzenie jest wysyłane
Adres odbiorcy zdarzeń ustawia administrator w panelu w polu webhook:reception_url. Puste pole oznacza, że nic nie wychodzi, więc wyłączenie integracji sprowadza się do wyczyszczenia adresu.
Zdarzenia trafiają na kolejkę komunikatów i są wysyłane asynchronicznie jako JSON z limitem czasu 5 sekund. Rejestracja gościa, skan i zaliczenie szkolenia nie czekają na odpowiedź odbiorcy.
Czy wolny odbiorca spowolni recepcję?
Nie. Wysyłka odbywa się poza ścieżką obsługi gościa, a błąd webhooka nie przerywa rejestracji gościa, skanu ani zaliczenia szkolenia. Najgorszy skutek niedostępnego odbiorcy to brak wpisu w kanale, a nie zablokowana recepcja.
Co się dzieje, gdy odbiorca jest chwilowo niedostępny?
Zdarzenie, którego nie udało się wysłać w limicie 5 sekund, kończy próbę błędem. Ponieważ błąd nie wpływa na proces biznesowy, ochrona powinna mieć drugą drogę informacji, na przykład ekran stanowiska rejestracji, a odbiorca powinien być monitorowany jak każda inna usługa zakładu.
Dla instalacji, w których sieć blokuje ruch wychodzący z serwera aplikacji, dostępny jest osobny tryb doręczania z odbiorem komunikatów przez poller. Opisujemy go w materiałach o wyborze trybu direct lub outbox.
Grupy szkoleniowe i alert o niezaliczeniu
Grupa szkoleniowa na stanowisku rejestracji żyje 34 minuty. Po tym czasie wygasa, a odbiorca dostaje zdarzenie station_training_failed. To samo zdarzenie zgłasza sytuację, w której nikomu z grupy nie wymagano szkolenia.
Odbiorca dostaje alert tylko o porażce, bez osobnego powiadomienia o sukcesie. Dzięki temu kanał ochrony nie zapełnia się wpisami o rzeczach, które przebiegły poprawnie, a uwaga operatora skupia się na wyjątkach.
Czy alert o niezaliczeniu może przyjść dwa razy?
Duplikaty blokuje znacznik SET NX w Redisie. Jeżeli wysyłka się nie powiedzie, blokada jest zwalniana, aby alert mógł wyjść ponownie. To świadomy wybór: lepiej dostać powtórzony alert niż nie dostać go wcale.
Jak wygląda odbiorca po stronie zakładu
Typowym odbiorcą zdarzeń recepcji jest workflow w narzędziu n8n, który publikuje wpisy w kanale zakładu na komunikatorze, Mattermost lub Telegram. Wpis o grupie w toku jest zastępowany nowym wpisem, a przy przerwaniu lub niezaliczeniu pojawia się czerwony wpis z dźwiękiem.
Zastępowanie wpisu ma praktyczną wartość: kanał pokazuje jeden aktualny stan grupy, a nie serię powtórzeń. Ochrona widzi na telefonie jedną linię na grupę i dopiero zmiana koloru wymaga reakcji.
Czy muszę używać n8n?
Nie. Odbiorcą może być dowolna usługa przyjmująca JSON po HTTPS: komunikator, system zgłoszeń, własna aplikacja integratora. Opis workflow w n8n pokazuje sprawdzony wzorzec, nie wymóg.
Jak sprawdzić, że integracja działa?
Po wpisaniu adresu w panelu zarejestruj próbnego gościa i sprawdź, czy wpis pojawił się w kanale. Szczegółową procedurę opisuje poradnik konfiguracji webhooka recepcji krok po kroku.
Materiał wideo
Często zadawane pytania
Czy system ponawia wysyłkę zdarzenia recepcji?
W trybie bezpośrednim próba trwa do limitu 5 sekund i kończy się wynikiem. Dla alertu o niezaliczeniu szkolenia nieudana wysyłka zwalnia blokadę duplikatów, więc alert może wyjść ponownie.
Czy wyłączenie webhooka zatrzymuje rejestrację gości?
Nie. Puste pole z adresem oznacza tylko, że nic nie wychodzi. Rejestracja, skany i szkolenia działają bez zmian.
Czy mogę dostawać powiadomienia o udanych szkoleniach?
Zdarzenie o zaliczeniu istnieje, ale alert wychodzi tylko o porażce. Wpis o grupie w toku jest zastępowany nowym, więc kanał nie rośnie.
Czy numer telefonu gościa trafia do kanału zakładu?
Nie. Zdarzenie rejestracji gościa celowo nie niesie numeru telefonu.
Podłączmy zdarzenia recepcji do kanału zakładu
Pokażemy na demo, jak komunikaty recepcji trafiają do komunikatora ochrony i co zobaczy dyżurny. Umów rozmowę z zespołem InnerWeb.
Porozmawiajmy