使用通用 Webhook 设置集成
先决条件:
- 了解发件人应用程序
- 了解 JSON
- Genesys Cloud 中的聊天通知(webhook) 配置已完成(请参阅 添加 webhook 集成)
使用通用 Webhook 从您选择的应用程序将自动聊天发送到 Genesys Cloud 聊天室。 通用 Webhook 会侦听消息,然后按照 JSON 负载的指定发布更新。
- 使用 Genesys Cloud 中的 URL 作为 webhook 通知 URL。
输入此 URL 的字段的位置取决于应用程序。 请参阅应用程序的说明或联系他们的支持以获取有关此步骤的帮助。
- 使用以下格式配置 JSON 负载:
{ "message": "[message here]", "metadata": "[metadata here]" }
Webhook 映射可以根据消息或元数据进行过滤。
message 在 JSON 中
是必需的,它指定要监听的消息类型。元数据
是可选的,它指定要监听的标签可能不在消息中。
注意: Genesys Cloud 将 JSON 有效负载的消息
属性解释为降价,从而为设置聊天消息的格式提供了广泛的灵活性。 - 设置调用以将有效负载传送到 Genesys Cloud webhook URL。
这必须是使用 REST 进行的
POST
调用。
示例
在此示例中,我们设置了一个应用程序,用于向 IT 人员的聊天室发送通知。 他们想知道每次有人登录他们的安全网络时。 JSON 有效负载看起来像这样:
{ "message": "**John Doe** just logged into our secure network.", "metadata": "security log" }