票据审计事件参考
的票审核支持REST API中的资源可以使用以下事件来描述票证更新:
- 创建事件
- 更改事件
- 评论事件
- 评论编校事件
- 附件编校事件
- 语音评论活动
- 评论隐私更改事件
- 暂停机票回收活动
- 通知事件
- 带有CCs的通知事件
- 短信通知事件
- CC事件
- 关注者通知事件
- 追随者变更事件
- 邮件抄送变更事件
- 宏观参考事件
- 满意度评定事件
- 票务分享活动
- 组织订阅通知事件
- SLA目标变更事件
- 错误的事件
- 微博事件
- Facebook的事件
- Facebook评论活动
- 外部事件
- LogMeIn记录事件
- 推动事件
- 聊天结束事件
- 技能分配事件
每个事件都有自己的事件通过
对象,如果它与通过
审计对象。看到支持API:通过对象引用.
请注意: Zendesk开发团队可以随时添加事件。亚博请忽略集成中未记录的事件类型。
创建事件
在新创建的票据上设置了票据属性。为每个属性集创建一个单独的事件。
Create事件具有以下属性:
名字 | 类型 | 只读 | 评论 |
---|---|---|---|
id | 整数 | 是的 | 在创建事件时自动分配 |
类型 | 字符串 | 是的 | 有价值吗?创建 |
field_name | 字符串 | 是的 | 设置的字段的名称 |
价值 | 字符串,数组,对象 | 是的 | 设置的字段值 |
价值
通常是字符串。的值时,属性是一个数组field_name
是“标签”。的值是一个对象field_name
是SLA事件,如“first_reply_time”。例子:
“价值”:{
“分钟”:1440,
“in_business_hours”:假
}
例子
{
“id”:1274,
“类型”:“创造”
“field_name”:“状态”,
“价值”:“新”
}
更改事件
已更新票证属性。事件描述每个票证属性的先前和最新的值。
更改事件具有以下属性:
名字 | 类型 | 只读 | 评论 |
---|---|---|---|
id | 整数 | 是的 | 在创建事件时自动分配 |
类型 | 字符串 | 是的 | 有价值吗?改变 |
field_name | 字符串 | 是的 | 被更改的字段的名称 |
价值 | 字符串,数组,对象 | 是的 | 被更改的字段值 |
previous_value | 字符串,数组,对象 | 是的 | 先前被更改的字段值 |
价值
和previous_value
通常是字符串。的值时,属性是一个数组field_name
是标签
.的值是一个对象field_name
是SLA事件,如“first_reply_time”。
例子
{
“id”:1274,
“类型”:“改变”
“field_name”:“主题”,
“价值”:“我的打印机着火了!”,
“previous_value”:“我需要帮助!”
}
评论事件
在罚单上加了一条评论。事件的类型
是“评论”。事件的属性与票据注释对象相同。看到票的评论.
例子
{
“id”:2127301148,
“类型”:“评论”,
“身体”:“这是一个新的私人评论”,
“html_body”:"
这是一个新的私人评论
",“公共”:假,
“created_at”:“2015 - 07 - 20 - t22:55:29z”,
“author_id”:123123,
“附件”:[]
}
评论编校事件
使用API从票据注释中编辑了一个单词或字符串。看到编辑注释中的字符串.注释编校事件具有以下属性:
名字 | 类型 | 只读 | 评论 |
---|---|---|---|
id | 整数 | 是的 | 在创建事件时自动分配 |
类型 | 字符串 | 是的 | 有价值吗?CommentRedactionEvent |
comment_id | 整数 | 是的 | 带有编辑文本的评论 |
例子
{
“id”:59542664837,
“comment_id”:“59733541888”,
“类型”:“CommentRedactionEvent”
}
附件编校事件
使用REST API从票据注释中编辑或永久删除了附件。看到编辑评论附件.这些事件具有以下属性:
名字 | 类型 | 只读 | 评论 |
---|---|---|---|
id | 整数 | 是的 | 在创建事件时自动分配 |
类型 | 字符串 | 是的 | 有价值吗?AttachmentRedactionEvent |
attachment_id | 整数 | 是的 | 经过编辑的附件 |
comment_id | 整数 | 是的 | 带有编辑附件的评论 |
例子
{
“id”:59549109257,
“类型”:“AttachmentRedactionEvent”,
“attachment_id”:1636097007,
“comment_id”:59738862068
}
语音评论活动
语音评论被添加到Zendesk Talk的票务中。亚博
语音评论事件具有以下属性:
名字 | 类型 | 只读 | 评论 |
---|---|---|---|
id | 整数 | 是的 | 在创建事件时自动分配 |
类型 | 字符串 | 是的 | 有价值吗?VoiceComment |
数据 | 对象 | 是的 | 描述语音注释的属性 |
formatted_from | 字符串 | 是的 | 拨打电话的电话号码的格式化版本 |
formatted_to | 字符串 | 是的 | 接电话的电话号码的格式化版本 |
身体 | 字符串 | 是的 | 对票据添加的评论 |
html_body | 字符串 | 是的 | 注释格式为HTML |
公共 | 布尔 | 是的 | 如果为true,则票据请求者可以看到评论。如果为假,只有代理才能看到它 |
受信任的 | 布尔 | 是的 | 如果此评论被信任或标记为潜在欺诈 |
author_id | 整数 | 是的 | 注释作者,通常是分配给票据的代理 |
transcription_visible | 布尔 | 是的 | 票上的抄写是否可见 |
附件 | 数组 | 是的 | 本评论的附件为附件对象 |
例子
{
“id”:215546547,
“类型”:“VoiceComment”,
“身体”:”“来自+的呼入1(123)654-7890年\ nCall细节:\ n \ nCall从……”,
“数据”:{
“answered_by_id”:63197591,
“answered_by_name”:“海沃德”,
“author_id”:63197591,
“brand_id”:1156956,
“call_duration”:64,
“call_id”:129873628,
“从”:“+ 11236547890”,
“位置”:“美国伊利诺斯州罗塞尔”,
”到“:“+ 11233257890”,
“公共”:假,
“recording_url”:“https://omniwear.亚博zendesk.com/api/v2/channels/voice/calls/CAed671/twilio/recording”,
“started_at”:“2016 - 12 - 20 - t16:30:16z”,
“transcription_status”:“完成”,
“transcription_text”:“你好,我有个问题……”,
“via_id”:34
},
“formatted_from”:"+1 (123) 654-7890",
“formatted_to”:+1 (123) 325-7890,
“transcription_visible”:假,
“公共”:假,
“html_body”:"
注:
data.answered_by_id
语音留言时不在场data.transcription_status
和data.transcription_text
只存在于语音邮件与转录启用评论隐私更改事件
公开评论被标记为私人评论。
票证注释隐私更改事件具有以下属性:
名字 类型 只读 评论 id 整数 是的 在创建事件时自动分配 类型 字符串 是的 有价值吗? CommentPrivacyChange
comment_id 整数 是的 更改隐私的评论的id 公共 布尔 是的 说明评论是公开的还是私下的 例子
{
“id”:1274,
“类型”:“CommentPrivacyChange”,
“comment_id”:453,
“公共”:假
}
暂停机票回收活动
一张被吊销的罚单被追回。
挂起的票证恢复事件具有以下属性:
名字 类型 只读 评论 id 整数 是的 在创建事件时自动分配 类型 字符串 是的 有价值吗? SuspendedTicketRecovery
通过 对象 是的 创建该票的暂停票。看到通过对象引用 导致 字符串 是的 暂停的细节。看到悬吊原因参考 cause_name 字符串 是的 中止原因的关键。看到悬吊原因参考 cause_id 整数 是的 暂停原因的id。看到悬吊原因参考 recovery_details 字符串 是的 恢复的详细信息,包括恢复类型和恢复作者的名称 recovery_type 字符串 是的 恢复的类型。可能是 手册
或自动
recovered_at datetime 是的 恢复日期 recovered_by 整数 是的 执行恢复的用户 例子
{
“id”:10471060966419,
“类型”:“SuspendedTicketRecovery”,
“通过”:{
“通道”:“suspended_ticket”,
“源”:{
”到“:{},
“从”:{
“id”:10471036265747
},
“rel”:“suspended_ticket”
}
},
“原因”:“自动回复邮件,投递失败”,
“cause_name”:“auto_delivery_failure”,
“cause_id”:7,
“recovery_details”:“由管理员自动恢复”,
“recovery_type”:“自动”,
“recovered_at”:“2022 - 10 - 17 t18:35:27z”,
“recovered_by”:2987483127
}
通知事件
在创建或更新票据时,由业务规则(如触发器)发送通知。
通知具有以下属性:
名字 类型 只读 评论 id 整数 是的 在创建事件时自动分配 类型 字符串 是的 有价值吗? 通知
主题 字符串 是的 发送给收件人的消息的主题 身体 字符串 是的 发送给收件人的消息 收件人 数组 是的 一个简单对象数组,其中包含此通知接收者的id和名称 通过 对象 是的 创建通知的业务规则。看到通过对象引用 例子
{
“id”:1275,
“类型”:“通知”
“主题”:“您的机票已更新”
“身体”:“235号票已更新”
“收件人”:[847390,93905],
“通过”:{
“通道”:“系统”,
“源”:{
“类型”:“规则”,
“id”:61,
“标题”:“通知受让人评论更新”
}
}
}
带有CCs的通知事件
向请求者和电子邮件cc发送通知。
通知具有以下属性:
名字 类型 只读 评论 id 整数 是的 在创建事件时自动分配 类型 字符串 是的 有价值吗? NotificationWithCcs
主题 字符串 是的 发送给收件人的消息的主题 身体 字符串 是的 发送给收件人的消息 收件人 数组 是的 一个简单对象数组,其中包含此通知接收者的id和名称 通过 对象 是的 创建通知的业务规则。看到通过对象引用 例子
{
“id”:1275,
“类型”:“NotificationWithCcs”
“主题”:“您的机票已更新”
“身体”:“235号票已更新”
“收件人”:[847390,93905],
“通过”:{
“通道”:“系统”,
“源”:{
“类型”:“规则”,
“id”:61,
“标题”:“通知请求者和电子邮件cc评论更新”
}
}
}
短信通知事件
在创建或更新票证时,由业务规则(如触发器)发送SMS通知。
通知具有以下属性:
名字 类型 只读 评论 id 整数 是的 在创建事件时自动分配 类型 字符串 是的 有价值吗? SmsNotification
身体 字符串 是的 发送给收件人的消息 收件人 数组 是的 一个简单对象数组,其中包含此通知接收者的id和名称 例子
{
“id”:1275,
“类型”:“SmsNotification”
“身体”:“235号票已更新”
“收件人”:[847390,93905]
}
CC事件
当票据更新时,会通知cc(也称为协作者)。
Ticket CC事件具有以下属性:
名字 类型 只读 评论 id 整数 是的 在创建事件时自动分配 类型 字符串 是的 有价值吗? Cc
身体 字符串 是的 发送给收件人的消息 收件人 数组 是的 一个简单对象数组,其中包含此通知接收者的id和名称 通过 对象 是的 对创建此通知的业务规则的引用。看到通过对象引用 例子
{
“id”:1275,
“类型”:“Cc”
“收件人”:[93905],
“身体”:"您已在此请求({{ticket.id}})上注册为CC。\n\n{{ticket. comments_formatting}}”,
“通过”:{
“通道”:“系统”,
“源”:{
“类型”:“规则”,
“id”:62,
“标题”:“通知合作者评论更新”
}
}
}
关注者通知事件
当票证更新时,会通知一个追随者。
票务关注者通知事件具有以下属性:
名字 类型 只读 评论 id 整数 是的 在创建事件时自动分配 类型 字符串 是的 有价值吗? FollowerNotificationEvent
主题 字符串 是的 发送给收件人的消息的主题 身体 字符串 是的 发送给收件人的消息 收件人 数组 是的 一个简单对象数组,其中包含此通知接收者的id和名称 通过 对象 是的 对创建此通知的业务规则的引用。看到通过对象引用 例子
{
“id”:1275,
“类型”:“FollowerNotification”,
“主题”:“您的机票已更新”,
“身体”:"您是此请求({{ticket.id}})的关注者。{{ticket.follower_reply_type_message}} \ n \ n {{ticket.comments_formatted}}”
“收件人”:[847390],
“通过”:{
“通道”:“系统”,
“源”:{
“类型”:“规则”,
“id”:61,
“标题”:“通知关注者评论更新”
}
}
}
追随者变更事件
关注者已被添加或删除。
追随者变更事件具有以下属性:
名字 类型 只读 评论 id 整数 是的 在创建事件时自动分配 类型 字符串 是的 值为"FollowersChange" previous_followers 数组 是的 票上的前一个追随者 current_followers 数组 是的 目前的追随者在票上 例子
邮件抄送变更事件
邮件抄送已被添加或从票务中删除。
邮件抄送变更事件具有以下属性:
名字 类型 只读 评论 id 整数 是的 在创建事件时自动分配 类型 字符串 是的 有价值吗? EmailCcChange
previous_email_ccs 数组 是的 之前的邮件都是关于机票的 current_email_ccs 数组 是的 机票上当前的邮件地址 例子
宏观参考事件
宏引用事件具有以下属性:
名字 类型 只读 评论 id 整数 是的 创建事件时自动分配 类型 字符串 是的 有价值吗? MacroReference
macro_id 整数 是的 此事件所引用的宏的id macro_title 字符串 是的 此事件所指的宏的标题 macro_deleted 布尔 是的 是否删除此事件引用的宏 通过 对象 是的 事件是如何创建的。看到通过对象引用 例子
{
“id”:1274,
“类型”:“AgentMacroReference”,
“通过”:{
“通道”:“网络”,
“源”:{
“从”:{},
”到“:{},
“rel”:零
}
},
“macro_id”:45345,
“macro_title”:“降级”的机票,
“macro_deleted”:假
}
满意度评定事件
满意度评价事件具有以下属性:
名字 类型 只读 评论 id 整数 是的 创建事件时自动分配 类型 字符串 是的 有价值吗? SatisfactionRating
分数 字符串 是的 评级状态为"提供","未提供","好","坏" assignee_id 整数 是的 这张票是给谁的 身体 字符串 是的 用户在评分期间发表的评论 例子
{
“id”:1274,
“类型”:“SatisfactionRating”,
“分数”:“好”,
“assignee_id”:87374,
“身体”:“谢谢,你们太棒了!”
}
票务分享活动
票务共享事件具有以下属性:
名字 类型 只读 评论 id 整数 是的 创建事件时自动分配 类型 字符串 是的 有价值吗? TicketSharingEvent
agreement_id 整数 是的 共享协议id 行动 字符串 是的 要么 共享
或不共同参与的
例子
{
“id”:1274,
“类型”:“TicketSharingEvent”,
“agreement_id”:3454,
“行动”:“共享”
}
组织订阅通知事件
当组织中的某个人提交票证时,将向组织订阅者发送通知。
此功能在Zendesk Support用户界面的经典版本中可用。亚博在当前版本的Zendesk Support中,您可以亚博使用组织订阅API创建订阅。
组织订阅通知事件具有以下属性:
名字 类型 只读 评论 id 整数 是的 在创建事件时自动分配 类型 字符串 是的 有价值吗? OrganizationActivity
主题 字符串 是的 发送给收件人的消息的主题 身体 字符串 是的 发送给收件人的消息 收件人 数组 是的 一个简单对象数组,其中包含通知接收者的id和名称 通过 对象 是的 对创建通知的触发器的引用。看到通过对象引用 例子
{
“id”:1275,
“类型”:“OrganizationActivity”
“主题”:“您的机票已更新”
“身体”:“235号票已更新”
“收件人”:[847390,93905],
“通过”:{
“通道”:“系统”,
“源”:{
“类型”:“规则”,
“id”:61,
“标题”:“通知请求者评论更新”
}
}
}
SLA目标变更事件
SLA目标变更事件具有以下属性:
名字 类型 只读 评论 id 整数 是的 创建事件时自动分配 类型 字符串 是的 有价值吗? 改变
previous_value 对象 是的 以前的值(以分钟为单位),以及该值是以日历小时还是营业时间为单位的指示器。可能是空的 价值 对象 是的 以分钟为单位的当前值,以及该值是以日历小时还是营业时间为单位的指示器。可能是空的 field_name 字符串 是的 SLA度量的标识符。可能是"first_reply_time"或"requester_wait_time" 通过 对象 是的 通过信息。看到通过对象引用 例子
{
“id”:4497,
“类型”:“改变”,
“previous_value”:{“分钟”:150,“business_hours”:假},
“价值”:{“分钟”:45,“in_business_hours”:假},
“field_name”:“requester_wait_time”,
“通过”:{
“源”:{
“rel”:“sla_target_change”
},
“current_sla_policy”:“演示”
}
}
错误的事件
处理票证时发生错误。
票证错误有以下属性:
名字 类型 只读 评论 id 整数 是的 在创建事件时自动分配 类型 字符串 是的 有价值吗? 错误
消息 字符串 是的 错误信息 例子
{
“id”:1274,
“类型”:“错误”,
“消息”:453
}
微博事件
推特上的评论被添加到罚单上。
Tweet事件有以下属性:
名字 类型 只读 评论 id 整数 是的 在创建事件时自动分配 类型 字符串 是的 有价值吗? 推特
direct_message 布尔 是的 这条推特是否是一条直接信息 身体 字符串 是的 推文的主体 收件人 数组 是的 这条推文的接收者 例子
{
“id”:1274,
“类型”:“推特”,
“direct_message”:假,
“身体”:“你好”,
“收件人”:[847390,93905]
}
Facebook的事件
有人在Facebook墙上发表评论,或者向Facebook页面发送私人信息。
Facebook事件具有以下属性:
名字 类型 只读 评论 id 整数 是的 在创建事件时自动分配 类型 字符串 是的 有价值吗? FacebookEvent
页面 哈希 是的 与事件相关的Facebook页面的名称和图形id 沟通 整数 是的 相关通信亚博(墙报或消息)的Zendesk Support id ticket_via 字符串 是的 “post”或“message”取决于与墙帖或私人消息的关联 身体 字符串 是的 发布在Facebook上的信息的价值 例子
{
“id”:1274,
“类型”:“FacebookEvent”,
“页面”:{
“名称”:“亚博Zendesk”,
“graph_id”:“61675732935”
},
“沟通”:5,
“ticket_via”:“职位”,
“身体”:“谢谢!”
}
Facebook评论活动
Facebook上的一张罚单上加了一条评论。
Facebook评论有以下属性:
名字 类型 只读 评论 id 整数 是的 在创建事件时自动分配 类型 字符串 是的 有价值吗? FacebookComment
数据 对象 是的 Facebook评论的属性 身体 字符串 是的 作者的实际评论 html_body 字符串 是的 作者所作的实际注释格式为HTML 公共 布尔 是的 如果这是公开评论或仅限内部代理的注释 受信任的 布尔 是的 如果此评论被信任或标记为潜在欺诈 author_id 整数 是的 此评论作者的id graph_object_id 字符串 是的 关联的Facebook Wall帖子或消息的图形对象id 例子
{
“id”:1274,
“类型”:“FacebookComment”,
“数据”:{
“类型”:“状态”
“内容”:“asrk2d”,
“附件”:[
{
“id”:“70713 f06c93b0cba705cc10239ea3e4c”,
“mime_type”:“图像/ png”,
“名称”:“transpmentor.png”,
“大小”:26981
}
],
“via_亚博zendesk”:假
},
“公共”:真正的,
“author_id”:1,
“身体”:“谢谢你的帮助!”,
“html_body”:谢谢你的帮助!< / p > ",
“可信的”:真正的,
“graph_object_id”:“152318411530606 _1523184115123123”,
“附件”:[]
}
外部事件
外部票证事件具有以下属性:
名字 类型 只读 评论 id 整数 是的 在创建事件时自动分配 类型 字符串 是的 有价值吗? 外部
资源 字符串 是的 外部目标id 身体 字符串 是的 此目标事件的触发消息 例子
{
“id”:1274,
“类型”:“外部”,
“资源”:135476,
“身体”:"目标此票{{ticket.id}}"
}
LogMeIn记录事件
LogMeIn脚本事件具有以下属性:
名字 类型 只读 评论 id 整数 是的 创建事件时自动分配 类型 字符串 是的 有价值吗? LogMeInTranscript
身体 字符串 是的 对笔录的审计 例子
{
“id”:1274,
“类型”:“LogMeInTranscript”,
“身体”:会话ID: 1234技术人员名称:Johnny用户技术人员邮箱:(电子邮件保护)……”
}
推动事件
信息被推送到外部目标。看到通知外部目标在Zendes亚博k帮助中心。
推送事件有以下属性:
名字 类型 只读 评论 id 整数 是的 在创建事件时自动分配 类型 字符串 是的 有价值吗? 推
价值 字符串 是的 数据正在从我们的系统中被推出 value_reference 字符串 是的 对数据目的地的引用 例子
{
“id”:1274,
“类型”:“推”,
“价值”:”李< > < >强项目< / >强:内部李< / > <李> <强>任务< / >强:管理……”,
“value_reference”:“收获时间追踪”
}
聊天开始事件
在Agent W亚博orkspace中启动了聊天、Zendesk消息传递或社交消息传递对话。
聊天启动事件有以下属性:
名字 类型 只读 评论 id 整数 是的 在创建事件时自动分配 类型 字符串 是的 有价值吗? ChatStartedEvent
价值 数组 是的 消息传递会话的属性 历史 数组 是的 关于聊天事件的数据 webpath 数组 是的 消息传递对话的web路径 附件 数组 是的 这段对话的附件是附件对象 例子
{
“id”:1717959154921,
“类型”:“ChatStartedEvent”,
“价值”:{
“visitor_id”:“10655845 - 15 - vkfhozi7rnzro”,
“chat_id”:“2108.10655845.SfiWb2lS6gX6c”,
“标签”:[“whatsapp_chat”]
}
}
聊天结束事件
在Agent W亚博orkspace中结束了聊天、Zendesk消息传递或社交消息传递对话。
聊天结束事件有以下属性:
名字 类型 只读 评论 id 整数 是的 在创建事件时自动分配 类型 字符串 是的 有价值吗? ChatStartedEvent
价值 数组 是的 消息传递会话的属性 附件 数组 是的 这段对话的附件是附件对象 例子
{
“id”:1920482841485,
“类型”:“ChatEndedEvent”,
“价值”:{
“chat_id”:“2108.10655845.SfiWb2lS6gX6c”,
“visitor_id”:“10655845 - 15 - vkfhozi7rnzro”,
“is_served”:假,
“标签”:[“whatsapp_chat”]
},
“附件”:[]
}
技能分配事件
一个或多个技能被分配到的票。在这种情况下,技能被命名为属性值。技能类型被命名为属性。
技能分配的事件具有以下属性:
名字 类型 只读 评论 id 整数 是的 在创建事件时自动分配 类型 字符串 是的 有价值吗? AssociateAttValsEvent
attribute_value 数组 是的 技能分配给票。 attribute_id
id是技能类型例子
{
“id”:11654650767636,
“类型”:“AssociateAttValsEvent”,
“attribute_value”:[
{
“id”:“2 aa15dcf-7d4f-11ed-8b72-9b5bb2ceed2e”,
“名称”:“巨蟒”,
“attribute_id”:“2867 e888 - 7 - d4f - 11 - ed - 8 b72 - 85 - e72d02c5e0”
}
]
}
来自+1(123)654-7890的呼入呼叫
\nCall Details…",
“author_id”:63197591,
“可信的”:真正的,
“附件”:[]
}