管理员可以批量导入多个用户,而不是每次手动添加一个用户。为此,您需要创建一个包含用户数据的CSV(逗号分隔值)文件。除了基本的用户数据(如电子邮件地址和电话号码)之外,还可以设置用户角色、定义代理的权限以及向组织添加用户。您可以使用批量导入添加新用户或更新现有用户。通过CSV文件批量导入仅适用于Support用户和角色。
必须是管理员才能批量导入用户和组织。
批量导入用户和组织的限制
您可以导入一组关于用户和组织的核心数据。例如,使用批量导入,您可以导入下表中描述的数据;但是,您不能导入时区、照片、语言首选项等。要导入下表中未列出的数据,您需要使用Zendesk REST API。亚博看到使用Zendesk API导入用户亚博或使用Zendesk API导入组织亚博.
- 导入的CSV数据文件必须包含不超过2000行数据(一行为标题,其余为用户或组织数据)。
- 一次只能导入一个数据行数不超过2000行的CSV文件。因此,如果要导入的用户或组织超过1999个,则需要为每个批创建单独的文件,然后依次导入它们。最多有两个批在后台排队运行。如果要导入两个以上的批,则需要等到第一批批导入完成后才能添加更多批。
- 不能使用批量导入从最终用户Facebook或Twitter帐户导入联系人信息。相反,使用Zendesk REST亚博 API。看到使用Zendesk API导入用户亚博.
创建CSV用户数据文件
当您创建要导入的用户列表时,您可能会从其他用户管理系统(如员工数据库)生成该列表。大多数这些系统都有一些创建CSV导出文件的功能。如果你需要从头开始创建列表,你可以使用Microsoft Excel或OpenOffice.org Calc等程序。
- 该文件必须是正确格式化的CSV,并使用UTF-8字符编码保存。
- CSV文件的第一行是标题行,必须将其包含在文件中。
- 标题行必须包含下表中任何必需的字段,以及下表中列出的您希望包含的任何其他字段。
- 包含的字段必须按照下面列出的顺序出现在标题行中。
- 如果不为字段导入数据,则不要将其列在标题行中。
- 文件中的空数据列将覆盖该用户的大部分现有数据。有关例外情况,请参见更新现有用户配置文件数据.
- 通过在Windows上按ALT+ENTER或在Mac上按CTRL+OPTION+RETURN,为注释或多行自定义字段添加换行符。
下表列出了可以包含在文件中的字段。在导入新用户时,需要输入name、email和restrict字段。当通过批量导入更新现有用户时,只需要一个唯一标识符(例如电子邮件或外部ID)。
场 | 描述 |
---|---|
名字 | 导入新用户所需.用户的全名。 |
电子邮件 | 导入新用户所需.用户的完整电子邮件地址(someuser@mycompany.com)。您可以为用户提供多个电子邮件地址。看到为用户分配多个邮箱地址. |
external_id | 如果您有用户电子邮件地址以外的ID(例如员工ID或客户参考号),则可以在此处包含它。每个用户的外部id必须是唯一的,否则数据将被覆盖。 如果你不启用在CSV输出文件中包含外部ID,外部id将从CSV导入结果文件中排除(参见导入CSV格式的用户数据文件)。
注意:如果您导入的用户使用external_id字段作为其唯一标识符(意味着您还不包括电子邮件地址),那么您仍然需要在CSV文件中包含电子邮件字段,而不包含数据。例如:
|
细节 | 有关该用户的详细信息,例如地址。此信息仅对团队成员可见,对最终用户不可见。 |
笔记 | 关于该用户的注意事项。注释仅对团队成员可见,对最终用户不可见。 |
电话 | 用户的电话号码。唯一的电话号码被添加为直拨电话。已经存在的电话号码被添加为辅助线路。和Talk一起工作,电话号码应采用国际标准化格式E.164格式。 |
shared_phone_number | 如果这是一个共享的电话号码,设置为“true”。共享的电话号码不能作为电话号码用户身份. |
角色 | 区分大小写:“End-user”、“Agent”或“Admin”。如果未设置角色,则用户为“最终用户”。 |
限制 | 导入新用户所需当用户的角色为“Agent”时。当用户的角色设置为“终端用户”时,可以分配“组织”和“请求”的限制值。限制设置团队成员或最终用户的特权,他们可以访问的票据,等等。
您可以输入以下值之一:
在Zendesk Support的企业版中,您还可以使用限亚博制字段为您的代理用户分配预定义或自定义角色。看到将代理分配给企业代理角色在下面。 |
组织 | 将用户添加到的组织的名称。该组织必须已经存在,否则导入将失败。 在Professional和Enterprise上,您可以通过使用管道字符分隔组织名称(请参阅将用户导入多个组织)。 |
标签 | 当用户和组织标签已经为Zendesk支持启用时(参见参见)亚博向组织添加标签和用户),您可以添加用户标签。用逗号分隔每个标签。 |
品牌 | 如果帐号有多个品牌,可以指定一个品牌子域。您指定的品牌子域决定了发送给用户的欢迎电子邮件的品牌,只要该品牌是活动的并且具有启用的帮助中心。如果您指定的品牌子域未激活,没有启用帮助中心,或者不存在,则忽略该列,并使用默认品牌发送欢迎电子邮件。 只指定brand子域的名称。例如,使用mydomain而不是mydomain.亚博zendesk.com. |
custom_fields。<字段>键 | 在执行批量用户导入时,可以通过指定custom_fields。前缀和字段键。 例如,对于字段键subscription_date,使用以下命令设置该字段的导入值。 custom_fields.subscription_date 如果要将信息导入复选框,请输入“true”以选中该复选框,或输入“false”以不选中该复选框。要设置下拉列表选项的值,请使用创建下拉列表时添加的标记。对于自定义日期字段,可以使用YY/MM/DD或YYYY-MM-DD格式。
查找自定义用户字段的键。
如果字段值的格式不正确,则导入将失败,并且您将收到一个错误报告,指定保存失败的记录。 |
关于在批量导入中发送给用户的欢迎电子邮件的说明
当通过批量导入添加新用户时,如果启用了Guide,每个用户都会收到欢迎电子邮件消息。欢迎电子邮件包含一个验证其电子邮件地址的链接,该链接提示他们选择密码,然后登录。
您可以通过更新欢迎电子邮件设置来阻止向所有这些用户发送欢迎电子邮件。
防止向用户发送欢迎电子邮件
- 在管理中心,点击人在侧边栏中,然后选择配置>最终用户.
- 在用户欢迎邮件节中,取消选择当代理或管理员创建新用户时,也要发送验证电子邮件.
注意:在启用向导之前,此选项不可用。
- 点击保存选项卡.
将用户导入多个组织
如果您使用的是专业版或企业级版,则可以在批量导入期间向多个组织添加用户。
Organization1 | Organization2 | Organization3
下面是将用户添加到三个不同组织的CSV示例。
"name","email","external_id","details","notes","phone","role","restriction","organization","tags" Enrico Venticello,"venticello@somecompany.com",,,,,,,Organization1|Organization2|Organization3,,,
如果列出不存在的组织,则导入将失败。
用户的默认组织将按字母顺序设置为第一个组织。不可能使用.csv导入设置不同的默认组织。可以手动调整用户的默认组织,也可以使用支持API -将成员设置为默认值端点。
将代理分配给企业自定义角色
在Enterprise中,您可以为代理分配自定义角色。自定义角色通常用于为代理提供额外权限或增加限制。
如果你创建自己的自定义代理角色中包含自定义角色的名称,可以在批量导入期间将其中一个角色分配给用户限制领域.下面以CSV为例,为用户配置自定义角色。
"name","email","external_id","details","notes","phone","role", "restriction","organization","tags" Enrico Venticello,"venticello@somecompany.com",,,,,"agent","Help Desk Mastermind",,
在上面的例子中,用户(Enrico Venticello)被赋予一个通用角色(“代理”),并具有与自定义代理角色(“Help Desk Mastermind”)相关联的附加权限。
注意,您必须已经在Zendesk Support中创建了自定义角色,然后才能在CSV中使用它。亚博如果您不小心使用了支持中不存在的角色名,则用户的角色默认为Light Agent。然后,您可以手动更改代理在其用户配置文件中的角色。
此外,导入是不区分大小写的,这意味着以下两个自定义角色名称将代理设置为相同的角色:“Help Desk Mastermind”和“Help Desk Mastermind”。
为用户分配多个邮箱和电话号码
在上传文件中,为多个电子邮件地址或电话号码提供相同的外部ID(以及要导入的所有用户字段,例如role),如上图所示。与相同外部ID关联的所有电子邮件或呼叫将被路由到与该ID关联的用户。
请注意,当电子邮件地址与现有用户匹配并且外部ID或电话号码没有不匹配时,该用户将使用辅助电子邮件或新电话号码进行更新。但是,如果任何外部ID、电子邮件地址或电话号码与多个现有用户匹配,则该行将被拒绝。
导入CSV格式的用户数据文件
您可以导入新用户或更新现有用户的信息。
- 在管理中心,点击人在侧边栏中,然后选择批量操作>导入用户.
- 选择导入选项:
创建新用户:默认勾选,不可关闭。这是因为总是会创建存在于导入数据中而不存在于Zendesk中的用户。亚博
更新现有用户:您还可以选择此导入选项来替换CSV文件中列出的用户的现有数据。您只需要在文件中包含想要更新的字段。如果数据列为空,它将覆盖该用户的现有数据。有关异常列表,请参见更新现有用户配置文件数据.
注意:的当用户的密码被修改时,发送邮件通知用户选项目前不可用。
- (可选)选择在CSV输出文件中包含外部ID.
导入过程完成后,您将收到一封电子邮件通知,其中包含指向单独CSV的链接导入结果文件.您可以使用此链接下载文件并查看导入的结果。
该文件显示您尝试导入的用户数据的状态(已创建、已更新、已跳过)。它包括创建或更新的每个用户的电子邮件地址或外部ID,具体取决于您导入的文件的内容以及是否在CSV输出文件中包含外部ID被启用。
如果你不启用在CSV输出文件中包含外部ID, CSV导入结果文件中不包含外部id。外部ID是额外的标识符,例如员工编号、客户参考编号或来自另一个系统的用户ID。一个用户只能有一个唯一的外部ID。对于用户来说,这是一个可选属性。
- 或者点击选择文件或者是我还是粘贴数据吧链接。
- 点击进口.
导入过程完成后,您的导入被添加到队列中,用户被添加到Zendesk Support中。亚博看到批量导入用户和组织的限制.导入完成后,您将收到一封电子邮件。
更新现有用户配置文件数据
在进行批量导入时,您可以选择更新现有用户,这允许您更新已经添加的用户的用户配置文件数据。但是,请注意,有些数据是取代有些数据只是附加到现有的数据。
替换的用户数据如下:
- 名字
- external_id注意:每个用户的外部id必须是唯一的。
- 角色
- 限制
- 组织
- 自定义字段
添加以下用户数据(添加到现有数据中):
- 细节
- 笔记
- 标签
- 电话(作为辅助电话号码添加)
- 电子邮件(作为辅助电子邮件地址添加)
55岁的评论
你好@……和@……!我正试图删除我们拥有的所有23k终端用户的电话号码。我编写了一个脚本,以便能够遍历用户,如果是电话号码,则提取其用户身份id,然后通过API删除它。然而,我注意到,尽管状态码为204,在许多情况下,我仍然可以从UI看到电话号码,尽管当我通过API查询它时它不再可用。在其他情况下,删除用户标识确实会从UI中删除电话号码。这让我相信,有时电话号码(尚不清楚何时)作为用户标识存储在用户的电话字段中,并且删除用户标识实际上并没有从用户中删除它。很难弄清楚你们实际上是如何存储电话号码的。有没有Zendesk团队的人能给我解释一下如何亚博永久删除电话号码和/或对我们的代理隐藏电话号码?
嗨@……,
电话号码可以存储为直拨线路或共享线路。我们在这里进行更详细的介绍:了解电话号码如何与最终用户档案相关联
然而,我不认为这解决了你所面临的问题,它可能是值得把它纳入一个票找出答案。
我会从我创建的关于你的问题的票中联系你。一旦我们找到解决办法,我们就把它贴回来。
你好,
我们曾经用csv替换所有的用户标签,有没有一种简单的方法来使用csv重写行为?
嗨Beatriz,
不幸的是,通过CSV更新用户只能添加新的用户标签,它不能覆盖现有的用户标签。看到更新现有用户配置文件数据
为了一次批量更新多个用户的用户标签,你需要使用API:创建或更新多个用户
如果你以前没有使用过这个API,下面的介绍可能会对你有所帮助:介绍
那么群体呢?他们没有被提及。
亚博Zendesk Support告诉我,使用这种方法更新组实际上是“不可能的”。如果这不是不可能的(我怀疑是不可能的),你能更新这篇文章,提供一些关于如何导入限制(如组)的更清晰的说明吗?
嘿,CJ,
正确,无法通过CSV批量导入设置座席组。只有两个选项可用于更新用户组:
由于本文专门针对批量导入用户,我认为我们应该创建一篇单独的文章,讨论如何在CSV文件之外批量更新组分配。
感谢您让我们注意到这一点!
嗨CJ约翰逊,
我想我应该提一下我最喜欢的更新座席组的方法之一,就是进入Admin -> Manage -> People,然后选择groups。或者到这里:https://YOURDOMAIN.亚博zendesk.com/agent/admin/people并选择组
选择要更新的Group -然后一直单击屏幕右侧的edit。在这里,您可以简单地选中要添加到组中的代理。
@……
也许这将是好的,删除所有参考文献在这篇文章说,你可以做到这一点?根据文章的评论,这当然是可能的,所以留下它是非常令人困惑的。这个弃用/删除似乎也没有在任何发布说明中提到。
@……
不幸的是,这是不可能的。我不会在每次需要进行大规模更新时手动点击100-200个名字,一是因为这真的很乏味,二是因为这很容易出现人为错误。获得一个CSV导入文件,其中包含失败的CSV导入文件的错误,这是非常非常可取的,尽管考虑到它显然已被删除,并且会覆盖而不是附加组,以前,我也不确定这是否真的满足了我的需求。我可能最终会花一些时间编写一些API脚本来完成这项任务,尽管对于不太懂技术的人来说,它不会很好或容易访问。
这篇文章*仍然*过时,并声称可以使用导入更新组。
嗨,CJ。
感谢你在这里的反馈,我们已经调整了上面代理限制中关于on组的文字,并删除了Devan去年的回复。希望这将使事情变得更清楚(并提供有关如何向组添加代理的一些指导)。
我正在尝试第一次批量导入最终用户数据。存在组织和一些最终用户。最初的批量编辑是在我到达现场之前完成的,这个人已经退休很久了。
以下是我的问题:
CSV字段是否必须按照本文中列出的顺序,或者只是出现在CSV中的某个地方?
标题行可以有首字母大写还是必须小写?
为了打消经理的顾虑:导入CSV文件只会影响到CSV文件中的组织和用户,对吗?
感谢您联系Zendesk!亚博
我们已经对此进行了测试,看起来列的顺序无关紧要,特别是当我们切换Notes和email列时,导入没有任何问题。因此,只要包含所需的列,列的顺序似乎无关紧要。
此外,我们的Notes列在“Notes”中有一个大写的“n”,这也没有影响任何东西。所以这可能意味着头可以大写:)
对于第三个问题,答案是肯定的,组织和用户的导入应该只影响文件中列出的组织和用户。这是假设您正在导入新数据而不是更新数据。例如,如果您已经有100个用户和5个组织,那么导入5个新用户将不会对现有的100个用户产生影响。但是,如果您更新了5个现有组织,那么这可能会影响到链接到随后更新的现有组织的任何链接用户。
希望这能回答你的问题!如果您对上述任何信息需要澄清,请告诉我。
桑尼,
谢谢大家,祝大家新年快乐!
马克
严重的是,
请更新你们的支持。我花了20多分钟跟踪底部,在设置下,然后是客户。不是下面说的。
防止向用户发送欢迎电子邮件
谢谢你的信息。
你好,亚博
我上传了一个CSV来添加最终用户,并且上传成功了。
CSV的一部分是电话号码-添加了国际前缀,但当检查用户时,看起来好像没有添加号码。
有什么问题吗?
嗨丹尼尔
我为你的用例创建了一个票据,这样我们就可以进一步调查你的问题。请检查您的电子邮件,我们可以开始一起工作。谢谢你!
嗨
是否有可能以同样的方式更新门票字段?
你好,
我们计划从另一个客户支持工具切换到Zendesk。亚博导入所有客户对话的最佳方式是什么?我不认为批量进口会对这个起作用。
谢谢!
更新批量票证的最佳选项在批量管理门票.
@Irena,
感谢您考虑使用Zendesk。亚博将信息迁移到Zendesk需要大量的准备工作。亚博我们有所有的迁移选项如何将信息从另一个平台迁移到Zendesk?亚博我们也有亚博Zendesk伙伴 来帮助您完成整个迁移过程。
希望这对你有帮助!
您好-我们正在使用批量导入导入附加到多个公司的用户。
我们有Zendesk的企业版。亚博
然而,当使用批量导入时,它会给出这个错误:
提供了多个组织。只接受一个或一个也不接受。
据我所知,文件格式正确吗?
我们很可能需要查看您引用的文件,看看这里发生了什么。
您可以尝试通过本文中分享的方法联系我们的客户服务团队吗?联系Zendesk客户亚博支持
同时,如果你有任何其他问题,请告诉我!
你好,
我正在更新用户的新邮件,因为我们改变了域名,它的工作就像一个魅力。用户名里面有像“、、”这样的字母呢?在我们的测试中,有一个叫加萨伊坦的用户。如何在CSV文件中解析他?
哦,现在每个人都有一个新的电子邮件地址。目前是@csdps.qc。这是他们的首要任务。如何使新的@cssps.gouv.qc。Ca是主要的?即使它是列表中的第一个,它也只是将其添加为次要的。
如果我用现有组织的域导入用户的电子邮件,它们会自动分配到该组织吗?(如果上面有关于这一点的说明会很有帮助。)
是否有一种方法可以导出所有用户并修改文件以便重新导入?这周末我们要更改域名,我不想手动更改所有的邮件。
恐怕没有本地选项可以导出所有最终用户的CSV文件,除非您有Legacy附加组件客户名单.你可以退房这我们的一个社区管理员在另一个线程中关于用户数据的可用导出选项的评论。您可以以JSON或XML格式导出数据,并将数据转换为CSV,然后编辑CSV文件以匹配用户导入的示例CSV。
对于更新用户,标识符是email。如果你有external_id对于你的用户,你也可以用它作为标识符。
请登录留下评论。