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