在管理中心创建对话整合

我的服务模式是什么？

Suite

Professional、Enterprise 或 Enterprise Plus

注意：您必须拥有 Zendesk Suite Professional 或更高服务模式 才能创建对话整合。了解关于 Sunshine Conversations 定价 的信息，或 联系销售 以获取更多信息。

对话整合有助于企业将来自每个渠道、聊天机器人或第三方应用的消息统一到单个对话中，并在各处建立交互式体验。

Conversations 整合是您的企业和 Sunshine Conversations 之间的双向互动。此整合包括：

• Webhook。
• （可选）一组 API 密钥，用于与具有一定整合范围的公开 API 交互。有关创建 API 密钥的信息，请参阅 使用对话 API 密钥。

注意：对话整合以前在 Sunshine Conversations 面板中称为 Webhook。

您可以通过管理中心的“对话整合”页面创建对话整合。

您也可以使用 curl 或 Postman创建整合。

本文章包括以下部分：

• 在管理中心创建和配置对话
• 其他整合方法

在管理中心创建和配置对话

在对话整合页面中，您可以：

• 创建新整合
• 添加 API 密钥
• 查看、编辑或删除整合

创建新对话整合

在管理中心创建对话整合

1. 在 管理中心，单击 侧栏中的 应用和整合 ，然后选择 整合 > 对话整合。对话整合页面随即打开。任何以前创建的对话都会显示在列表中。

   如果这是您 第 一次在管理中心创建整合，请单击 创建整合 以查看“对话整合”页面。

2. 单击 创建整合。“创建整合”页面随即打开。
3. 输入一个唯一的名称以识别整合。
4. 在 Webhook 部分，输入以下信息：
   • Webhook 端点 URL：目标 URL。当触发事件发生时，Webhook 会发现事件并将数据发送到目标 URL。目标 URL 使用以下格式： https://www.yourdomain.com/path更新。
   • Webhook 正文数据：使用复选框指明是否要在 Webhook 数据中包含用户架构、客户端和设备信息。
   • Webhook 订阅：选择您要收到通知的活动日志。
5. 单击保存。“复制共享密钥”窗口随即打开。
6. （可选）复制 Webhook ID 和共享密钥。这些仅供开发者添加另一层身份验证，但不是必需的。
7. 单击下一步。整合的配置页面随即打开。如有必要，您可以在这里添加 API 密钥。

添加 API 密钥

在 API 密钥标签上，您可以配置整合的身份验证。API 密钥可识别并验证应用程序或用户，由三部分组成：

• 应用 ID 可识别您的 Zendesk 帐户。
• 密钥 ID 与密钥一起使用时，用作对 JWT 和 API 调用进行身份验证的凭证。
• 密钥 是身份验证密码。

注意：在对话整合编辑页面中配置的 API 密钥适用于自定义整合。其权限仅限于特定自定义整合，无法修改其他整合。有关应用级 API 密钥，请参阅 Sunshine Conversations 身份验证页面。

创建和共享 API 密钥

1. 在 管理中心，单击 侧栏中的 应用和整合 ，然后选择 整合 > 对话整合。对话整合页面随即打开。
2. 单击 API 密钥标签。
3. 单击创建 API 密钥。如果您正在创建首个密钥，此按钮将显示在页面底部；如果您之前已创建密钥，它将显示在右上角。
4. 在“创建新密钥”对话框中输入密钥的识别名称，然后单击下一步。
5. 在“复制共享密钥”对话框中，单击每个 ID 和密钥的复制，将其保存到剪贴板，然后单击下一步。您将返回 API 窗口，新密钥将显示在列表中。

如果您生成了新密钥，但已达到 10 个密钥的限制，则系统会显示一条通知，要求您删除未使用的密钥。

删除未使用的密钥

1. 在 管理中心，单击 侧栏中的 应用和整合 ，然后选择 整合 > 对话整合。
2. 单击 API 密钥标签。
3. 将鼠标光标悬停在您要删除的密钥上，然后单击选项菜单 ()，然后选择删除。

单击删除确认操作。

查看、编辑或删除整合

使用现有整合的步骤

1. 在 管理中心，单击 侧栏中的 应用和整合 ，然后选择 整合 > 对话整合。对话整合页面随即打开。
2. 将鼠标悬停在您要更新的整合上，然后单击 选项图标 (），然后选择一个选项：
   • 查看详情：显示整合的详情页面，您可以在其中查看应用、整合和 Webhook ID，以及关于共享密钥、Webhook 详情和 API 密钥的信息。
   • 编辑：打开创建整合页面，您可以在其中更新整合的名称和 Webhook 详情。
   • 删除：启动删除向导。您可以随时取消并退出向导。

其他整合方法

这些方法仅供拥有单独 Sunshine Conversations 许可证的用户使用，不适用于 Zendesk Suite Professional 或更高版本随附许可证的用户。

使用 curl 创建对话整合

1. 使用 创建整合 API 创建整合，并将 type 收件人： custom更新。
2. 提供 API 中指定的必要参数。目标是您服务器的 URL，触发器列表决定了要接收哪些事件。

使用 Postman 创建对话整合

1. 使用 创建整合 API 创建整合，并将 type 收件人： custom更新。
2. 下载并安装 Postman 应用程序。
3. 下载 Sunshine ConversationsPostman集合 ，并设置您的环境。
4. 在 Postman 中，选择 Smooch > 整合 > 创建整合。
5. 根据您的整合类型提供指定的必要参数。

有关 Sunshine Conversations API 的更多信息，请参阅 整合。

另请参阅 发送 和 接收 消息的指南。您需要使用 REST API 配置 Webhook。

翻译免责声明：本文章使用自动翻译软件翻译，以便您了解基本内容。 我们已采取合理措施提供准确翻译，但不保证翻译准确性

如对翻译准确性有任何疑问，请以文章的英语版本为准。