使用通用 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 在 JSON 中是必需的,并指定要监听的消息类型。
    • metadata 是可选的,指定要监听的可能不在消息中的标签。
    笔记:  Genesys Cloud 解读messageJSON 有效负载的属性与 markdown 相同,为格式化聊天消息提供了广泛的灵活性。
  3. 设置调用以将有效负载传送到 Genesys Cloud webhook URL。

    这肯定是一个POST使用 REST 进行调用。

示例

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

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