操作参考
支持REST API中的以下亚博电脑端资源使用行动属性:
的行动属性由一个或多个要执行的操作的数组组成条件，或者是否运行宏。
例子
{“行动”：({“字段”：“状态”，“价值”：“开放”}，{“字段”：“assignee_id”，“价值”：“296220096”}］}
数组中的每个动作都有以下属性:
| 名字 | 类型 | 描述 |
|---|---|---|
| 场 | 字符串 | 要修改的票证字段的名称 |
| 价值 | 字符串 | 字段的新值 |
例子
{“字段”：“状态”，“价值”：“解决”}
共享的行为
触发器、自动化和宏共享以下操作。
| 场 | 价值 |
|---|---|
| 状态 | 设置票据状态。参数为"new"、"open"、"pending"、"hold"、"solved"或"closed"，宏除外，它们不接受"new"或"closed"参数。 |
| 类型 | 设置票据类型。可以用"question"， "incident"， "problem"，或"task" |
| 优先级 | 设置票证优先级。可以选择“low”、“normal”、“high”或“urgent” |
| group_id | 将票分配给组。接受一个带有组id的字符串，或者一个空字符串("")来取消分配给票证的组 |
| assignee_id | 将票分配给一个人。接受一个带有用户id的字符串(受让人或请求者)，或“current_user”，或一个空字符串(“”)来取消分配给票据的人员 |
| set_tags | 一个以空格分隔的标签列表，用于在票证中插入。该操作将替换当前标记 |
| current_tags | 要添加到现有标记的以空格分隔的标记列表 |
| remove_tags | 要从现有标记中删除的以空格分隔的标记列表 |
| custom_fields_ |
设置自定义票证字段的值 |
| custom_status_id | 自定义票证状态id |
触发器和自动化的附加操作
除了共享操作之外，触发器和自动化还共享以下操作。
| 场 | 价值 |
|---|---|
| satisfaction_score | 向票务请求者发送调查请求。将“offered”作为一个值 |
| notification_user | 向用户发送邮件。接受一个包含三个字符串的数组，指定电子邮件收件人、主题和正文。看到通知邮件．可能的接收方值:“current_user”、“all_agents”(所有不受限制的代理)、“requester_id”(当前请求者)、“assignnee_id”(当前受让人)或代理的数字ID |
| notification_group | 向群组发送邮件。接受一个包含三个字符串的数组，指定电子邮件收件人、主题和正文。看到通知邮件．接收方取值:“group_id”(当前分配的组)或组的数字ID |
| notification_target | 向外部目标发送消息。接受由两个字符串组成的数组，指定目标的数字ID和消息体 |
| notification_webhook | 向活动的webhook发送消息。接受一个包含两个字符串的数组，分别指定webhook和消息体的唯一ID |
| tweet_requester | 用tweet回复twitter请求者。获取tweet的文本 |
| cc | CC是候选人之一。接受“current_user”或代理的数字ID |
| locale_id | 将请求者的语言设置为您支持的语言之一。获取受支持区域设置的数字ID。看到列表区域列出该帐户的可用区域设置id |
| requester.custom_fields。< field_key > | 设置自定义用户字段的值。相应的价值属性可以是文本字段的任何字符串，也可以是下拉字段的选项id。选项id必须指定为字符串。有关字段的键或选项id值，请参见显示用户字段在用户字段中 |
用于宏的其他操作
除了共享操作之外，宏还有以下操作。
| 场 | 价值 |
|---|---|
| 主题 | 替换票据的主题。取主题文本 |
| comment_value | 向票据添加注释。接受评论文本或由两个字符串组成的数组，该字符串指定评论通道和评论文本。可能的评论通道:“channel:all”，“channel:web”和“channel:chat” |
| comment_value_html | 向票据添加富文本注释 |
| comment_mode_is_public | 使票据评论公开或私有。取true(公共)或false(私有) |
通知邮件
某些操作向用户发送电子邮件通知。通知电子邮件由三个字符串组成的数组表示，指定电子邮件收件人、主题和正文。
(“293741756”，“水箱漏水”，“打开蒸汽阀。”］
该数组用于价值电子邮件通知操作的属性。请参阅上面的“触发器和自动化的附加操作”。
例子
{“行动”：({“字段”：“notification_user”，“价值”：(“293741756”，“水箱漏水”，“打开蒸汽阀。”］}］}
您可以在电子邮件主题和正文中使用动态内容占位符。看到亚博Zendesk支持占位符参考．
您还可以在消息正文中使用返回(“\r”)和换行(“\n”)字符。
例子
(“current_user”，”{{票。id}}:散热器泄漏”，“打开蒸汽阀。\r \n希望这能帮到你。”］