Warum SIGNL4
Mit Hilfe des SIGNL4-WebHooks könnt ihr Ereignisse von externen Systemen oder Anwendungen Alarm auslösen und an euer SIGNL4-Team senden. Die Basis-URL des WebHooks lautet https://connect.signl4.com/webhook/. Anders als bei der SIGNL4-REST-API basiert die Authentifizierung auf einem API-Schlüssel, der in der Request-URL codiert ist und mit eurem SIGNL4-Team-Secret übereinstimmt, z. B. https://connect.signl4.com/webhook/{teamSecret}.
Integration
Szenarien für die Alarmierung mit SIGNL4
Störmeldungen werden an SIGNL4 gesendet
Sichere Übermittelung, Kategorisierung und zielgenaues Routing
Mobile, persistente Alarmierung von Bereitschafts- und Diensthabenden per Push, SMS und Anruf mit Nachverfolgung und Eskalation
UND SO FUNKTIONIERT ES
In unserem Beispiel verwenden wir die Raise Event Funktion, um Ereignisdaten an SIGNL4 zu senden. Die einzelnen Ereignisparameter können beliebig sein und werden automatisch analysiert, aufgeschlüsselt und anschließend der mobilen App als Kacheln dargestellt.
Mit Hilfe von optionalen, speziellen SIGNL4-Parametern können wir bestimmte Alarm-Kategorien gezielt ansteuern, einen Ort angeben und eine bestimmte Art der Quittierung anfordern.
Informationen zum Setup der Webhooks findest du in unserer Getting-Started-Dokumentation.
Integrations Schritte
Die Parameter die wir in der Payload übergeben werden sind beispielsweise:
{
„Gate Id“: „Gate Id“
„Message“: „Aggressiver Passagier“,
„Source“: „Gate Agent“,
„Type“: „Sicherheitswarnung“,
„X-S4-Service“: „Sicherheit“,
„X-S4-Location“: „40.6413111, -73.7781391“,
„X-S4-AlertingScenario“: „multi_ack“,
„X-S4-ExternalID“: „INC091210“
}
Mit den folgenden Parametern könnt ihr euren Signl-Alarm erweitern oder dessen Verarbeitung beeinflussen:
X-S4-Service: Weist dem Signl die Service- / Systemkategorie mit dem angegebenen Namen zu.
X-S4-Location: Überträgt Standortinformationen („Breiten- und Längengrad“) mit dem Alarm und zeigt euch dazu eine passende Karte in der mobilen App an.
X-S4-AlertingScenario: Setzt „single_ack“ , wenn nur eine Person dieses Signl bestätigen muss. Setzt „multi_ack“, falls diese Warnung durch die Personen bestätigt werden muss, die zum Zeitpunkt des Singls im Dienst sind.
X-S4-ExternalID: Wenn das Ereignis aus dem System eines Drittanbieters stammt, kann dieser Parameter verwendet werden, um die eindeutige ID dieses Datensatzes zu definieren. Dies erlaubt eine Korrelation/Synchronisation zwischen Datensatz und Signl. Für die Rückmeldung an das Drittsystem sollte dann der Outbound Webhook verwendet werden.
X-S4-Filtering: Erlaubt das Angeben eines booleschen Wertes von true oder false an, um die Ereignisfilterung für dieses Ereignis zu erzwingen, oder nicht. Wenn der Wert auf „true“ gesetzt ist, wird das Ereignis nur dann eine Benachrichtigung an das Team senden, wenn es mindestens ein Schlüsselwort aus einer der Dienst- und Systemkategorien enthält (z.B.: ist auf der Whitelist).
X-S4-Status: Neuer Parameter um einen bestehenden Alarm zu schliessen. Der Wert muss dazu „resolved“ sein und der X-S4-ExternalID Parameter muss den gleichen Wert haben wie beim Auslösen des Alarms. Weitere Infos weiter unten.
Hier könnt ihr diese Schritte unter der folgenden URL ausprobieren: https://connect.signl4.com/webhook/docs/index.html
„POST“ klicken.
Das Team Secret eingeben.
Die Ereignisparameter eingeben.
„Try it out“ klicken.
Im Juni 2020 haben wir die Möglichkeit hinzugefügt, bestehende Alarme aus dem Drittsystem zu aktualisieren. Hier gibt es weitere Infos dazu: https://www.signl4.com/de/update-juli-2020-alarme-schliessen/
ALARM-OPTIMIERUNG
SIGNL4 kann die Wahrnehmung, Reaktion und Bearbeitung von kritischen Alarmen entscheidend verbessern. Durch die Anpassung von Farbe, Symbol und Push-Ton wird die Zuordnung und Relevanz von Alarmen deutlich beschleunigt.
Alarmfarbe ändern, Titel + Text überschreiben
Dazu musst du entsprechend „Dienste und Systeme“-Kategorien erstellen, die auf bestimmte Schlüsselwörter ansprechen. Gehe dazu in der mobilen App in die Einstellungen und wähle „Dienste und Systeme“. Erstelle eine neue Kategorie oder bearbeite einfach eine bestehende.
Eine Kategorie wird immer angewendet, wenn einzelne Schlüsselwörter oder Kombinationen von Schlüsselwörtern im auslösenden Event gefunden werden.