Einrichten einer Integration mit dem generischen Webhook

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.

1. 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.

2. 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 ist
   • metadata 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 Eigenschaft message der JSON-Nutzdaten als Markdown, was eine große Flexibilität bei der Formatierung von Chat-Nachrichten ermöglicht
3. 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"
}