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 is required in the JSON and specifies the type of message to listen for.
    • metadata is optional and specifies tags to listen for that might not be in the message.
    Note:  Genesys Cloud interprets the message property of the JSON payload as markdown, allowing broad flexibility for formatting chat messages.
  3. Richten Sie einen Aufruf ein, um die Nutzlast an die Genesys Cloud Webhook-URL zu liefern.

    This must be a POST call using 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"
}