Benachrichtigungs-Webhooks
Ein Benachrichtigungs-Webhook sendet AurionAI-Benachrichtigungsereignisse an ein anderes System, zum Beispiel ein Chat-Tool. AurionAI sendet jedes Ereignis als JSON-Body an die von Ihnen eingegebene Adresse.
Verfügbarkeit: Helpdesk- und AI Voice + Helpdesk-Profile. Nur Administratoren.
Voraussetzungen
- Sie haben die Rolle Eigentümer oder Administrator. Andere Benutzer sehen Zugriff verweigert.
- Ihre Organisation verwendet das Helpdesk- oder das AI Voice + Helpdesk-Profil.
- Eine öffentliche HTTPS-Adresse, die POST-Anfragen mit einem JSON-Body akzeptiert.
Benachrichtigungs-Webhooks öffnen
- Wählen Sie in der Seitenleiste Konfiguration.
- Öffnen Sie die Kategorie Systemeinstellungen.
- Wählen Sie Benachrichtigungs-Webhooks.
Einen Webhook hinzufügen
- Wählen Sie Webhook hinzufügen.
- Geben Sie unter Name einen Namen ein.
- Geben Sie unter URL die Adresse ein. Sie muss mit
https://beginnen. - Optional: Geben Sie unter Geheimnis (optional) ein Secret ein. AurionAI signiert dann jede Anfrage. Lassen Sie das Feld leer, um unsignierte Anfragen zu senden.
- Wählen Sie die Ereignisse aus:
- Um jedes Benachrichtigungsereignis zu empfangen, aktivieren Sie Alle Ereignisse abonnieren.
- Andernfalls wählen Sie die Ereignisse in der Liste aus.
- Wählen Sie Erstellen.
Die Meldung Webhook erstellt wird angezeigt. Ein neuer Webhook ist Aktiviert.
Den Webhook testen
- Wählen Sie beim Webhook Testen.
- Wählen Sie im Dialog Test-Payload senden? die Option Test senden.
AurionAI sendet sofort ein webhook.test-Ereignis. Die Meldung Test-Payload erfolgreich gesendet oder Senden des Test-Payloads fehlgeschlagen wird angezeigt.
Die Signatur überprüfen
Wenn der Webhook ein Secret hat, enthält jede Anfrage zwei zusätzliche Header:
X-Webhook-Timestamp: der Zeitpunkt der Anfrage in Sekunden seit dem 1. Januar 1970 (UTC).X-Webhook-Signature:sha256=gefolgt von der Signatur.
Um eine Anfrage zu prüfen, berechnen Sie einen HMAC-SHA256 aus dem Zeitstempel, einem Punkt und dem rohen Body mit Ihrem Secret. Schreiben Sie das Ergebnis in hexadezimaler Form. Es muss dem Teil nach sha256= entsprechen.
Einen Webhook bearbeiten, deaktivieren oder löschen
- Um einen Webhook zu ändern, wählen Sie Webhook bearbeiten, ändern Sie die Felder und wählen Sie Speichern. Lassen Sie das Secret-Feld leer, um es beizubehalten, oder wählen Sie Geheimnis entfernen, um unsignierte Anfragen zu senden.
- Um Zustellungen vorübergehend zu stoppen, öffnen Sie Webhook bearbeiten und stellen Sie den Schalter auf Deaktiviert. Speichern Sie anschließend.
- Um einen Webhook zu entfernen, wählen Sie Löschen. Wählen Sie im Dialog Diesen Webhook löschen? die Option Webhook löschen. Dadurch werden auch der Zustellungsverlauf und das Secret entfernt. Dies kann nicht rückgängig gemacht werden.
- Um vergangene Zustellungen anzuzeigen, wählen Sie Verlauf beim Webhook. Jede Zeile zeigt Zugestellt, Fehlgeschlagen oder Übersprungen sowie den Grund eines Fehlers.
Ergebnis
AurionAI sendet jedes ausgewählte Ereignis, sobald es eintritt. Wenn Ihre Adresse nicht antwortet oder mit einem 5xx-Status antwortet, versucht AurionAI es sofort erneut, insgesamt bis zu drei Versuche. Eine 4xx-Antwort ist endgültig: AurionAI versucht es nicht erneut.
Wenn etwas schiefläuft
- Die URL muss mit https:// beginnen. Beginnen Sie die Adresse mit
https://. - Cloud-Metadaten-Endpunkte sind immer blockiert. oder eine Meldung, dass eine IP-Adresse in einem gesperrten Bereich liegt. AurionAI sendet keine Webhooks an private oder interne Adressen. Verwenden Sie eine öffentliche Adresse.
- Eine Meldung besagt, dass die DNS-Auflösung fehlgeschlagen ist. Der Hostname existiert nicht oder hat keinen DNS-Eintrag. Überprüfen Sie die Adresse.
- Wählen Sie mindestens ein Ereignis aus oder aktivieren Sie „Alle Ereignisse abonnieren“. Wählen Sie mindestens ein Ereignis aus oder aktivieren Sie Alle Ereignisse abonnieren.
- Senden des Test-Payloads fehlgeschlagen Lesen Sie den Grund, den HTTP-Status und die Anzahl der Versuche in der Meldung. Stellen Sie sicher, dass Ihr Empfänger online ist und mit einem 2xx-Status antwortet.
- Dieser Webhook ist deaktiviert Aktivieren Sie zuerst den Webhook. Wenn Sie Trotzdem senden auswählen, zeichnet AurionAI nur einen übersprungenen Versuch auf.
- Eine Zustellung zeigt Übersprungen. Der Webhook war deaktiviert, oder die Adresse hat die Sicherheitsprüfung vor dem Senden nicht bestanden. Lesen Sie den Grund im Verlauf.
- Webhooks konnten nicht geladen werden oder Benachrichtigungsereignisse konnten nicht geladen werden Wählen Sie Erneut versuchen.
Verwandte Artikel
Kommen Sie nicht weiter? Stellen Sie eine Anfrage oder .