InnerWeb
Zum Inhalt springen

Benachrichtigungen der Rezeption im Messenger des Werks

Der Werkschutzleiter eines Lebensmittelbetriebs möchte wissen, wer sich angemeldet hat und wer das Werksgelände betreten hat, ohne neben dem Empfangsbildschirm Dienst zu schieben. Ein Webhook mit Ereignissen der Rezeption übermittelt diese Informationen in den Kanal des Werks im Messenger, wobei die Telefonnummer des Gastes darin bewusst nicht erscheint. Wir beschreiben das Szenario vom Ereignis bis zum Eintrag im Kanal.

6
Typen von Ereignissen der Rezeption
Quelle: karta
5 s
Zeitgrenze für den Versand des Webhooks
Quelle: karta
34 min
Lebensdauer einer Schulungsgruppe
Quelle: karta

Bedarf: Informationen über Gäste dort, wo der Werkschutz ohnehin hinsieht

Ein Lebensmittelbetrieb mit erhöhten Anforderungen an Hygiene und Sicherheit hat in der Regel einen einzigen Eingangspunkt für Gäste und mehrere Empfänger der Information: den Werkschutz, den Ansprechpartner des Besuchs und den Schichtleiter. Jeder von ihnen nutzt bereits den betriebsinternen Messenger, daher wäre ein eigener Bildschirm oder ein weiteres Postfach nur ein zusätzlicher Ort, den man im Blick behalten muss.

Das Szenario geht davon aus, dass das System zur Gästeanmeldung von InnerWeb die Quelle der Ereignisse ist und ein Kanal im Messenger deren Empfänger. So sieht der Werkschutzleiter den Verlauf eines Besuchs in einem einzigen Thread, ohne sich im Panel anzumelden und ohne Anrufe von der Rezeption.

Wie ein Ereignis den Kanal erreicht

Der Webhook für Ereignisse der Rezeption veröffentlicht sechs Typen von Ereignissen: die Anmeldung eines Gastes, die Aktualisierung einer Gruppe am Anmeldeplatz, den Abbruch einer Gruppe, das Nichtbestehen einer Unterweisung, das Bestehen einer Unterweisung und das Betreten durch einen Gast. Die Adresse des Empfängers wird im Panel in einem einzigen Feld eingestellt. Ist das Feld leer, wird nichts gesendet.

Die Ereignisse laufen über eine Warteschlange und werden asynchron als JSON mit einer Zeitgrenze von 5 Sekunden gesendet. Dadurch unterbricht ein Fehler des Webhooks weder die Anmeldung eines Gastes noch den Scan oder das Bestehen einer Unterweisung. Die Rezeption arbeitet normal weiter, auch wenn der Messenger eine Störung hat.

Was ein einzelnes Ereignis enthält

Jedes Ereignis enthält die Adresse des Servers, den Zeitpunkt des Ereignisses im Format ISO 8601 in der Zeitzone Europe/Warsaw sowie einen fertigen Text zur Anzeige. Der Empfänger muss die Nachricht also nicht aus einzelnen Feldern zusammensetzen, es genügt, den fertigen Text zu veröffentlichen.

Warum die Telefonnummer des Gastes fehlt

Das Ereignis einer Gästeanmeldung enthält bewusst keine Telefonnummer, denn es landet in einem Kanal des Kunden, den viele Personen lesen. Das ist ein Beispiel für Datenminimierung: Der Kanal erhält die Information, die für die Reaktion nötig ist, und nicht die Kontaktdaten, die im Anmeldesystem verbleiben.

Parameter des Webhooks der Rezeption

Parameter des Webhooks der RezeptionBalkendiagramm: 6 Typen von Ereignissen, Zeitgrenze für den Versand 5 Sekunden, Lebensdauer der Gruppe 34 Minuten.010203040WertTypen von Ereignissen: 6 Wert6 WertTypen von EreignissenZeitgrenze Versand (s): 5 Wert5 WertZeitgrenze Versand (s)Lebensdauer Gruppe (min): 34 Wert34 WertLebensdauer Gruppe (min)
Quelle: Funktionsbeschreibung Reception Events Webhook (Produktdokumentation)

Empfänger: Workflow in n8n und Kanal des Werks

Empfänger der Ereignisse ist ein Workflow in n8n, der Einträge im Kanal des Werks im Messenger veröffentlicht, je nach Wahl des Werks in Mattermost oder Telegram. Ein Eintrag über eine laufende Gruppe wird durch einen neuen Eintrag ersetzt, sodass sich der Kanal nicht mit immer neuen Fassungen desselben Besuchs füllt.

Beim Abbruch einer Gruppe oder beim Nichtbestehen einer Unterweisung veröffentlicht der Workflow einen neuen, roten Eintrag mit Ton. Dieses Muster hat einen organisatorischen Sinn: Gewöhnliche Ereignisse sind still und ordnen sich von selbst, eine Abweichung von der Norm fällt dagegen auf.

Zwei Fallstricke, die man vor dem Start kennen sollte

Der erste Fallstrick betrifft Unterweisungen. Eine Schulungsgruppe am Anmeldeplatz lebt 34 Minuten, und das Ereignis über das Nichtbestehen einer Unterweisung meldet, dass die Gruppe abgelaufen ist oder dass niemand zu einer Unterweisung verpflichtet war. Der Empfänger erhält einen Alarm nur bei einem Misserfolg, ohne eine gesonderte Meldung über einen Erfolg. Ein Werkschutzleiter, der die Bestätigung jeder bestandenen Unterweisung erwartet, muss das bei der Lektüre des Kanals berücksichtigen: Das Ausbleiben eines Alarms ist kein Nachweis einer bestandenen Unterweisung, dafür ist der Schulungsbericht da.

Der zweite Fallstrick sind Duplikate. Der Alarm über das Nichtbestehen einer Unterweisung ist durch eine Markierung in Redis gesichert, die Wiederholungen blockiert. Schlägt der Versand fehl, wird die Sperre freigegeben, damit der Alarm erneut gesendet werden kann. In der Praxis kann daher nach einer Störung des Messengers derselbe Alarm ein weiteres Mal erscheinen, und das ist das beabsichtigte Verhalten.

Schlussfolgerungen für den Werkschutzleiter

Das Szenario gibt dem Werkschutzleiter eine einzige Informationsquelle über Besuche, ohne Kontaktdaten der Gäste in den Kanal zu holen. Voraussetzung ist, dass der Empfänger im Kanal richtig eingerichtet ist und das Team die Regel kennt, dass Alarme nur für Misserfolge gelten.

Vor der Inbetriebnahme sollte eine Probeanmeldung durchgeführt und geprüft werden, ob die sechs Typen von Ereignissen die erwarteten Einträge im Kanal ergeben. So entsteht ein Nachweis des Empfangs auf Seiten des Werks.

Videomaterial

Häufig gestellte Fragen

Blockiert ein Ausfall des Messengers die Anmeldung eines Gastes?

Nein. Die Ereignisse laufen asynchron über eine Warteschlange mit einer Zeitgrenze von 5 Sekunden. Ein Fehler des Webhooks unterbricht weder die Anmeldung noch den Scan oder das Bestehen einer Unterweisung.

Erscheint die Telefonnummer des Gastes im Kanal?

Nein. Das Ereignis einer Gästeanmeldung enthält sie bewusst nicht, denn es landet in einem Kanal des Kunden, den viele Personen lesen.

Erhalte ich eine Meldung zu jeder bestandenen Unterweisung?

Der Empfänger erhält einen Alarm bei einem Misserfolg, ohne gesonderte Meldung über einen Erfolg. Die Bestätigung bestandener Unterweisungen finden Sie in den Schulungsberichten.

Benachrichtigungen der Rezeption in Ihrem Kanal

Vereinbaren Sie ein Gespräch und sehen Sie, wie Ereignisse der Gästeanmeldung in den Messenger Ihres Betriebs gelangen.

Sprechen wir