邮件 API 允许您通过在电邮回复、通知或创建新工单的电邮正文中添加命令来设置工单属性。只有专员可以使用邮件 API。如果这些命令由低权限专员或终端用户使用,Zendesk 将忽略它们。
以下是专员在电邮通知的回复中设置工单状态和受托人的示例:
专员还可以在发送到其客服电邮地址的新电邮中使用这些命令。此类电邮会创建一张新工单。
语法
邮件 API 仅扫描您的电邮顶部,查找您要执行的命令列表。
命令必须是纯文本,而不是 HTML,并遵循以下模式:
#command value
例如,如果您要设置工单的状态,请使用以下命令:
#status solved
每行应以新行隔开。例如,如果您要设置状态和受托人,请编写以下命令:
#status solved
#assignee jake@zendesk.com
在命令块后输入电邮正文。
命令参考
以下是您可以添加到有效电邮正文的所有受支持命令的列表,每次一行。该列表还包括 简短的命令,一个单词的命令,用于不需要值的经常使用的命令。例如,您可以使用简短的命令 #solved
而不是 #status
solved
。
命令 | 描述 |
---|---|
#status
|
有效值为已开启、待回应和已解决。注意:必须设置 #assignee 才能将工单设置为已解决。 简短语法: #solved 命令仅适用于没有专员必须填写才能解决工单的必填字段的工单。 |
#requester
|
设置工单的请求者。这可以是您帐户中用户的 ID 或其电邮地址。如果它们在您的帐户中不存在,Zendesk 将为您创建。 |
#group
|
将工单分配给一个组。有效值为组的名称或组的 ID。
此命令对于转发的电邮特别有用。当专员转发电邮到 Zendesk 时,默认情况下,生成的工单要么未分配,要么已分配给专员的默认组。(请参阅 将电邮发送到您的客服电邮地址。) 专员可使用此命令自动将转发的工单分配给指定的组。 |
#assignee |
将工单分配给专员。有效值为受托人的电邮地址或受托人的 Zendesk Support ID(例如通过 REST 整合获得)。 使用此命令会自动使您成为工单的协作者 (cc)。 |
#priority
|
设置工单的优先级。有效值为低、正常、高和紧急。注意:要设置优先级,您还必须设置工单类型(见下文) 简短语法: |
#type |
有效值为事件、问题、任务和故障。 简短语法: |
|
设置工单上的任意标签,可以用空格或逗号分隔。 注意:设置工单标签将移除该工单上所有之前设置的工单标签。 |
#public
|
将工单的评论更新设置为公开。仅在更新工单时可用。 公开工单的默认值为 true,这意味着请求者将看到您在电邮正文中添加的任何其他内容。私密工单(例如由低权限专员创建的工单)的默认值为 false。 简短语法: |
无效的命令
如果您输入任何无效的命令或值,Zendesk 将忽略它们。
例如
在此示例中,专员使用所有命令。
此电邮会对工单 #178 进行以下操作:
- 将状态设置为已开启
- 将组设置为“Support”,将受托人设置为电邮地址为“jake@zendesk.com”的专员
- 将优先级设置为“正常”
- 将类型设置为“问题”
- 将工单标签设置为“help”和“api”
- 将评论的可见度设置为“私密”
- 添加一条带有“Hello world!”的新评论到工单,结合上述命令,对请求者将不可见。
翻译免责声明:本文章使用自动翻译软件翻译,以便您了解基本内容。 我们已采取合理措施提供准确翻译,但不保证翻译准确性
如对翻译准确性有任何疑问,请以文章的英语版本为准。