Jaké události recepce systém zveřejňuje
Webhook událostí recepce zveřejňuje šest typů událostí: guest_registered, station_group_updated, station_group_aborted, station_training_failed, station_training_completed a guest_entered. Každý typ odpovídá jinému okamžiku na cestě hosta recepcí: od registrace přes skupinové školení na stanovišti až po vstup na areál závodu.
Příjemce nemusí zpracovávat všechny typy. Typický postup v integračním nástroji rozděluje zprávy podle pole typu události a každou směruje do samostatného kanálu nebo do vlastní šablony záznamu.
Která událost znamená, že se host zaregistroval?
Událost guest_registered se objeví po dokončení registrace hosta. Záměrně nenese telefonní číslo hosta, protože směřuje do kanálu zákazníka, nikoli do systému, který má právo pracovat s kontaktními údaji. Pro bezpečnostní službu stačí informace, kdo a kdy návštěvu zaregistroval.
Co znamenají události skupiny na stanovišti recepce?
Události station_group_updated a station_group_aborted popisují skupinové školení na stanovišti registrace: první hlásí změnu jejího stavu, druhá její přerušení. Události station_training_completed a station_training_failed uzavírají školení úspěchem nebo neúspěchem. Událost guest_entered potvrzuje vstup hosta.
Co obsahuje jednotlivá událost
Každá událost recepce se přenáší jako JSON. Obsahuje adresu serveru, ze kterého pochází, čas události ve formátu ISO 8601 v časovém pásmu Europe/Warsaw a hotový text, který lze vložit do záznamu bez dalšího zpracování. Nejjednodušší příjemce proto vystačí se dvěma kroky: přijmout zprávu a zveřejnit pole s textem.
Hotový text nenahrazuje ostatní pole. Pokud bezpečnost chce filtrovat záznamy podle typu události nebo počítat vstupy během směny, má příjemce použít pole času a typu, a ne text parsovat.
Obsahují události osobní údaje hosta?
Událost registrace hosta neobsahuje telefonní číslo. Rozsah ostatních údajů se určuje při nastavení příjemce a minimalizace je zásadou: do kanálu závodu přichází jen tolik informací, kolik bezpečnost potřebuje k reakci.
V jakém časovém pásmu je čas události?
V pásmu Europe/Warsaw, ve formátu ISO 8601. Příjemce v jiném pásmu má čas přepočítat výslovně a nemá předpokládat místní čas serveru.
Časové limity v událostech recepce
Jak a kdy se událost odesílá
Adresu příjemce událostí nastaví správce v panelu do pole webhook:reception_url. Prázdné pole znamená, že nic neodchází, takže vypnutí integrace spočívá ve vymazání adresy.
Události se řadí do fronty zpráv a odesílají se asynchronně jako JSON s časovým limitem 5 sekund. Registrace hosta, sken i absolvování školení na odpověď příjemce nečekají.
Zpomalí pomalý příjemce recepci?
Ne. Odeslání probíhá mimo cestu obsluhy hosta a chyba webhooku nepřeruší registraci hosta, sken ani absolvování školení. Nejhorším důsledkem nedostupného příjemce je chybějící záznam v kanálu, a ne zablokovaná recepce.
Co se stane, když je příjemce dočasně nedostupný?
Událost, kterou se nepodařilo odeslat během limitu 5 sekund, pokus končí chybou. Protože chyba neovlivní obchodní proces, měla by bezpečnost mít druhý zdroj informací, například obrazovku stanoviště recepce, a příjemce by měl být sledován jako každá jiná služba závodu.
Pro instalace, kde síť blokuje odchozí provoz z aplikačního serveru, je k dispozici samostatný režim doručování s příjmem zpráv přes poller. Popisujeme jej v materiálech o volbě režimu direct nebo outbox.
Skupiny školení a upozornění na neúspěch
Skupina školení na stanovišti registrace žije 34 minut. Po uplynutí této doby vyprší a příjemce obdrží událost station_training_failed. Stejná událost hlásí situaci, kdy nikdo ze skupiny nemusel absolvovat školení.
Příjemce dostává upozornění pouze na neúspěch, bez samostatného oznámení o úspěchu. Kanál bezpečnosti se tak nezaplní záznamy o věcech, které proběhly správně, a pozornost operátora zůstane u výjimek.
Může upozornění na neúspěch přijít dvakrát?
Duplicitám brání značka SET NX v Redisu. Pokud odeslání selže, zámek se uvolní, aby upozornění mohlo odejít znovu. Jde o vědomé rozhodnutí: raději zopakované upozornění než žádné.
Jak vypadá příjemce na straně závodu
Typickým příjemcem událostí recepce je workflow v nástroji n8n, které zveřejňuje záznamy v kanálu závodu na komunikátoru Mattermost nebo Telegram. Záznam o skupině v průběhu je nahrazen novým záznamem a při přerušení nebo neúspěchu se objeví červený záznam se zvukem.
Nahrazování záznamů má praktický přínos: kanál ukazuje jediný aktuální stav skupiny, a ne řadu opakování. Bezpečnost vidí na telefonu jeden řádek na skupinu a teprve změna barvy vyžaduje reakci.
Musím používat n8n?
Ne. Příjemcem může být libovolná služba přijímající JSON přes HTTPS: komunikátor, systém hlášení incidentů nebo vlastní aplikace integrátora. Popis workflow v n8n ukazuje ověřený vzor, nikoli požadavek.
Jak ověřit, že integrace funguje?
Po zadání adresy v panelu zaregistrujte zkušebního hosta a zkontrolujte, zda se záznam objevil v kanálu. Podrobný postup popisuje průvodce nastavením webhooku recepce krok za krokem.
Videomateriál
Často kladené otázky
Opakuje systém odeslání události recepce?
Při přímém režimu pokus trvá do limitu 5 sekund a skončí výsledkem. U upozornění na neúspěch školení nepodařené odeslání uvolní zámek duplicit, takže upozornění může odejít znovu.
Zastaví vypnutí webhooku registraci hostů?
Ne. Prázdné pole s adresou znamená jen to, že nic neodchází. Registrace, skeny i školení fungují beze změny.
Mohu dostávat upozornění na úspěšná školení?
Událost o absolvování existuje, ale upozornění odchází jen při neúspěchu. Záznam o skupině v průběhu je nahrazen novým, takže kanál neroste.
Dostane se telefonní číslo hosta do kanálu závodu?
Ne. Událost registrace hosta telefonní číslo záměrně nenese.
Připojme události recepce ke kanálu závodu
Na demu ukážeme, jak se zprávy recepce dostávají do komunikátoru bezpečnosti a co uvidí dispečer. Domluvte si konzultaci s týmem InnerWeb.
Pojďme si promluvit