注意:URL 和品牌目标将弃用。有关更多信息,请参阅公告。
以前,我们使用目标向基于云的外部应用程序和服务传达信息,告知他们 Zendesk 中的更改。本文章介绍了如何将大多数现有目标转换为 Webhook。
本文章包含以下主题:
关于将目标转换为 Webhook
将目标转换为 Webhook 时,操作顺序关系到流程的连续性。我们建议采用以下流程:
- 根据您的目标新建一个 Webhook。
- 配置触发器以发送 Webhook 通知。
- 验证新的 Webhook 和触发器是否如期工作,然后取消激活目标以及目标关联的所有触发器。
转换 Clickatell、Pivotal、Twilio、X Corp 和 Yammer 目标
无法直接将 Clickatell、Pivotal、Twilio、X Corp(原 Twitter)和 Yammer 目标配置映射到 Webhook。我们建议您探索可能满足需求的 Zendesk 市场应用 。
根据您的目标新建一个 Webhook
要将您的目标转换为 Webhook,需要在一个窗口中打开目标的详细信息,在另一个窗口中打开 Webhook。
根据 URL 目标创建 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。
-
消息:附加 /posts/[ID]/comments。例如:
将 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 通知
- 在管理中心,单击侧栏中的对象和规则 (),然后选择业务规则 > 触发器。
-
编辑或复制现有的触发器。
记下通知方式 > 目标操作的消息值。在基于新 Webhook 的操作中,您会反复用到这个值。
- 在操作下,单击添加操作,然后选择通知方式 > 活跃的 Webhook。
- 在下拉菜单中选择您创建的要替换目标的 Webhook。
- 配置 Webhook,以发送您应该发送的信息。
例如,如要替换 URL 目标,您需要在 URL 参数下执行以下操作:
- 将密钥设置为 URL 目标的属性名称。
- 将值设置为通知方式 > 目标操作的消息。
- 单击保存。
- 返回到 Webhook 并测试其功能。
取消激活您的目标和关联的触发器
在创建 Webhook 并更新关联触发器后,您应通过启动适当的触发器条件来全面测试 Webbook。虽然触发器配置了两个通知方式操作,一个用于目标,另一个用于 Webhook,但您会在外部应用程序或系统上收到重复的消息。
在确认 Webhook 和触发器工作正常后,编辑触发器,以移除通知方式 > 目标操作,然后取消激活或删除您的目标。