通知外部目标

我的服务模式是什么？

注意：除电邮目标外，所有目标都将被弃用。请参阅将目标转换为 Webhook。

创建或更新工单后您可以通知外部目标。外部目标是基于云的应用程序和服务以及电邮。以下是使用目标的方式和原因的一些示例：

• 当紧急工单无人参与超过 48 小时时发送短信
• 当新的紧急工单创建时发送通知到 X（以前称为 Twitter）流

以上只是几个例子。有关可用目标的更多信息，请参阅下面的设置目标。目标用于自行程序和触发器操作。您需要先配置一个目标，然后使用通知方式 > 目标操作指定目标。

本文章包含以下部分：

• 设置目标
• 在自行程序和触发器中使用目标
• 避免超时错误

设置目标

除了通用电邮目标之外，您还可以将预定义的目标用于常见云端应用程序和服务。

注意：

• 试用帐户最多可以创建 10 个目标。
• 如果对专员或管理员启用了双重身份验证，您只能通过 API 密钥对目标进行身份验证，使用“[e-mail]/token”并将您的密钥作为密码。

表 1.目标

目标	描述
Basecamp	使用 Basecamp 目标，您可以将工单更新作为以下内容推送到项目： 项目中的新消息 特定消息中的新评论 新待办事项列表 特定待办事项列表中的新待办事项项目 您需要在 Basecamp 帐户中启用 API 访问以使用此目标。有关设置 Basecamp 的信息，请参阅设置并使用 Basecamp 目标。
Campfire	发送通知到 Campfire 聊天室。
Clickatell	使用此目标用您的 Clickatell 帐户发送短信。 按照 Clickatell HTTP API Guide 中的步骤设置帐户，添加 HTTP 连接并获取 API ID。
电邮	使用工单触发器或自行程序发送电邮到特定地址。发送地址是与品牌关联的默认地址。您可以在触发器或自行程序中定义操作。 如果目标电邮地址是另一个 Support 帐户上与您有工单共用协议的外部 Support 地址，电邮通知将被目标电邮地址拒绝。不会创建工单。这样做是为了避免电邮循环。如果您需要与另一个 Support 帐户共享支持请求，请使用工单共用功能。 此外，为防止电邮循环，您不能通知自己帐户的客服电邮地址。
Get Satisfaction	对在 Get Satisfaction 中使用 Zendesk 维护者工具创建的工单，发布公开评论到 Get Satisfaction 的主题中。 通过创建此目标，必要的触发器和视图以及在主页和工单页面中添加的有用小组件（如果您不需要这些小组件，您可以将其移除）都将自动创建。
Pivotal Tracker	从 Zendesk Support 工单在 Pivotal Tracker 创建故事，方便地为您项目待办工单中的支持问题排优先级。 Pivotal Tracker 目标在创建一个新故事时发送 Zendesk Support 工单 ID 到 Pivotal Tracker。 如果您已在目标 Tracker 项目中启用 Pivotal Tracker 的原生 Zendesk 整合，则将在新故事中创建一个返回 Zendesk Support 工单的链接。
Twilio	使用此目标用您的 Twilio 帐户发送短信到手机。
X Corp	发送通知到 X（以前称为 Twitter）流。 注意：如果您不希望通知是公开可读的，请务必保护 X 流。
URL	将 URL 参数传递给任意 URL。您可以使用占位符作为值。例如：www.some-address.com?customer_name={{ticket.requester.name}}。在您的服务器上设置一个脚本以接收请求，然后从此处您几乎可以进行任何操作。要解决目标问题，请参阅获取关于 URL 目标失败的信息。 我们不建议使用 URL 目标来更新 Zendesk Support 中的工单，这可能导致多个问题。请将其仅用于外部目标。
Yammer	发送通知到 Yammer 流。

注意：如需设置许多这样的外部目标，您需要查阅相关文档。某些目标（例如 X）仅需要您对帐户进行授权即可开始发布消息。

添加目标

1. 在管理中心，单击侧栏中的应用和整合图标 ()，然后选择目标 > 目标。
2. 选择添加目标。
3. 系统会列出所有目标选项。选择目标类型并输入所需的目标信息（根据目标而异）。
4. 从页面底部的下拉列表中选择创建目标。若要在添加之前测试目标，请选择测试目标。
5. 单击提交。

设置目标后，您可以对其进行编辑、删除以及取消激活和重新激活。请参阅管理外部目标。

在自行程序和触发器中使用目标

设置目标后，您可以在自行程序和触发器中使用它们。以下是紧急工单创建时通知 X（原 Twitter）帐户的触发器示例：

• 满足以下所有条件
  • 工单 > 工单 | 是 | 已创建
  • 工单 > 优先级 | 是 | 紧急
• 操作
  • 通知方式 > 目标 | 我的 X 帐户

由于您是与外部目标互动，因此在触发器或自行程序运行与您在外部目标中看到结果之间可能会有延迟（在上面的例子中，外部目标是您的 X 主页或流）。

您可以在通知方式 > Ttarget 操作的消息字段中输入最多 8192 个字符。

避免超时错误

如果在发出请求 10 秒钟内收到超时错误，Zendesk 将重试请求。在连续 21 次重试请求失败后，Zendesk 将取消激活目标。您需要先重新激活目标，然后才能再次使用它。

当目标自动取消激活时，Zendesk 管理员会收到通知。当手动删除或取消激活目标时，他们不会收到通知。

以下是超时错误的最常见原因：

• 触发器或目标页面中的消息正文为空白。
• 接收服务器出现问题。

如果使用 URL 目标，您可以使用管理中心 Zendesk API 页面中的“达标失败”标签来检查请求是否有问题。请参阅获取关于 URL 达标失败的信息。