Einrichten einer Integration mit dem generischen Webhook
- Verstehen der Absenderanwendung
- Verständnis von JSON
- Chat-Benachrichtigung (Webhook) Konfiguration in Genesys Cloud ist abgeschlossen (siehe Webhook-Integration hinzufügen)
Verwenden Sie den generischen Webhook, um automatisierte Chats an Genesys Cloud Chat-Räume aus einer Anwendung Ihrer Wahl zu senden. Der generische Webhook wartet auf Nachrichten und sendet dann Aktualisierungen, wie in einer JSON-Nutzlast angegeben.
- Verwenden Sie die URL von Genesys Cloud als URL für die Webhook-Benachrichtigung.
Die Position des Feldes für die Eingabe dieser URL hängt von der Anwendung ab. Sehen Sie sich die Anweisungen der Anwendung an oder wenden Sie sich an den Support, um Hilfe bei diesem Schritt zu erhalten.
- Konfigurieren Sie die JSON-Nutzdaten nach folgendem Format:
{ "message": "[message here]", "metadata": "[metadata here]" }
Eine Webhook-Zuordnung kann nach einer Nachricht oder nach Metadaten filtern.
message
ist im JSON erforderlich und gibt die Art der Nachricht an, auf die zu warten istmetadata
ist optional und gibt Tags an, auf die zu achten ist, die möglicherweise nicht in der Nachricht enthalten sind
Hinweis: Genesys Cloud interpretiert die Eigenschaftmessage
der JSON-Nutzdaten als Markdown, was eine große Flexibilität bei der Formatierung von Chat-Nachrichten ermöglicht - Richten Sie einen Aufruf ein, um die Nutzlast an die Genesys Cloud Webhook-URL zu liefern.
Dies muss ein
POST
Aufruf unter Verwendung von REST sein
Beispiel
In diesem Beispiel richten wir eine Anwendung ein, die Benachrichtigungen an einen Chatroom für IT-Mitarbeiter sendet. Sie wollen jedes Mal wissen, wenn sich jemand bei ihrem sicheren Netz anmeldet. Die JSON-Nutzdaten würden wie folgt aussehen:
{ "message": "**John Doe** just logged into our secure network.", "metadata": "security log" }