邮件API允许您通过向通知或创建新票据的电子邮件响应的正文中添加命令来设置票据属性。只有代理可以使用邮件API。如果这些命令由最终用户使用,Zendesk将忽略它们。亚博
下面是一个代理在回复电子邮件通知时设置票证状态和受让人的示例:
代理还可以在发送到其支持地址的新电子邮件中使用这些命令。这种电子邮件创建了一个新的票据。
语法
邮件API只是扫描您的电子邮件顶部,查找您想要执行的命令列表。
命令必须是纯文本,而不是HTML,并遵循以下模式:
#命令值
例如,如果您想设置票据的状态,使用以下命令:
#状态解决
每行之间应该用一行隔开。以设置状态和受让人为例:
#状态解决
#受让人jake@zendes亚博k.com
在命令块之后输入电子邮件的正文。
命令参考
下面是所有支持的命令列表,您可以将它们添加到有效电子邮件的正文中,每次一行。该列表还包括简短的命令,用于不需要值的常用命令的单字命令。例如,您可以使用短命令#解决
而不是#状态解决
。
命令 | 描述 |
---|---|
#状态 |
有效值为打开、挂起和已解决。注意:要设置要解决的票据,必须设置#assignee。 简短的语法: #解决 命令只适用于没有必需字段的票据,代理必须填写这些字段才能解决票据。 |
#请求者
|
设置票证的请求者。这可以是您帐户中的用户ID,也可以是他们的电子邮件地址。如果您的帐户中还没有,Zendesk将为您创建。亚博 此命令不适用于轻型代理。 |
#组
|
将票分配给组。有效值为组名或组ID。 此命令对于转发的电子邮件特别有用。当座席将电子邮件转发给Zendesk时,默认情况下生成的票证要么未分配亚博,要么分配给座席的默认组。(见将电子邮件发送到您的支持地址)。代理可以使用此命令自动将转发的票证分配给指定的组。 |
#受让人 |
将票分配给代理。有效值是受让人的电子邮件地址或受让人的Zendesk支持ID(通过例如REST集成获得)。亚博 使用此命令将自动使您成为票据上的协作者(cc)。 |
#优先
|
设置票证的优先级。取值包括low、normal、high和urgent。注意:要设置优先级,还必须设置票据类型(见下文)。 简短的语法: |
#类型 |
有效值是incident、question、task和problem。 简短的语法: |
|
设置票券上的任何标签,可以用空格或逗号分隔。 请注意:设置标签将删除该票据上所有先前设置的标签。 |
#公共 |
将票据上的注释更新设置为public。仅在更新票证时可用。 公共票券的默认值为true,这意味着请求者将看到您放入电子邮件正文中的任何其他内容。私有票据的默认值为false,例如由轻型代理创建的票据。 简短的语法: |
无效的命令
如果您输入任何无效的命令或值,Zendesk将忽略它们。亚博
例子
在本例中,代理使用所有命令。
这封电子邮件对178号机票做了如下处理:
- 将状态设置为打开
- 将组设置为“Support”,并将受让人设置为代理,其电子邮件地址为“jake@zendesk.com”亚博
- 将优先级设置为“normal”
- 将类型设置为" question "
- 将标签设置为" help "和" api "
- 将评论的可见性设置为“private”
- 添加一个新的评论“Hello world!”,它与上述命令结合在一起,对请求者将不可见。
16条评论
你好所有的,
您是否计划在某个时候支持自定义字段?
提前感谢。
你好@……,
我们没有最近的更新,在这个时候宣布,但我建议张贴在我们的产品反馈论坛。在这里,我们的开发者会分享他们对未来路线图的见解,并分享他们对用户产品需求的看法。
致以最亲切的问候。
设置保持状态是否有效?我试过了。
#地位收藏
但这似乎行不通。
嗨,吉姆,
恐怕邮件API不支持设置保持状态。我能想到的使用Mail API的唯一解决方法是包含一个特定的评论字符串或关键字,然后创建一个触发器来查找该短语或关键字,如果找到了,就将状态设置为On-Hold。
(我绝对不建议使用Mail API #tags命令,因为这会从票证中删除以前的任何标记。)
除此之外,登录到代理界面,或者使用Zendesk Support移动功能将是我的其他建议。亚博
谢谢你,大卫!
有没有计划在不久的将来支持HTML中的命令?我正在使用一个只能通过HTML发送电子邮件的监控软件,所以我的邮件API命令都不起作用……
#public命令似乎不起作用。
我的代理电子邮件正在发送一个试图设置#requestor的票证,并试图使票证最初开始作为一个内部票证。
有什么办法可以做到这一点吗?
嗨,安德鲁,
#public注释仅在更新票据时可用,而在启动或创建票据时不可用。也就是说,恐怕没有其他的办法,除非创建票的代理是轻型代理。
我注意到使用#note适用于整个通信线程,也会影响代理对票证的未来响应。是否有一种方法可以只将一个评论更新设置为私有,但随后有响应返回到公共(返回到默认值)?
感谢您联系Zendesk支持。亚博
关于你所关心的问题,你可以使用#public false,就像上面建议的例子一样,将评论的可见性设置为私有。
谢谢你!
亲切的问候,
我能够用这些命令中的几个给我们的支持地址发电子邮件,它似乎正确地创建了票据——只有一个例外。
当我使用#tags命令设置标签时,我看到标签确实是为这个票据设置的,但是电子邮件中的#tags行没有被删除,所以我的初始票据评论以#tags .... .开始所有其他命令行都被正确删除,但#tags没有。我试着上下移动我的命令“列表”,但那一个仍然存在。
你能和开发人员确认一下这是否是已知的问题吗?
我对添加标记和标准和代理工作区执行了相同的测试。它似乎像预期的那样起作用。你能再试一次吗?如果你得到相同的结果,直接联系技术支持所以我们可以进一步调查。
非常不幸的是,代理不可能使用语法#ticket 123将来自他/她的私人邮箱的电子邮件消息链接到现有的票据
有机会从电子邮件中获得那些自定义字段名更新吗?
谢谢
嗨,这个功能还能用吗?我尝试了这些命令,但它们不起作用。我必须启用任何设置吗?
您是否检查了电子邮件客户端中的新邮件编写器是否设置为纯文本格式?如上所述-
还应该从事件审计中进行检查,以确认在执行命令后是否没有触发更改状态和受让人的触发器。
请登录留下评论。