您可以将帐户数据(如门票、用户或组织)导出为JSON、CSV或XML文件。
出于安全考虑,您可以根据管理员的email域限制哪些人可以导出数据。如果Zendesk启用了数据导出,您也可以停用帐户中的数据导出。亚博看到限制或停用帐户数据导出.
导出帐户数据
从您的帐户导出票证、用户或组织数据
- 如果还没有这样做,让Zendesk在您的帐户中启用亚博数据导出。
的账户所有者必须联系亚博Zendesk客户支持启用帐户中的数据导出。请确保在请求中包含您的Zendesk Support亚博子域名。
当您的帐户中启用了数据导出时,返回这里。
- 在管理中心,点击账户在侧边栏中,然后选择Tools >报表.
如果您没有看到此选项,并且在您的帐户中启用了数据导出,则可能会限制您导出数据。看到限制数据导出给特定管理员.
如果需要,单击出口选项卡显示数据导出选项。Zendesk的一些旧版本在单独的选项卡上显示导亚博出选项。
- 选择一个导出选项。
对于拥有超过200,000张门票的帐户,建议使用JSON导出选项。
要运行JSON导出,请选择日期范围、选择票据、用户或组织,然后单击出口.
若要运行CSV或XML导出,请选择请求文件在每个选项旁边。无法设置日期范围或选择数据类型。
中不支持JSON和CSV导出沙盒账户。
导出完成后,Zendesk会向您发送一封电子邮件,其中包含亚博指向数据文件的下载链接。点击链接下载zip文件。
导出过程可能需要几分钟到几个小时,具体取决于请求的导出日期范围和您帐户的票证活动级别。如果你对正在等待的特定出口产品有担忧,请联系Zende亚博sk客户支持.
如果您没有收到邮件通知,您可以单击最新的旁边完整JSON导出,CSV导出,完整的XML导出,或用户XML导出下载最近生成的报告。最新的报告显示您上次请求的文件中的帐户数据,而不是当前帐户数据。看到延迟接收带有可下载数据导出文件的电子邮件.
了解数据导出选项
完整JSON导出
将票据、用户或组织导出到JSON文件。拥有超过100万张门票的账户将以31天为单位进行下载。
亚博Zendesk以“NDJSON”或换行分隔的JSON格式导出数据。这种格式使系统能够一次流式传输一个JSON对象,而不是一次读取整个文件。这对于非常大的导出文件很有帮助,对于传统的JSON阅读器来说,这可能太大了。看到ndjson.org网站获取更多关于NDJSON的信息。
如果您想要一个包含所有信息的JSON文件,而不是一个流版本,您可以将票据对象包装在JSON数组中。例如,如果Zendesk导出以下亚博票据对象:
{“票”:{" id ":……}}{“票”:{" id ":…}}{“票”:{" id ":……}}
你可以通过将对象包装成"tickets"数组来创建一个有效的JSON文件,如下所示:
{" tickets": [{"ticket": {"id":....}}, {"ticket": {"id":....}}, {"ticket": {"id":....}}]}
这些导出的日期范围使用系统生成的时间戳.通常,这些时间戳匹配票证、用户或组织上记录的最新更新(而不是创建日期)。在某些情况下,系统更新不会生成票证事件。在这些情况下,您可能会在输出中看到一些意想不到的票据。
- 一个JSON文件,其中包含您导出的所有票据,包括超过1 MB限制且导出时没有注释的票据
- 一个JSON文件,其中包含超过1 MB限制的票据和一条错误消息,让您知道没有包含注释的原因是因为票据超过了1 MB限制。例子:
CSV导出
将票据数据导出为CSV文件。该数据不包括已删除的票据、票据注释或票据描述。
如果单个票证的数据超过1mb,则该票证将从报告中排除。但是,这种情况很少发生,因为CSV导出不包括票据注释,而票据注释通常是票据中最大的数据组件。
所有日期和时间值都转换为帐户的默认时区(在导出时)。CSV文件中显示的日期可能与JSON导出(UTC)或Explore(显示用户的时区)中的日期不匹配。有关帐户时区的详细信息,请参见设置时区和格式的Zendesk支持亚博.
报告中的票证数据包括下表所示的数据。多行文本和多选择字段以及自定义日期字段不包含在CSV报告中,但可以包含在JSON和XML报告中。
数据 | 描述 |
---|---|
ID | 票号。 |
请求者 | 请求者的名称。 |
请求者ID | 请求者的ID号。 |
请求者外部id | 来自外部系统的ID。对于使用JWT或SAML启用了专业或企业单点登录的帐户是可选的。 |
请求者的电子邮件 | 请求者的主要电子邮件地址。 如果需要导出用户从邮箱列表,必须使用列出用户API端点而侧载身份(例如: |
请求者域 | 请求者的主电子邮件地址的电子邮件域。 |
提交者 | 初始提交者的名称。如果请求者提交了票据,则显示请求者的名称。如果代理代表申请方提交票证,则使用代理的名字。如果请求者改变了,提交者不会改变。 |
受让人 | 出口时的受让人。 |
集团 | 出口时的组。 |
主题 | 票据的主题。 |
标签 | 出口时加在船票上的标签。 |
状态 | 出口时的状态 |
优先级 | 出口时优先。 |
通过 | 票证产生的票证通道。 |
票类型 | 输出时的类型。 |
在创建 | 原始创建时间和日期。显示在帐户的时区。 |
更新在 | 最近更新的时间和日期。显示在帐户的时区。 |
分配在 | 最近一次代理委派的时间和日期(即委派给当前受让人的时间)。显示在帐户的时区。 |
组织 | 当前请求者的组织(如果有的话)。 |
到期日期 | 出口时的到期日。显示在帐户的时区。 |
最初分配于 | 第一次分配给一个代理(不是一个组)的时间和日期。显示在帐户的时区。 |
解决了在 | 最终或最近更改到已解决状态的时间和日期。显示在帐户的时区。 |
解决时间 | 最后或最近的解决时间(以小时为单位),四舍五入到最接近的整小时。 |
满意的分数 | 当前满意度评级状态(未提供、已提供、好或坏)。 |
组站 | 组分配更改的次数。创建车票时的初始分配也算作一个车站。 |
受让人站 | 代理分配更改的次数。创建车票时的初始分配也算作一个车站。 |
重开 | 票据从已解决更改为打开的次数(无论是由代理还是最终用户)。 |
回复 | 公共代理对来自代理或最终用户的评论的回复数量。 |
首次回复时间(以分钟为单位) | 票证创建时间到第一个公共代理评论的时间戳之间的时间,以分钟为单位显示。 |
首次回复时间,在工作时间内以分钟为单位 | 同上,但只计算所列营业时间内的时间。 |
首次解析时间(以分钟为单位) | 从票据创建时间到状态第一次改变为Solved的时间戳之间的时间,以分钟为单位显示。 |
第一次解决时间在工作时间内以分钟为单位 | 同上,但只计算所列营业时间内的时间。 |
全分辨率时间,以分钟为单位 | 票据创建时间到最终或最近状态更改为Solved的时间戳之间的时间,以分钟为单位显示。 |
在工作时间内,以分钟为单位的全分辨率时间 | 同上,但只计算所列营业时间内的时间。 |
座席等待时间以分钟为单位 | 待挂起状态花费的总时间,以分钟为单位。 |
座席等待时间在营业时间内以分钟为单位 | 同上,但只计算所列营业时间内的时间。 |
请求程序等待时间(以分钟为单位) | 在New和Open状态下花费的总时间。如果在解决后重新打开票证,则在解决状态下花费的时间也被计算在内。最终更改为已解决状态后的时间不包括在内。 |
请求者等待时间在工作时间内以分钟为单位 | 同上,但只计算所列营业时间内的时间。 |
等待时间以分钟为单位 | 处于等待状态的总时间,以分钟为单位。 |
在营业时间内,等待时间以分钟为单位 | 同上,但只计算所列营业时间内的时间。 |
完整的XML导出
将数据导出到XML文件。如果您的帐户有超过200,000张门票,则此导出选项不可用。在这种情况下,使用JSON导出选项。
- 账户-您的帐户的所有设置
- 组-关于您的组的详细信息
- 组织-组织的详细信息
- 票-所有门票的详细信息(包括评论)
- 用户-所有用户(最终用户、代理和管理员)的列表
48个评论
我已经使用UI将门票数据导出为JSON,并设置开始日期1/1/2019。现在我正在查看导出结果,并看到第一个记录“created_at”来自2017年左右。有人能澄清数据范围是如何在UI导出中使用的吗?
满意度得分包含在出口中,但不包括评级日期,有可能包括这个吗?还是我错过了什么?
是否有可能从资源管理器中提取具有该信息的.csv ?
此外,自定义字段通过. csv导出,这很好。
嗨Yevgen,
JSON导出使用最后更新的时间戳,而不是票据创建的时间戳。这意味着它会把所有的票都抽走更新自2019年1月1日起,因此您可以看到在该日期之前创建的门票。
在“了解数据导出选项”一节中也提到了这一点:https://support.亚博zendesk.com/hc/en-us/articles/203662346-Exporting-data-to-a-JSON-CSV-or-XML-file#topic_lnw_tfb_sfb
温暖的问候,
埃里克
Eric G. Gao |技术支持架构师| Zendesk亚博
你好,
我承认我并没有在所有的评论中寻找我的问题/答案,但我确实看了很多。
使用JSON用户导出,是否有可能获得所有用户的身份,还是只有主用户的身份?在我的例子中是电子邮件地址。如果我想要所有的电子邮件地址,我需要使用Rest api吗?我在导出文件中没有看到非主要邮件。
- - - - - -斯科特
有什么方法可以导出我们所有票证的公开回复和内部笔记吗?我们想对自由格式文本中的内容进行模式分析,看看是否有特定单词或需求的模式经常出现在我们的票中。
嗨@……-
你应该可以通过票务评论API.
另外,市场上有一些应用程序可以处理这个问题,比如这一个.
希望这对你有帮助!
布兰登
嗨pstrauss !本文中描述的Tickets JSON导出还包括票据注释。每条评论都包括全文,无论是公开的还是私人的。这与您从Ticket Comments API获得的信息非常相似。
由于票据和注释可能相当大,所以我通常推荐较小的JSON导出。您可以使用日期范围工具来限制每个文件的大小。您还需要使用文本编辑器稍微调整格式,以便将整个文件视为JSON。(每个导出的票据都有适当的JSON格式,但它们没有在文件中分组在一起。)
如果Tickets JSON导出不能完全满足你的需求,那么Brandon提供的市场应用和API端点可以给你更多的选择。
我希望这对你有帮助!
谢谢@……和@……-这很有帮助。我将继续请求在我们的帐户上激活导出,并在深入使用API或第三方应用程序方法之前看看JSON文件是否适合我们。
我有专业计划(销售和支持)和新的zendesk。亚博我想备份数据从销售和支持每天至少。
从我目前所读到的,实现“备份”的唯一方法是导出数据?如果这是正确的,可以自动导出吗?如果是这样,请给予指导和帮助。
另一方面,如果这不是唯一的方法,请建议所有其他方法
谢谢
对于完整JSON导出,起始日期和截止日期条件是什么?它是用来过滤“created_at”或“updated_at”或其他什么?我想导出在特定时期创建的票证,但我从json中得到的结果不是我所期望的。
@……—日期范围过滤器基于“生成”的时间戳。它是任何类型的最新更新,可能与票证的“created_at”或“updated_at”时间戳不匹配。它遵循与基于时间的增量API调用相同的行为。我们在这里有更多的信息:不包括系统更新的门票.
@……- UI中有导出工具,可以让您备份数据。上面的文章描述了支持中的选项,本文描述了销售中的选项:从Zendesk导出数据亚博.不过,这些都是手动选项。您不能自动化系统导出工具。
如果希望设置自动导出,则需要查看API。在支持方面,我推荐增量API.这允许您提取自起点以来已更新的所有记录(使用我前面提到的“生成的”时间戳)。在“出售”方面,您可以勾选“同步”或“消防软管”选项Sell的API文档.
我希望这对你有帮助!
你好,
我试图导出组的名称分配给我们的支持帐户上的组织,但在JSON导出组显示为ID而不是名称。
此外,该信息不会出现在Explore中,因为它显示了分配给票据的当前组,而不是一般组。我说的是屏幕截图中绿色的区域。
大家都知道如何导出所有组织的数据吗?
嗨@……!你是对的;该属性目前在探索中不可用。JSON导出可能是查找与组织关联的组的最佳资源。
由于JSON导出返回的是ID而不是名称,因此需要第二个资源将名称与ID连接起来。我推荐列表组API.这是一个相对简单的GET调用https://SUBDOMAIN.亚博zendesk.com/api/v2/groups(你甚至可以在浏览器中访问它,只要你登录了你的账户)。
List Groups API包含每个组的ID和名称,因此您可以将其用作引用。
我希望这对你有帮助!
谢谢@……工作好了!
我们可以从Zendesk导出指南上的文章吗?亚博
嘿,铁托,
你可以使用指导API来导出文章,也可以使用kBackup应用程序在我们的应用程序市场。
我希望这对你有帮助!
实际上,我没有看到任何方法可以使用API导出带有标签或特定表单等参数的票据审计。这可以澄清吗?这是如何实现的呢?
嗨CJ !本文介绍Zendesk数据的本地导出选项。亚博ticket JSON导出是其中最全面的——它包含当前状态的ticket(包括标签、字段值和表单)、所有关联用户的详细信息、度量数据和完整的评论历史。它是票务数据的一个很好的资源,但它不涉及个人票务审计。
如果您对票证审计感兴趣,您有几个广泛的选择。
的票务审计API显示票证的完整审核历史。它包括对票证的每一次更改,包括每次更新的元数据、所有字段更改、所有注释文本等。这是一张完整的图片,但它一次只支持一张票。如果您已经确定了票据的子集(通过搜索或其他资源),并且需要提取该票据id列表的详细信息,则此选项很有帮助。对于大量或正在进行的出口来说,这是没有效率的。
对于包含票证审计的大型或正在进行的导出,我建议使用增量票证事件API.增量端点的设计目的是尽可能高效地交付大量原始数据。票据事件端点单独返回每个事件,包括所有更改和元数据。(您必须包含comment_events边荷载如果你也想要评论文本。)这允许您批量提取所有票证事件,但您需要将它们单独重新组装为票证。
我希望这对你有帮助!
我没有看到清单上的报告
它就是不存在
单击管理在侧边栏中的Icon(),然后选择管理>报表.
嗨,克里斯!这可能意味着以下两种情况之一:
未启用导出。默认情况下禁用导出。如果您的帐户尚未启用这些功能,则帐户所有者需要联系支持团队。
导出工具有域限制。帐户所有者总是可以访问导出页面(一旦启用),但他们可以选择限制其他人可以访问该页面。只有具有匹配电子邮件域的帐户管理员才能看到它。
如果您是帐户的管理员,并且没有看到导出选项,请与帐户所有者签入并联系客户支持如果需要的话。
我希望这对你有帮助!
我们打开了导出功能,但我只能看到以CSV或XML导出的选项,甚至在将日期限制为一个月之后。知道为什么我看不到JSON选项吗?
你好,凯特!CSV和XML导出不使用日期过滤器。他们总是返回完整的帐户历史记录。如果看到日期过滤器,则应该有JSON导出。它看起来是这样的:
日期过滤器、类型和Export按钮都是上面“完整JSON导出”的一部分。完成一些导出后,您将看到它们也列在过滤器上方:
如果您看到的是这种情况,请单击Export按钮并等待电子邮件通知。您应该得到一个JSON导出。如果这不是您看到的,或者您得到的不是JSON导出,请联系我们的支持团队进一步调查。
我希望这对你有帮助!
你好,
是否可以使用特定的标准导出门票,例如,如果我想导出带有特定标签的门票。
最好的
莎拉
你好,萨拉,
这取决于你说的出口门票是什么意思。如果您不需要每个注释,只需要第一个消息和票证字段,这是可能的,但它比内置方法更棘手。您可以使用Search API来做到这一点。现在,好消息是,你可以做到这一点,而不是一个程序员!
这就是你想要做的,在我的例子中,我们假设你想要的标签是"closed_by_merge"。
1.将域名替换为zendesk域名,并将其放在浏览器中;亚博https://domain.亚博zendesk.com/api/v2/search/export.json?filter[型]= ticket&query =标签:closed_by_merge
2.您应该看到代码的JSON输出。要将其转换为CSV,运行如下代码https://konklone.io/json/.
3.确保获得所有页面!在显示的代码页面底部,您将看到如下链接:
你需要复制并跟随这个链接到第二页。继续,直到你得到一个NULL/空白的下一页。
如果您想尝试一下,这里有一些指南,告诉您如何编写Python脚本来运行搜索,决定收集哪些列,收集所有页面,以及将其格式化为CSV。如果您有数千个结果,并且不想逐页下载和转换结果,并且希望将CSV中的列限制为您实际想要/需要的内容,那么这将非常有用。
Thank you, CJ Thank you, Dave I really appreciate your help.
最好的
莎拉
在这里. .声明JSON导出的列表不是一个有效的JSON对象…
…我完全同意。事实上,我总是需要使用编辑器在每个新行之后添加前缀'['和后缀']'和逗号,以便正确解析列表(例如:在python中)。很烦人的…
所以,问题来了:为什么不导出为格式正确的JSON数组呢?我认为这应该被视为一个bug,而不是一个限制或设计。给我提供一个没有逗号和括号的json对象序列是没有意义的!
你好,Zen亚博desk支持,
我看到我们可以拉很多票证数据,但有没有办法通过这种方法拉宏?
欢迎来到这个社区!虽然可以通过我们的API检索宏信息,但没有内置的方法来导出宏:宏
有一些(付费)第三方应用程序可以用于导出宏观数据(以及其他内容):应用程序市场
这篇文章还准确吗?我在我的例子中没有看到这样的情况。是的,我可以转到帐户和报告,但我必须首先创建一个具有有限设置的报告,然后我可以导出,但只能导出到CSV和XML,不能导出JSON。
顺便说一句,我们正在进行Suite Growth
请登录留下评论。