Diese Funktion ist nur für Enterprise-Kunden verfügbar. Bitte kontaktieren Sie Ihren CSM, wenn Sie sie aktivieren möchten.
Dieser Beitrag enthält eine Beschreibung der folgenden Aspekte:
Ereignisse, die Echtzeitwarnungen auslösen
Mit dem Webhook für Echtzeit-Benachrichtigungen können Sie sich in Echtzeit benachrichtigen lassen, wenn für Sie interessante Ereignisse ausgelöst werden. Diese Ereignisse können überall in unserem System auftreten, sind jedoch derzeit auf die fünf unten aufgelisteten Ereignisse beschränkt:
-
Eine Eskalation ist fehlgeschlagen
-
Eine Aktion ist fehlgeschlagen
-
Im Chat wurde eine allgemeine technische Fehlermeldung gesendet
-
Eine angepasste Backend-Integration ist fehlgeschlagen. In diesem Ereignis ist die genaue Backend-Integration im
data-Objekt angegeben. - Testen – Ein Testereignis kann im Dashboard „AI Agents – Advanced“ ausgelöst werden, damit Entwickler die Nutzung des Webhooks testen und implementieren können, ohne auf einen der Auslöser warten zu müssen.
Sobald eines der Ereignisse ausgelöst wird, senden wir eine Anforderung mit dem folgenden Parameter an die Webhook-URL:
| Name | Typ | Beschreibung |
| botName | Zeichenfolge | Benennen Sie den AI Agent, der das Ereignis ausgelöst hat |
| Ereignis | Zeichenfolge | Die fünf verschiedenen Ereignistypen |
| conversationId | Zeichenfolge | Eindeutige Konversations-ID |
| platformConversationId | Zeichenfolge | Plattformspezifische Konversations-ID |
| data | Objekt | Metadata, die hauptsächlich vom Backend-Integrationsereignis verwendet werden |
Für das Ereignis der angepassten Backend-Integration reichern wir das Datenobjekt mit dem folgenden Parameter an:
| Name | Typ | Beschreibung |
| botId | Zeichenfolge | Eine für jeden AI Agent einzigartige Kombination aus 24 Ziffern und Buchstaben. Informieren Sie sich weiter. |
| conversationId | Zeichenfolge | Eindeutige Konversations-ID |
| conversationLink | Zeichenfolge | Verknüpfung mit der angegebenen Konversation in den Konversationsprotokollen |
| httpStatus | number | Statustyp des Fehlers |
| endpointUrl | Zeichenfolge | Die URL, auf die die Backend-Integration abzielt |
Webhook-Konfiguration
Die Webhook-Konfiguration kann unter AI Agent-Einstellungen > Allgemein > Webhook abgerufen werden. Dies wird nur Enterprise-Kunden angezeigt.
Zur Einrichtung befolgen Sie die Anweisungen unten:
- Gehen Sie im Dashboard „AI Agents – Advanced“ zu AI-Agenteneinstellungen > Allgemein > Webhook
-
Kopieren Sie die Webhook-URL aus Ihrem Datentool und fügen Sie sie in das dafür vorgesehene Feld ein. Bitte beachten Sie, dass wir nur https-URLs zulassen.
-
Klicken Sie auf Token anzeigen und verwenden Sie das Authentifizierungstoken, um die Alarmnachrichten in Ihrem Datentool erfolgreich abzurufen.
-
Klicken Sie auf Webhook zur Verfolgung der AI Agent-Leistung verwenden, um die Funktion zu aktivieren.
- Speichern Sie die aktualisierten AI Agent-Einstellungen. Die Webhook-Testschaltfläche sollte inzwischen aktiviert sein.
-
Klicken Sie auf Test-Webhook, um ein Test-Ereignis an die URL zu senden, die Sie als Webhook-URL angegeben haben. Der letzte Schritt ist optional, wird aber empfohlen.