InnerWeb
Přejít na obsah

Upozornění recepce na komunikátor provozovny

Vedoucí ostrahy v potravinářské provozovně chce vědět, kdo se zaregistroval a kdo vstoupil na areál, bez nutnosti dozorovat obrazovku recepce. Webhook událostí recepce posílá tyto informace do kanálu na komunikátoru provozovny a telefonní číslo hosta do něj záměrně nepatří. Popisujeme scénář od události až po zápis v kanálu.

6
typů událostí recepce
Zdroj: karta
5 s
časový limit odeslání webhooku
Zdroj: karta
34 min
doba života školicí skupiny
Zdroj: karta

Potřeba: informace o hostech tam, kam ostraha stejně hledí

Potravinářská provozovna s vyššími hygienickými a bezpečnostními nároky má obvykle jeden vstupní bod pro hosty a několik příjemců informací: ostrahu, doprovázejícího návštěvu, vedoucího směny. Každý z nich už komunikátor provozovny používá, takže samostatná obrazovka nebo e-mailová schránka je pro ně jen další místo, na které je třeba dávat pozor.

Scénář předpokládá, že zdrojem událostí je registrační systém hostů InnerWeb a příjemcem kanál na komunikátoru. Vedoucí ostrahy tak vidí průběh návštěvy v jediném vlákně, bez přihlašování do panelu a bez telefonátů od recepce.

Jak se událost dostane do kanálu

Webhook událostí recepce vysílá šest typů událostí: registraci hosta, aktualizaci skupiny na registračním stanovišti, přerušení skupiny, neabsolvování školení, absolvování školení a vstup hosta. Adresu příjemce nastavíte v panelu v jediném poli; pokud je pole prázdné, nic neodchází.

Události se řadí do fronty zpráv a odesílají se asynchronně jako JSON s časovým limitem 5 sekund. Chyba webhooku tak nepřeruší registraci hosta, sken ani absolvování školení. Recepce pracuje normálně, i když má komunikátor výpadek.

Co obsahuje jedna událost

Každá událost nese adresu serveru, čas události ve formátu ISO 8601 v časovém pásmu Europe/Warsaw a hotový text k zobrazení. Příjemce tedy nemusí skládat zprávu z polí, stačí zveřejnit hotový text.

Proč v události není telefonní číslo hosta

Událost registrace hosta záměrně nenese telefonní číslo, protože končí v kanálu klienta, který ji čte více lidí. Jde o příklad minimalizace údajů: kanál dostane informaci potřebnou k reakci, nikoli kontaktní údaje, které zůstávají v registračním systému.

Parametry webhooku recepce

Parametry webhooku recepceSloupcový graf: 6 typů událostí, limit odeslání 5 sekund, doba života skupiny 34 minut.010203040hodnotaTypy událostí: 6 hodnota6Typy událostíLimit odeslání (s): 5 hodnota5Limit odeslání (s)Život skupiny (min): 34 hodnota34Život skupiny (min)
Zdroj: Popis funkce Reception Events Webhook (dokumentace produktu)

Příjemce: workflow n8n a kanál provozovny

Příjemcem událostí je workflow n8n, které zveřejňuje zápisy v kanálu provozovny na komunikátoru, podle volby provozovny v Mattermostu nebo v Telegramu. Zápis o skupině v běhu se nahrazuje novým zápisem, takže se kanál nezaplní dalšími zobrazeními téže návštěvy.

Při přerušení skupiny nebo neabsolvování školení workflow zveřejní nový červený zápis se zvukem. Tento vzor má organizační smysl: běžné události jsou tiché a řadí se samy, odchylka od normy však upoutá pozornost.

Dvě úskalí, která je dobré znát předem

První úskalí se týká školení. Skupina školení na registračním stanovišti žije 34 minut a událost o neabsolvování školení hlásí, že skupina vypršela nebo že školení nikdo nevyžadoval. Příjemce dostane upozornění jen na neúspěch, bez samostatné zprávy o úspěchu. Vedoucí ostrahy, který očekává potvrzení každého absolvování, s tím musí počítat při čtení kanálu: chybějící upozornění není důkazem absolvování, na to slouží přehled školení.

Druhé úskalí jsou duplicity. Upozornění na neabsolvování školení je chráněno značkou v Redisu, která blokuje opakování. Když se odeslání nepovede, značka se uvolní, aby upozornění mohlo odejít znovu. V praxi se tedy může stát, že po výpadku komunikátoru se stejné upozornění objeví ještě jednou, což je zamýšlené chování.

Závěry pro vedoucího ostrahy

Scénář dává vedoucímu ostrahy jediný zdroj informací o návštěvách, aniž by do kanálu vtahoval kontaktní údaje hostů. Předpokladem je, aby byl příjemce v kanálu správně nastaven a aby tým znal pravidlo, že upozornění přicházejí jen při neúspěchu.

Před spuštěním je vhodné provést zkušební registraci a ověřit, že šest typů událostí dává v kanálu očekávané zápisy: tím vznikne důkaz o přijetí na straně provozovny.

Videomateriál

Často kladené otázky

Zablokuje výpadek komunikátoru registraci hosta?

Ne. Události jdou asynchronně přes frontu s limitem 5 sekund a chyba webhooku nepřeruší registraci, sken ani absolvování školení.

Objeví se v kanálu telefonní číslo hosta?

Ne. Událost registrace hosta ho záměrně neobsahuje, protože končí v kanálu klienta, který čte více osob.

Dostanu upozornění na každé absolvované školení?

Příjemce dostane upozornění na neúspěch, bez samostatné zprávy o úspěchu. Potvrzení absolvování najdete v přehledech školení.

Upozornění recepce ve vašem kanálu

Domluvte si schůzku a uvidíte, jak se události registrace hostů dostanou do komunikátoru vaší provozovny.

Pojďme si promluvit