Parameter `WEBHOOKS`¶

Kostenpflichtiger Zugang

Die Verwendung dieses Parameters ist nur für Hotline Premium-Benutzer verfügbar. Um eine kostenpflichtige Version des Systems zu erwerben, kontaktieren Sie unseren Support-Service.

Der Parameter legt eine oder mehrere Adressen für die Verarbeitung eingehender Webhooks von Hotline für eine bestimmte Liste von Ereignissen fest.

Webhooks werden mit der Methode POST mit Anforderungskörper im Format JSON gesendet.

Ereignistypen¶

1. Systemereignisse¶

Verfügbare Werte: dialog_created, dialog_reopened, dialog_closed, message_received, message_sent, message_intercepted.

Webhooks für solche Ereignisse geben keine Ergebnisse an die Backend-Gruppe zurück.

2. Benutzerdefinierte Befehle¶

Jeder benutzerdefinierte oder bereits vorhandene Systembefehl kann angegeben werden. Der Befehlsname muss mit einem Schrägstrich / beginnen.

Webhooks für solche Ereignisse können Ergebnisse als Nachricht an die Backend-Gruppe zurückgeben.

Weitere Einzelheiten zum Format gesendeter Anfragen finden Sie in der Webhooks-Formatbeschreibung.

Standardmäßig ist die Liste leer, Webhooks werden nirgendwo gesendet.

Datenformat¶

Die Webhook-Konfiguration wird im Format JSON festgelegt.

Um den Parameter zu löschen, senden Sie den Wert OFF

Nach Auswahl des Parameters zur Bearbeitung muss der erforderliche Wert an den Setup-Bot gesendet werden.

Standardwert¶

NONE

Anwendungsbeispiele¶

{
  "https://someapiserver.com/webhooks/end_point-1": [
    "dialog_created",
    "dialog_reopened",
    "dialog_closed",
    "message_received",
    "message_sent",
    "message_intercepted"
  ],
  "https://someapiserver.com/webhooks/end_point-2": [
    "/mark", "/info",
    "/invoice", "/client"
  ]
}

Ergebnis: Alle Systemereignisse gehen an end_point-1, und Ereignisse über aufgerufene Befehle gehen an end_point-2.

Hauptanwendungsfälle¶

externe Integrationen
benutzerdefinierte Analysen

Parameter WEBHOOKS¶