InnerWeb
Zum Inhalt springen

FAQ: Webhooks für Empfangsereignisse im Industriebetrieb

Die Webhooks für Empfangsereignisse umfassen sechs Nachrichtentypen, die das System an eine festgelegte Adresse sendet, wenn sich ein Gast registriert, das Werksgelände betritt oder eine Schulungsgruppe eine Schulung abschließt oder abbricht. Wir haben die Fragen zusammengestellt, die IT-Leiter und Leiter des Werkschutzes vor dem Anschluss des Empfängers stellen: was die Nachricht enthält, wie schnell sie versendet wird und was geschieht, wenn der Empfänger vorübergehend nicht antwortet.

6
Typen von Empfangsereignissen
Quelle: Funktionskarte
5 s
Zeitlimit für den Versand des Webhooks
Quelle: Funktionskarte
34 min
Lebensdauer der Schulungsgruppe
Quelle: Funktionskarte

Welche Empfangsereignisse das System veröffentlicht

Der Webhook für Empfangsereignisse veröffentlicht sechs Ereignistypen: guest_registered, station_group_updated, station_group_aborted, station_training_failed, station_training_completed und guest_entered. Jeder Typ entspricht einem anderen Moment auf dem Weg des Gastes durch den Empfang: von der Registrierung über die Gruppenschulung am Arbeitsplatz bis zum Betreten des Werksgeländes.

Der Empfänger muss nicht alle Typen verarbeiten. Ein typischer Workflow im Integrationswerkzeug verteilt die Nachrichten anhand des Feldes für den Ereignistyp und leitet jede an einen eigenen Kanal oder eine eigene Vorlage für den Eintrag weiter.

Welches Ereignis bedeutet, dass sich ein Gast registriert hat?

Das Ereignis guest_registered erscheint nach Abschluss der Gästeregistrierung. Es enthält bewusst keine Telefonnummer des Gastes, denn es geht in den Kanal des Kunden und nicht an ein System, das Kontaktdaten verarbeiten darf. Für den Werkschutz genügt die Information, wer die Besuchsregistrierung wann vorgenommen hat.

Was bedeuten die Ereignisse zur Gruppe am Registrierungsarbeitsplatz?

Die Ereignisse station_group_updated und station_group_aborted beschreiben die Schulungsgruppe am Registrierungsarbeitsplatz: das erste meldet eine Änderung ihres Status, das zweite einen Abbruch. Die Ereignisse station_training_completed und station_training_failed schließen die Schulung mit Erfolg oder Misserfolg ab. Das Ereignis guest_entered bestätigt den Zutritt des Gastes.

Was ein einzelnes Ereignis enthält

Jedes Empfangsereignis wird als JSON übermittelt. Es enthält die Adresse des Servers, von dem es stammt, den Zeitpunkt des Ereignisses im Format ISO 8601 in der Zeitzone Europe/Warsaw sowie einen fertigen Text, der ohne weitere Bearbeitung in den Eintrag übernommen werden kann. Damit benötigt ein einfacher Empfänger zwei Schritte: die Nachricht annehmen und das Feld mit dem Text veröffentlichen.

Der fertige Text ersetzt die übrigen Felder nicht. Wenn der Werkschutz nach Ereignistyp filtern oder die Zutritte innerhalb einer Schicht zählen möchte, sollte der Empfänger das Zeit- und das Typfeld verwenden und den Text nicht auswerten.

Enthält das Ereignis personenbezogene Daten des Gastes?

Das Ereignis der Gästeregistrierung enthält keine Telefonnummer. Der Umfang der übrigen Daten wird bei der Konfiguration des Empfängers festgelegt, wobei gilt: Datensparsamkeit. In den Kanal des Werks gelangt nur so viel Information, wie der Werkschutz zum Reagieren benötigt.

In welcher Zeitzone steht die Uhrzeit des Ereignisses?

In der Zeitzone Europe/Warsaw, im Format ISO 8601. Ein Empfänger in einer anderen Zeitzone sollte die Uhrzeit ausdrücklich umrechnen und nicht die lokale Zeit des Servers annehmen.

Zeitlimits bei Empfangsereignissen

Zeitlimits bei EmpfangsereignissenDas Diagramm vergleicht das Limit für den Versand des Webhooks von 5 Sekunden mit der Lebensdauer der Schulungsgruppe von 2040 Sekunden.05001000150020002500sLimit für den Versand desWebhooksLimit für den Versand des Webhooks: 5 s5Lebensdauer derSchulungsgruppeLebensdauer der Schulungsgruppe: 2040 s2040
Quelle: Funktionskarte Empfangsereignisse (34 Minuten umgerechnet auf 2040 Sekunden)

Wie und wann das Ereignis gesendet wird

Die Adresse des Empfängers für Ereignisse legt der Administrator im Portal im Feld webhook:reception_url fest. Ein leeres Feld bedeutet, dass nichts hinausgeht. Die Integration deaktivieren heißt daher, die Adresse zu löschen.

Ereignisse werden über eine Nachrichtenwarteschlange asynchron als JSON gesendet, mit einem Zeitlimit von 5 Sekunden. Registrierung eines Gastes, Scan und Abschluss einer Schulung warten nicht auf die Antwort des Empfängers.

Verlangsamt ein langsamer Empfänger den Empfang?

Nein. Der Versand erfolgt außerhalb des Pfads der Gästebetreuung, und ein Fehler des Webhooks unterbricht weder die Registrierung eines Gastes noch den Scan oder den Abschluss einer Schulung. Die schlimmste Folge eines nicht erreichbaren Empfängers ist ein fehlender Eintrag im Kanal, kein blockierter Empfang.

Was passiert, wenn der Empfänger vorübergehend nicht erreichbar ist?

Ein Ereignis, das nicht innerhalb des Limits von 5 Sekunden zugestellt werden konnte, beendet den Versuch mit einem Fehler. Da der Fehler keinen Geschäftsprozess beeinflusst, sollte der Werkschutz einen zweiten Informationsweg haben, zum Beispiel den Bildschirm am Registrierungsarbeitsplatz, und der Empfänger sollte wie jeder andere Dienst des Werks überwacht werden.

Für Installationen, in denen das Netz den ausgehenden Verkehr vom Anwendungsserver blockiert, gibt es einen eigenen Zustellmodus mit Abholung der Nachrichten durch einen Poller. Wir beschreiben ihn in den Unterlagen zur Wahl zwischen den Modi direct und outbox.

Schulungsgruppen und Warnung bei Nichtbestehen

Eine Schulungsgruppe am Registrierungsarbeitsplatz besteht 34 Minuten. Nach Ablauf dieser Zeit verfällt sie, und der Empfänger erhält das Ereignis station_training_failed. Dasselbe Ereignis meldet auch die Situation, in der von der Gruppe niemand zur Schulung verpflichtet war.

Der Empfänger erhält nur eine Warnung bei Misserfolg, ohne eine gesonderte Meldung über den Erfolg. So füllt sich der Kanal des Werkschutzes nicht mit Einträgen über Vorgänge, die korrekt verlaufen sind, und die Aufmerksamkeit des Bedieners richtet sich auf Ausnahmen.

Kann die Warnung über ein Nichtbestehen zweimal eintreffen?

Doppelte Meldungen verhindert eine Markierung SET NX in Redis. Schlägt der Versand fehl, wird die Sperre wieder freigegeben, damit die Warnung erneut gesendet werden kann. Das ist eine bewusste Entscheidung: Eine wiederholte Warnung ist besser als eine ausbleibende.

Wie der Empfänger auf Seiten des Werks aussieht

Typischer Empfänger der Ereignisse des Empfangs ist ein Workflow im Werkzeug n8n, der Einträge im Kanal des Werks auf einem Messenger veröffentlicht, Mattermost oder Telegram. Ein Eintrag über eine laufende Gruppe wird durch einen neuen Eintrag ersetzt, und bei Abbruch oder Nichtbestehen erscheint ein roter Eintrag mit Signalton.

Das Ersetzen von Einträgen hat einen praktischen Nutzen: Der Kanal zeigt einen einzigen aktuellen Stand der Gruppe und keine Reihe von Wiederholungen. Der Werkschutz sieht auf dem Telefon eine Zeile pro Gruppe, und erst ein Farbwechsel erfordert eine Reaktion.

Muss ich n8n verwenden?

Nein. Empfänger kann jeder Dienst sein, der JSON über HTTPS annimmt: ein Messenger, ein Ticketsystem oder eine eigene Anwendung des Integrators. Die Beschreibung des Workflows in n8n zeigt ein erprobtes Muster, keine Pflicht.

Wie prüfe ich, dass die Integration funktioniert?

Nachdem Sie die Adresse im Portal eingetragen haben, registrieren Sie einen Testgast und prüfen, ob der Eintrag im Kanal erscheint. Das genaue Vorgehen beschreibt der Leitfaden zur Konfiguration des Empfangs-Webhooks Schritt für Schritt.

Videomaterial

Häufig gestellte Fragen

Wiederholt das System den Versand eines Empfangsereignisses?

Im direkten Modus dauert der Versuch bis zum Limit von 5 Sekunden und endet mit einem Ergebnis. Bei der Warnung über ein Nichtbestehen der Schulung gibt ein fehlgeschlagener Versand die Sperre für Duplikate frei, sodass die Warnung erneut hinausgehen kann.

Stoppt das Deaktivieren des Webhooks die Registrierung der Gäste?

Nein. Ein leeres Adressfeld bedeutet nur, dass nichts hinausgeht. Registrierung, Scans und Schulungen funktionieren unverändert.

Kann ich Meldungen über erfolgreiche Schulungen erhalten?

Das Ereignis über einen Erfolg gibt es, doch die Warnung wird nur bei Misserfolg ausgelöst. Ein Eintrag über eine laufende Gruppe wird durch einen neuen ersetzt, sodass der Kanal nicht wächst.

Gelangt die Telefonnummer des Gastes in den Kanal des Werks?

Nein. Das Ereignis der Gästeregistrierung enthält bewusst keine Telefonnummer.

Verbinden Sie die Empfangsereignisse mit dem Kanal des Werks

Wir zeigen in einer Demo, wie die Nachrichten des Empfangs im Messenger des Werkschutzes ankommen und was der Diensthabende sieht. Vereinbaren Sie ein Gespräch mit dem Team von InnerWeb.

Sprechen wir