注意:您必须拥有 Zendesk Suite Professional 或更高服务模式 才能创建对话整合。了解关于 Sunshine Conversations 定价 的信息,或 联系销售 以获取更多信息。
对话整合有助于企业将来自每个渠道、聊天机器人或第三方应用的消息统一到单个对话中,并在各处建立交互式体验。
Conversations 整合是您的企业和 Sunshine Conversations 之间的双向互动。此整合包括:
- Webhook。
- (可选)一组 API 密钥,用于与具有一定整合范围的公开 API 交互。有关创建 API 密钥的信息,请参阅 使用对话 API 密钥。
注意:对话整合以前在 Sunshine Conversations 面板中称为 Webhook。
您可以通过管理中心的“对话整合”页面创建对话整合。
本文章包括以下部分:
在管理中心创建和配置对话
在对话整合页面中,您可以:
创建新对话整合
在管理中心创建对话整合
-
在 管理中心,单击 侧栏中的 应用和整合 ,然后选择 整合 > 对话整合。对话整合页面随即打开。任何以前创建的对话都会显示在列表中。
如果这是您 第 一次在管理中心创建整合,请单击 创建整合 以查看“对话整合”页面。
- 单击 创建整合。“创建整合”页面随即打开。
- 输入一个唯一的名称以识别整合。
- 在 Webhook 部分,输入以下信息:
-
Webhook 端点 URL:目标 URL。当触发事件发生时,Webhook 会发现事件并将数据发送到目标 URL。目标 URL 使用以下格式:
https://www.yourdomain.com/path
更新。 - Webhook 正文数据:使用复选框指明是否要在 Webhook 数据中包含用户架构、客户端和设备信息。
- Webhook 订阅:选择您要收到通知的活动日志。
-
Webhook 端点 URL:目标 URL。当触发事件发生时,Webhook 会发现事件并将数据发送到目标 URL。目标 URL 使用以下格式:
- 单击保存。“复制共享密钥”窗口随即打开。
- (可选)复制 Webhook ID 和共享密钥。这些仅供开发者添加另一层身份验证,但不是必需的。
- 单击下一步。整合的配置页面随即打开。如有必要,您可以在这里添加 API 密钥。
添加 API 密钥
在 API 密钥标签上,您可以配置整合的身份验证。API 密钥可识别并验证应用程序或用户,由三部分组成:
- 应用 ID 可识别您的 Zendesk 帐户。
- 密钥 ID 与密钥一起使用时,用作对 JWT 和 API 调用进行身份验证的凭证。
- 密钥 是身份验证密码。
注意:在对话整合编辑页面中配置的 API 密钥适用于自定义整合。其权限仅限于特定自定义整合,无法修改其他整合。有关应用级 API 密钥,请参阅 Sunshine Conversations 身份验证页面。
创建和共享 API 密钥
- 在 管理中心,单击 侧栏中的 应用和整合 ,然后选择 整合 > 对话整合。对话整合页面随即打开。
- 单击 API 密钥标签。
- 单击创建 API 密钥。如果您正在创建首个密钥,此按钮将显示在页面底部;如果您之前已创建密钥,它将显示在右上角。
- 在“创建新密钥”对话框中输入密钥的识别名称,然后单击下一步。
- 在“复制共享密钥”对话框中,单击每个 ID 和密钥的复制,将其保存到剪贴板,然后单击下一步。您将返回 API 窗口,新密钥将显示在列表中。
如果您生成了新密钥,但已达到 10 个密钥的限制,则系统会显示一条通知,要求您删除未使用的密钥。
删除未使用的密钥
- 在 管理中心,单击 侧栏中的 应用和整合 ,然后选择 整合 > 对话整合。
- 单击 API 密钥标签。
- 将鼠标光标悬停在您要删除的密钥上,然后单击选项菜单 (),然后选择删除。
查看、编辑或删除整合
使用现有整合的步骤
- 在 管理中心,单击 侧栏中的 应用和整合 ,然后选择 整合 > 对话整合。对话整合页面随即打开。
- 将鼠标悬停在您要更新的整合上,然后单击 选项图标 (),然后选择一个选项:
- 查看详情:显示整合的详情页面,您可以在其中查看应用、整合和 Webhook ID,以及关于共享密钥、Webhook 详情和 API 密钥的信息。
- 编辑:打开创建整合页面,您可以在其中更新整合的名称和 Webhook 详情。
- 删除:启动删除向导。您可以随时取消并退出向导。
其他整合方法
这些方法仅供拥有单独 Sunshine Conversations 许可证的用户使用,不适用于 Zendesk Suite Professional 或更高版本随附许可证的用户。
使用 curl 创建对话整合
- 使用 创建整合 API 创建整合,并将
type
收件人:custom
更新。 - 提供 API 中指定的必要参数。目标是您服务器的 URL,触发器列表决定了要接收哪些事件。
使用 Postman 创建对话整合
有关 Sunshine Conversations API 的更多信息,请参阅 整合。
另请参阅 发送 和 接收 消息的指南。您需要使用 REST API 配置 Webhook。
翻译免责声明:本文章使用自动翻译软件翻译,以便您了解基本内容。 我们已采取合理措施提供准确翻译,但不保证翻译准确性
如对翻译准确性有任何疑问,请以文章的英语版本为准。