快速路径:
“管理中心>人员>批量操作>导入用户”
管理员可以批量导入多个用户，而不是每次手动添加一个用户。为此，您需要创建一个包含用户数据的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必须是唯一的。
- 角色
- 限制
- 组织
- 自定义字段
添加以下用户数据(添加到现有数据中):
- 细节
- 笔记
- 标签
- 电话(作为辅助电话号码添加)
- 电子邮件(作为辅助电子邮件地址添加)
48个评论
这篇文章*仍然*过时，并声称可以使用导入更新组。
你好@……和@……！我正试图删除我们拥有的所有23k终端用户的电话号码。我编写了一个脚本，以便能够遍历用户，如果是电话号码，则提取其用户身份id，然后通过API删除它。然而，我注意到，尽管状态码为204，在许多情况下，我仍然可以从UI看到电话号码，尽管当我通过API查询它时它不再可用。在其他情况下，删除用户标识确实会从UI中删除电话号码。这让我相信，有时电话号码(尚不清楚何时)作为用户标识存储在用户的电话字段中，并且删除用户标识实际上并没有从用户中删除它。很难弄清楚你们实际上是如何存储电话号码的。有没有Zendesk团队的人能给我解释一下如何亚博永久删除电话号码和/或对我们的代理隐藏电话号码?
@……
也许这将是好的，删除所有参考文献在这篇文章说，你可以做到这一点?根据文章的评论，这当然是可能的，所以留下它是非常令人困惑的。这个弃用/删除似乎也没有在任何发布说明中提到。
那么群体呢?他们没有被提及。
你好,
我有一个问题，我想通过批量导入方法创建新用户，
我看到字段:姓名，电子邮件等....
external_id是可选字段还是必选字段?
如果它是必需的领域，我如何得到他们，如果我插入新用户?
严重的是,
请更新你们的支持。我花了20多分钟跟踪底部，在设置下，然后是客户。不是下面说的。
防止向用户发送欢迎电子邮件
迪玛Lazarchuk你应该知道，到目前为止，我们已经多次使用你们的服务进行机票迁移;)，我们将来也会使用你们的服务，因为你们的服务是我们装载新实体流程的一部分我的文章我们想声明，我们希望看到在标准功能中设置语言和时区的功能，而不使用第三方应用/服务。
您好-我们正在使用批量导入导入附加到多个公司的用户。
我们有Zendesk的企业版。亚博
然而，当使用批量导入时，它会给出这个错误:
提供了多个组织。只接受一个或一个也不接受。
据我所知，文件格式正确吗?
亚博Zendesk Support告诉我，使用这种方法更新组实际上是“不可能的”。如果这不是不可能的(我怀疑是不可能的)，你能更新这篇文章，提供一些关于如何导入限制(如组)的更清晰的说明吗?
感谢您联系Zendesk!亚博
我们已经对此进行了测试，看起来列的顺序无关紧要，特别是当我们切换Notes和email列时，导入没有任何问题。因此，只要包含所需的列，列的顺序似乎无关紧要。
此外，我们的Notes列在“Notes”中有一个大写的“n”，这也没有影响任何东西。所以这可能意味着头可以大写:)
对于第三个问题，答案是肯定的，组织和用户的导入应该只影响文件中列出的组织和用户。这是假设您正在导入新数据而不是更新数据。例如，如果您已经有100个用户和5个组织，那么导入5个新用户将不会对现有的100个用户产生影响。但是，如果您更新了5个现有组织，那么这可能会影响到链接到随后更新的现有组织的任何链接用户。
希望这能回答你的问题!如果您对上述任何信息需要澄清，请告诉我。
更新批量票证的最佳选项在批量管理门票。
@Irena,
感谢您考虑使用Zendesk。亚博将信息迁移到Zendesk需要大量的准备工作。亚博我们有所有的迁移选项如何将信息从另一个平台迁移到Zendesk?亚博我们也有亚博Zendesk伙伴 来帮助您完成整个迁移过程。
希望这对你有帮助!
你好,
我们是一家全球性公司，在我们公司中，最终用户的语言默认值为“英语”，时区默认值为“GMT +01:00”。
我们公司在另一个地区收购了一家新公司，我们现在正在替换他们现有的支持工具，并将其迁移到我们基于Zendesk的全球支持平台。亚博
为此，我们需要在导入期间设置语言和时区，因为默认值不适用于新用户。
不幸的是，目前你不能在批量导入中定义语言和时区——在不久的将来有支持这个的计划吗?
如果没有，还有什么其他选择/解决方案?
大家好!我希望得到一些关于通过。csv导入的信息，特别是。
我在Excel中创建了我的列表，并将所有内容格式化(我只导入了姓名、组织、电子邮件和电话)。我使用所需的UTF-8字符编码保存电子表格。
在Admin门户中导入.csv文件之前，我打开该文件以验证将要导入的内容。当我打开它时，“电话”栏缺少所需的国际标准化E.164格式(+)。这可以防止任何电话号码被导入;可能在支持中导致重复。
我的问题是:如何保持所需的国际标准化格式，同时将其保存为所需的UTF-8字符编码?
对于更新用户，标识符是email。如果你有external_id对于你的用户，你也可以用它作为标识符。
@……
不幸的是，这是不可能的。我不会在每次需要进行大规模更新时手动点击100-200个名字，一是因为这真的很乏味，二是因为这很容易出现人为错误。获得一个CSV导入文件，其中包含失败的CSV导入文件的错误，这是非常非常可取的，尽管考虑到它显然已被删除，并且会覆盖而不是附加组，以前，我也不确定这是否真的满足了我的需求。我可能最终会花一些时间编写一些API脚本来完成这项任务，尽管对于不太懂技术的人来说，它不会很好或容易访问。
嗨@……，
电话号码可以存储为直拨线路或共享线路。我们在这里进行更详细的介绍:了解电话号码如何与最终用户档案相关联
然而，我不认为这解决了你所面临的问题，它可能是值得把它纳入一个票找出答案。
我会从我创建的关于你的问题的票中联系你。一旦我们找到解决办法，我们就把它贴回来。
如果我用现有组织的域导入用户的电子邮件，它们会自动分配到该组织吗?(如果上面有关于这一点的说明会很有帮助。)
在所有的文档中，我没有看到它列出你也可以散装船外代理。它可能是隐含的，除了有一个特定的复选框需要被选中，以便这样做(我试图上传一个图像，但得到一个错误，它太大，即使它是35kb和2mb以下)
约瑟夫Prandstetter
我们可以帮助您进行数据迁移。
下面是我们的清单https://www.亚博zendesk.com/marketplace/apps/support/120364/help-desk-migration/
谢谢你的信息。
哦，现在每个人都有一个新的电子邮件地址。目前是@csdps.qc。这是他们的首要任务。如何使新的@cssps.gouv.qc。Ca是主要的?即使它是列表中的第一个，它也只是将其添加为次要的。
不幸的是，我们没有批量导入的选项。您可以研究利用的选项用户密码API。
是否有一种方法，包括在批量上传的密码?作为一名管理员，我发现一个一个地编辑用户非常乏味，因为我们希望他们都有一个特定的密码。
是否可以批量导入贡献者用户?我在上面的任何信息中都找不到这方面的参考——只有“终端用户”、“代理”或“管理员”角色被提到。我尝试过将角色设置为“贡献者”进行导入，但在查看支持中的用户时，该角色默认为最终用户。我可以手动创建一个Contributor用户，所以我不认为这是一个帐户限制。
我们可以为每个人添加第二个电子邮件。现在我的问题是……是否有一种方法可以首先从用户那里删除所有电子邮件，然后导入一个新的主地址?
我们确实添加了一个新的电子邮件，但问题是，电子邮件是不验证我们所有的用户。
如果可能的话，我会在晚上之前完成。
这是可选的。根据文章:
＂如果您有用户电子邮件地址以外的ID(例如员工ID或客户参考号)，则可以包含它。每个用户的外部id必须是唯一的，否则数据将被覆盖。
如果你不启用在CSV输出文件中包含外部ID，外部id将从CSV导入结果文件中排除(参见导入CSV格式的用户数据文件）。＂
顺便说一句，“在CSV输出文件中包含外部ID”现在被称为“在导入结果文件中包含外部ID”。
如果必须使用external_id，请激活在导入结果文件中包含外部id在进行批量导入时。除了用户的电子邮件地址外，组织中的某些人应该知道是否使用外部id来标识用户。
就我个人而言，我没有包括外部id，如果用户批量导入，一切都没问题。
桑尼,
谢谢大家，祝大家新年快乐!
马克
你好,
是否有可用的空模板?可用吗?
谢谢
我们很可能需要查看您引用的文件，看看这里发生了什么。
您可以尝试通过本文中分享的方法联系我们的客户服务团队吗?联系Zendesk客户亚博支持
同时，如果你有任何其他问题，请告诉我!
你好,
是否可以使用“批量导入用户”功能来暂停现有用户?我可以在CSV文件中包含一个列吗?我尝试添加“暂停”列与“true”的值，但是，它没有暂停用户。
谢谢你！
Valeriia
请登录留下评论。