将目标转换为 Webhook

我的服务模式是什么？

注意：URL 和品牌目标将于 2024 年 12 月 13 日停用。有关更多信息，请参阅公告。

以前，我们使用目标向基于云的外部应用程序和服务传达信息，告知他们 Zendesk 中的更改。本文章介绍了如何将大多数现有目标转换为 Webhook。

本文章包含以下主题：

• 根据您的目标新建一个 Webhook
• 配置触发器以发送 Webhook 通知
• 取消激活您的目标和关联的触发器

关于将目标转换为 Webhook

将目标转换为 Webhook 时，操作顺序关系到流程的连续性。我们建议采用以下流程：

1. 根据您的目标新建一个 Webhook。
2. 配置触发器以发送 Webhook 通知。
3. 验证新的 Webhook 和触发器是否如期工作，然后取消激活目标以及目标关联的所有触发器。

转换 Clickatell、Pivotal、Twilio、X Corp 和 Yammer 目标

无法直接将 Clickatell、Pivotal、Twilio、X Corp（原 Twitter）和 Yammer 目标配置映射到 Webhook。我们建议您探索可能满足需求的 Zendesk 市场应用 。

根据您的目标新建一个 Webhook

要将您的目标转换为 Webhook，需要在一个窗口中打开目标的详细信息，在另一个窗口中打开 Webhook。

根据 URL 目标创建 Webhook

1. 在浏览器窗口中打开 URL 目标。
   1. 在管理中心，单击侧栏中的应用和整合 ()，然后选择目标 > 目标。
   2. 找到您要转换为 Webhook 的目标，然后单击编辑。
2. 在另一个浏览器窗口中打开 Webhook 页面。
   • 在管理中心，单击侧栏中的应用和整合 ()，然后选择操作和 Webhook > Webhook。
3. 单击创建 Webhook。
4. 选择触发器或自行程序作为连接方式，然后单击下一步。
5. 将目标的值映射到 Webhook 字段。有关映射的详细说明，请参阅：
   • Basecamp
   • Campfire
   • Get Satisfaction
   • Jira
   • URL
6. 单击创建 Webhook。

将 Basecamp 目标的配置映射到 Webhook

将 Basecamp 目标的值映射到 Webhook 字段，如下所示：

• 标题：Webhook 的名称。
• URL：Webhook 的端点 URL。
• 对于 Webhook 的身份验证，选择以下方法之一：
  • 用户名和密码：将 Webhook 的身份验证设置为基本身份验证，并输入 Basecamp 的用户名和密码。密码无法复制粘贴。
  • API 密钥：将 Webhook 的身份验证设置为 API 密钥，并输入 Campfire 目标的 API 密钥。
• 项目 ID：在 Webhook 端点 URL 的末尾附上 /projects/[ID]。例如：https://corp.basecamphq.com/projects/2612430。
• 资源：附在 Webhook 端点 URL 中的项目 ID 后面。
  • 消息：附加 /posts/[ID]/comments。例如：https://corp.basecamphq.com/projects/2612430/posts/25611692/comments
  • 待办事项：附加 /todo_lists/[ID]。例如：https://corp.basecamphq.com/projects/2612430/todo_lists/25611692。

将 Campfire 目标的配置映射到 Webhook

将 Campfire 目标的值映射到 Webhook 字段，如下所示：

• 标题：Webhook 的名称。
• 子域名：Webhook 的端点 URL。
• API 密钥：将 Webhook 的身份验证设置为 API 密钥，并输入 Campfire 目标的 API 密钥。
• 聊天室：将此信息附在 Webhook 的端点 URL 末尾。
• SSL：在创建 Webhook 时不适用。
• 保留格式：在创建 Webhook 时不适用。

将 Get Satisfaction 目标的配置映射到 Webhook

将 Get Satisfaction 目标的值映射到 Webhook 字段，如下所示：

• 标题：Webhook 的名称。
• 公司名称：添加到 Webhook 的端点 URL 中。例如：https://getsatisfaction.com/yourcompany/
• 电邮和密码：将 Webhook 的身份验证设置为基本身份验证，并输入 Get Satisfaction 的用户名和密码。密码无法复制粘贴。

将 Jira 目标配置映射到 Webhook

Zendesk 强烈建议使用 Zendesk 市场中的 Jira 应用来替换 Jira 目标。但是，如果您选择不使用 Jira 应用，可以将 Jira 目标值映射到 Webhook 字段，如下所示：

• 标题：Webhook 的名称。
• URL：Webhook 的端点 URL。
• 用户名和密码：将 Webhook 的身份验证设置为基本身份验证，并输入 JIRA 的用户名和密码。密码无法复制粘贴。

将 URL 目标的配置映射到 Webhook

将 URL 目标的值映射到 Webhook 字段，如下所示：

• 标题：Webhook 的名称。
• URL：Webhook 的端点 URL。
• 方法：Webhook 的请求方法。
• 属性名称：在创建 Webhook 时并非必填字段，但将在配置触发器操作时使用。
• 基本身份验证：将 Webhook 的身份验证设置为基本身份验证，并输入 URL 目标的用户名和密码。密码无法复制粘贴。
• 此外，在 Webhook 中，您需要将请求格式设置为表格编码。

配置触发器以发送 Webhook 通知

您应该已经配置了一个触发器，以根据目标发送通知。您可以编辑或复制此触发器，也可以新建一个触发器。

编辑现有触发器以发送 Webhook 通知

1. 在管理中心，单击侧栏中的对象和规则 ()，然后选择业务规则 > 触发器。
2. 编辑或复制现有的触发器。

   记下通知方式 > 目标操作的消息值。在基于新 Webhook 的操作中，您会反复用到这个值。

3. 在操作下，单击添加操作，然后选择通知方式 > 活跃的 Webhook。
4. 在下拉菜单中选择您创建的要替换目标的 Webhook。
5. 配置 Webhook，以发送您应该发送的信息。

   例如，如要替换 URL 目标，您需要在 URL 参数下执行以下操作：

   • 将密钥设置为 URL 目标的属性名称。
   • 将值设置为通知方式 > 目标操作的消息。
6. 单击保存。
7. 返回到 Webhook 并测试其功能。

取消激活您的目标和关联的触发器

在创建 Webhook 并更新关联触发器后，您应通过启动适当的触发器条件来全面测试 Webbook。虽然触发器配置了两个通知方式操作，一个用于目标，另一个用于 Webhook，但您会在外部应用程序或系统上收到重复的消息。

在确认 Webhook 和触发器工作正常后，编辑触发器，以移除通知方式 > 目标操作，然后取消激活或删除您的目标。