使用通用 Webhook 设置集成

先决条件:  
  • 了解发件人应用程序
  • 了解 JSON
  • Genesys Cloud 中的聊天通知(webhook) 配置已完成(请参阅 添加 webhook 集成

使用通用 Webhook 从您选择的应用程序将自动聊天发送到 Genesys Cloud 聊天室。 通用 Webhook 会侦听消息,然后按照 JSON 负载的指定发布更新。

  1. 使用 Genesys Cloud 中的 URL 作为 webhook 通知 URL。

    输入此 URL 的字段的位置取决于应用程序。 请参阅应用程序的说明或联系他们的支持以获取有关此步骤的帮助。

  2. 使用以下格式配置 JSON 负载:
    {
     "message": "[message here]",
     "metadata": "[metadata here]"
    }

    Webhook 映射可以根据消息或元数据进行过滤。

    • 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. 设置调用以将有效负载传送到 Genesys Cloud webhook URL。

    This must be a POST call using REST.

示例

在此示例中,我们设置了一个应用程序,用于向 IT 人员的聊天室发送通知。 他们想知道每次有人登录他们的安全网络时。 JSON 有效负载看起来像这样:

{
 "message": "**John Doe** just logged into our secure network.",
 "metadata": "security log"
}