InnerWeb
Przejdź do treści

Powiadomienia recepcji na komunikatorze zakładu

Kierownik ochrony w zakładzie spożywczym chce wiedzieć, kto się zarejestrował i kto wszedł na teren, bez dyżurowania przy ekranie recepcji. Webhook zdarzeń recepcji przesyła te informacje do kanału na komunikatorze zakładu, a numer telefonu gościa celowo w nim nie występuje. Opisujemy scenariusz od zdarzenia do wpisu w kanale.

6
typów zdarzeń recepcji
Źródło: karta
5 s
limit czasu wysyłki webhooka
Źródło: karta
34 min
czas życia grupy szkoleniowej
Źródło: karta

Potrzeba: informacja o gościach tam, gdzie ochrona i tak patrzy

Zakład spożywczy o podwyższonych wymaganiach higienicznych i bezpieczeństwa ma zwykle jeden punkt wejścia dla gości i kilku odbiorców informacji: ochronę, opiekuna wizyty, kierownika zmiany. Każdy z nich korzysta już z komunikatora zakładowego, więc osobny ekran lub skrzynka e-mail jest dla nich dodatkowym miejscem do pilnowania.

Scenariusz zakłada, że system rejestracji gości InnerWeb jest źródłem zdarzeń, a kanał na komunikatorze ich odbiorcą. Dzięki temu kierownik ochrony widzi przebieg wizyty w jednym wątku, bez logowania się do panelu i bez telefonów od recepcji.

Jak zdarzenie dociera do kanału

Webhook zdarzeń recepcji publikuje sześć typów zdarzeń: rejestrację gościa, aktualizację grupy na stanowisku rejestracji, przerwanie grupy, niezaliczenie szkolenia, zaliczenie szkolenia oraz wejście gościa. Adres odbiorcy ustawia się w panelu w jednym polu; gdy pole jest puste, nic nie wychodzi.

Zdarzenia trafiają na kolejkę komunikatów i są wysyłane asynchronicznie jako JSON z limitem czasu 5 sekund. Dzięki temu błąd webhooka nie przerywa rejestracji gościa, skanu ani zaliczenia szkolenia. Recepcja pracuje normalnie, nawet gdy komunikator ma awarię.

Co zawiera pojedyncze zdarzenie

Każde zdarzenie niesie adres serwera, czas zdarzenia w formacie ISO 8601 w strefie Europe/Warsaw oraz gotowy tekst do wyświetlenia. Odbiorca nie musi więc składać komunikatu z pól, wystarczy opublikować gotowy tekst.

Dlaczego nie ma numeru telefonu gościa

Zdarzenie rejestracji gościa celowo nie niesie numeru telefonu, bo trafia do kanału klienta, w którym czyta je wiele osób. To przykład minimalizacji danych: kanał dostaje informację potrzebną do reakcji, a nie dane kontaktowe, które zostają w systemie rejestracji.

Parametry webhooka recepcji

Parametry webhooka recepcjiWykres słupkowy: 6 typów zdarzeń, limit wysyłki 5 sekund, czas życia grupy 34 minuty.010203040wartośćTypy zdarzeń: 6 wartość6Typy zdarzeńLimit wysyłki (s): 5 wartość5Limit wysyłki (s)Życie grupy (min): 34 wartość34Życie grupy (min)
Źródło: Opis funkcji Reception Events Webhook (dokumentacja produktu)

Odbiorca: workflow n8n i kanał zakładu

Odbiorcą zdarzeń jest workflow n8n, który publikuje wpisy w kanale zakładu na komunikatorze, w zależności od wyboru zakładu w Mattermost albo Telegram. Wpis o grupie w toku jest zastępowany nowym wpisem, dzięki czemu kanał nie zapełnia się kolejnymi odsłonami tej samej wizyty.

Przy przerwaniu grupy lub niezaliczeniu szkolenia workflow publikuje nowy, czerwony wpis z dźwiękiem. Ten wzorzec ma sens organizacyjny: zwykłe zdarzenia są ciche i porządkują się same, a odchylenie od normy zwraca uwagę.

Dwie pułapki, które warto znać przed startem

Pierwsza pułapka dotyczy szkoleń. Grupa szkoleniowa na stanowisku rejestracji żyje 34 minuty, a zdarzenie o niezaliczeniu szkolenia zgłasza, że grupa wygasła albo nikomu nie wymagano szkolenia. Odbiorca dostaje alert tylko o porażce, bez osobnego powiadomienia o sukcesie. Kierownik ochrony, który oczekuje potwierdzenia każdego zaliczenia, musi to uwzględnić w sposobie czytania kanału: brak alertu nie jest dowodem zaliczenia, od tego jest raport szkoleń.

Druga pułapka to duplikaty. Alert o niezaliczeniu szkolenia jest zabezpieczony znacznikiem w Redisie, który blokuje powtórzenia. Gdy wysyłka się nie uda, blokada jest zwalniana, żeby alert mógł wyjść ponownie. W praktyce zdarza się więc, że po awarii komunikatora ten sam alert pojawi się raz jeszcze, co jest zachowaniem zamierzonym.

Wnioski dla kierownika ochrony

Scenariusz daje kierownikowi ochrony jedno źródło informacji o wizytach, bez wciągania do kanału danych kontaktowych gości. Warunkiem jest, aby odbiorca w kanale był prawidłowo skonfigurowany i żeby zespół znał regułę o alertach tylko dla porażek.

Przed uruchomieniem warto przeprowadzić próbną rejestrację i sprawdzić, czy sześć typów zdarzeń daje oczekiwane wpisy w kanale: tak powstaje dowód odbioru po stronie zakładu.

Materiał wideo

Często zadawane pytania

Czy awaria komunikatora zablokuje rejestrację gościa?

Nie. Zdarzenia idą kolejką asynchronicznie, z limitem 5 sekund, a błąd webhooka nie przerywa rejestracji, skanu ani zaliczenia szkolenia.

Czy numer telefonu gościa pojawi się w kanale?

Nie. Zdarzenie rejestracji gościa celowo go nie zawiera, bo trafia do kanału klienta, który czyta wiele osób.

Czy dostanę powiadomienie o każdym zaliczonym szkoleniu?

Odbiorca dostaje alert o porażce, bez osobnego powiadomienia o sukcesie. Potwierdzenie zaliczeń znajdziesz w raportach szkoleń.

Powiadomienia recepcji w Twoim kanale

Umów rozmowę i zobacz, jak zdarzenia rejestracji gości trafiają do komunikatora Twojego zakładu.

Porozmawiajmy