票审核支持REST API中的资源可以使用以下事件来描述票证更新:

每个事件都有自己的事件通过对象,如果它与通过审计对象。看到支持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”“身体””“来自+的呼入1123654-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”"
\n

来自+1(123)654-7890的呼入呼叫
\nCall Details…"
“author_id”63197591“可信的”真正的“附件”]}

注:

  • data.answered_by_id语音留言时不在场
  • data.transcription_statusdata.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号票已更新”“收件人”84739093905]“通过”“通道”“系统”“源”“类型”“规则”“id”61“标题”“通知受让人评论更新”}}}

带有CCs的通知事件

向请求者和电子邮件cc发送通知。

通知具有以下属性:

名字 类型 只读 评论
id 整数 是的 在创建事件时自动分配
类型 字符串 是的 有价值吗?NotificationWithCcs
主题 字符串 是的 发送给收件人的消息的主题
身体 字符串 是的 发送给收件人的消息
收件人 数组 是的 一个简单对象数组,其中包含此通知接收者的id和名称
通过 对象 是的 创建通知的业务规则。看到通过对象引用

例子

             
“id”1275“类型”“NotificationWithCcs”“主题”“您的机票已更新”“身体”“235号票已更新”“收件人”84739093905]“通过”“通道”“系统”“源”“类型”“规则”“id”61“标题”“通知请求者和电子邮件cc评论更新”}}}

短信通知事件

在创建或更新票证时,由业务规则(如触发器)发送SMS通知。

通知具有以下属性:

名字 类型 只读 评论
id 整数 是的 在创建事件时自动分配
类型 字符串 是的 有价值吗?SmsNotification
身体 字符串 是的 发送给收件人的消息
收件人 数组 是的 一个简单对象数组,其中包含此通知接收者的id和名称

例子

             
“id”1275“类型”“SmsNotification”“身体”“235号票已更新”“收件人”84739093905]}

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”1274“类型”“FollowerChange”“previous_followers”(电子邮件保护){子域名}。com”(电子邮件保护){子域名}。com”]“current_followers”(电子邮件保护){子域名}。com”]}

邮件抄送变更事件

邮件抄送已被添加或从票务中删除。

邮件抄送变更事件具有以下属性:

名字 类型 只读 评论
id 整数 是的 在创建事件时自动分配
类型 字符串 是的 有价值吗?EmailCcChange
previous_email_ccs 数组 是的 之前的邮件都是关于机票的
current_email_ccs 数组 是的 机票上当前的邮件地址

例子

             
“id”1274“类型”“EmailCcChange”“previous_email_ccs”(电子邮件保护){子域名}。com”(电子邮件保护)]“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号票已更新”“收件人”84739093905]“通过”“通道”“系统”“源”“类型”“规则”“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”“身体”“你好”“收件人”84739093905]}

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_idid是技能类型

例子

             
“id”11654650767636“类型”“AssociateAttValsEvent”“attribute_value”“id”“2 aa15dcf-7d4f-11ed-8b72-9b5bb2ceed2e”“名称”“巨蟒”“attribute_id”“2867 e888 - 7 - d4f - 11 - ed - 8 b72 - 85 - e72d02c5e0”}]}