Einrichten einer Integration mit dem generischen Webhook

Voraussetzungen:  
  • 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.

  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 den Nachrichtentyp an, auf den gewartet werden soll.
    • metadata ist optional und gibt Tags an, auf die geachtet werden soll, die möglicherweise nicht in der Nachricht enthalten sind.
    Notiz:  Genesys Cloud interpretiert diemessage Eigenschaft der JSON-Nutzlast als Markdown, was eine breite Flexibilität bei der Formatierung von Chatnachrichten ermöglicht.
  3. Richten Sie einen Aufruf ein, um die Nutzlast an die Genesys Cloud Webhook-URL zu liefern.

    Dies muss einPOST Aufruf mit REST.

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"
}