批量导入用户

我的服务模式是什么？

快速查看：管理中心 > 人员 > 批量操作 > 导入用户

管理员可以通过批量导入添加多个用户，而不是每次手动添加一个用户。为此，您可以创建一个包含用户数据的逗号分隔值 (CSV) 文件。除了基本的用户数据（例如电邮地址和电话号码）之外，您还可以设置用户角色、定义专员的权限，以及将用户添加到组织。您可以使用批量导入来添加新用户或更新现有用户。通过 CSV 文件批量导入仅适用于 Support 用户和用户角色。

只有管理员可以批量导入用户和组织。

重要提示：

• 为了保护 Zendesk 帐户中的数据，默认不启用数据导入。帐户所有者或管理员必须联系 Zendesk 客户支持才能启用数据导出和访问导入页面。
• 如要批量导入用户和组织，必须先导入组织。

本文包含以下部分：

• 批量导入用户和组织的限制
• 创建 CSV 用户数据文件
• 导入 CSV 用户数据文件

批量导入用户的注意事项

在批量导入用户之前，您应查看各种限制和注意事项：

• 批量导入用户和组织的限制
• 更新现有用户个人资料数据
• 决定是否发送电邮给批量导入的用户

批量导入用户和组织的限制

您可以导入关于用户和组织的核心数据集。例如，使用批量导入，您可导入下表中的数据；但是，您无法导入时区、照片、语言首选设置等。要导入下表中未列出的数据，您需要改用 Zendesk REST API。请参阅使用 Zendesk API 导入用户或使用 Zendesk API 导入组织。

批量导入还存在以下限制：

• 最大行数取决于导入方法。
  • 在使用批量操作页面导入新增和现有用户和组织数据时，导入的 CSV 数据文件最多可包含 2,000 行。即 1 个标题行和最多 1,999 行数据。
  • 使用数据导入工具（beta 版）导入新增和现有用户和组织数据时，导入的 CSV 文件大小不能超过 1 GB。我们建议最多 500,000 行，即 1 个标题行和最多 499,999 行数据。此外，每行大小不得超过 128 KB。
• 使用数据导入工具时，还存在以下限制：
  • 导入的 CSV 文件最多可包含 200 列。
  • 导入的 CSV 文件无法保证行的导入顺序。
• 请勿在一个 CSV 文件中包含多个相同的用户或组织，以免导入失败。
• 无法保证记录以其在 CSV 文件中显示的顺序创建或更新。
• 每次只能导入一个 CSV 文件。因此，如果您的数据多于 CSV 文件支持的最大行数，则必须为每个批次单独创建文件，并逐个导入。如果您不使用数据导入工具，则最多允许两个批次在后台排队运行。如果您想导入两个以上的批次，则需等到第一批导入完成后再添加更多批次。
• 您无法使用批量导入从终端用户 Facebook 或 X（以前称为 Twitter）帐户导入联系人信息。请使用 Zendesk REST API。请参阅使用 Zendesk API 导入用户。

更新现有用户个人资料数据

执行批量导入时，您可以更新现有用户。但是请注意，其中有些数据已被替换，而有些数据只是附加在现有数据后。

注意：要更新现有用户，CSV 文件必须包含用户的 external_id 或电邮地址，以便 Zendesk 识别用户。

以下用户数据已被替换：

• 名称
• external_id
• 用户角色
• 限制
• 组织
• 自定义字段

以下用户数据是附加的（添加到现有数据）：

• 详细信息
• 注释
• 标签
• 电话（已添加为次要电话号码）
• 电邮（已添加为次要电邮地址）

决定是否发送电邮给批量导入的用户

批量导入用户之前，请务必检查欢迎电邮设置。通过批量导入添加新用户时，如果您已启用 Guide，每个用户都会收到欢迎电邮。欢迎电邮中包含用于验证用户电邮地址的链接，提示他们选择密码并登录。您可以阻止向这些用户发送欢迎电邮。

防止向用户发送欢迎电邮消息

1. 在管理中心，单击侧栏中的人员图标 ()，然后选择配置 > 终端用户。
2. 在用户欢迎电邮部分，取消选择当专员或管理员创建新用户时也发送验证电邮。

   

3. 单击保存。

创建 CSV 用户数据文件

在创建要导入的用户列表时，您可能会从其他用户管理系统（如员工数据库）生成此列表。大多数此类系统都允许创建 CSV 导出文件。如果您需要从头创建列表，可以使用 Microsoft Excel 或 OpenOffice.org Calc 等程序。

在创建文件时，请记住以下重要事项：

• 文件必须为正确的 CSV 格式，并使用 UTF-8 字符编码保存。
• CSV 文件的第一行是标题行，您必须将其包含在文件中。
• 标题行必须包含下表中的所有必填字段，以及您要包含在下表中的所有其他字段。
• 包含的字段必须以其在下面列出的顺序出现在标题行中。
• 如果您不打算导入字段数据，就不要将其列在标题行中。
• 文件中的空白数据列将覆盖该用户的大部分现有数据。有关例外情况，请参阅更新现有用户个人资料数据。
• 在 Windows 上按 ALT + ENTER，在 Mac 上按 CTRL + OPTION + RETURN，在注释或多行自定义字段中添加换行符。

注意：MSV Excel 不会立即保存您的文件。要保存文件，请将其上传到 Google Sheets，重新下载，然后再上传到 Zendesk。您也可以使用 Open Office 保存文件。

下表列出了可以包含在文件中的字段。导入新用户时，名称、电邮和限制字段都是必填字段。通过批量导入功能更新现有用户时，只需填写一个唯一标识符（例如电邮或外部 ID）。

表 1.用户导入数据

字段	描述
名称	导入新用户时必填。用户的全名。
电邮	导入新用户时必填。用户的完整电邮地址 ([e-mail])。如果一个用户包含多个电邮地址，则用竖线 (|) 分隔。例如：[e-mail]|[e-mail]
external_id	如果您有用户电邮地址以外的 ID（例如员工 ID 或客户参考号），也可以填在此处。每个用户的外部 ID 必须是唯一的，否则数据将被覆盖。 如果您需要为单个用户配置多个电邮地址或电话号码，可以在 CSV 文件中为该用户创建多个条目，并在您希望与该用户关联的所有行中使用相同的 external_id 列。对于每一行，除了额外的电邮或电话号码外，所有其他列中的值应保持一致。 如果任何外部 ID、电邮地址或电话号码与多个现有用户匹配，则该行将被拒绝批量导入。 注意：如果您导入用户时只将 external_id 字段作为其唯一标识符（也就是说不包括电邮地址），您仍需要在 CSV 文件中包括不含任何数据的电邮字段。例如：
详细信息	关于此用户的详细信息，例如地址。此信息仅对团队成员可见，不对终端用户可见。
注释	关于此用户的注释。注释仅对团队成员可见，不对终端用户可见。
phone （非数据导入工具）	用户的电话号码。唯一电话号码将添加为直线。已存在的电话号码将添加为次要线路。要使用 Talk，电话号码应采用国际标准化 E.164 格式。
shared_phone_number （非数据导入工具）	如果这是一个共享电话号码，请设置为“True”。共享电话号码无法用作用户身份。
phones （仅限数据导入工具）	用户的未共享电话号码。唯一电话号码将添加为直线。已存在的电话号码将添加为次要线路。要使用 Talk，电话号码应采用国际标准化 E.164 格式。
shared_phone （仅限数据导入工具）	用户的共享电话号码。要使用 Talk，电话号码应采用国际标准化 E.164 格式。
用户角色	区分大小写：“终端用户”、“专员”或“管理员”。如果不设置用户角色，用户将设置为终端用户。
restriction （非数据导入工具）	限制用于设置团队成员或终端用户的权限、他们可访问的工单等。如果用户的角色设置为专员，则导入新用户时此项必填 在非 Enterprise 服务模式中，支持以下限制值： assigned（已分配），表示工单仅分配给该团队成员 groups（组），表示此团队成员所在组中的工单。注意：要添加团队成员到组，请参阅在组中添加和移除团队成员或使用 Support API。 none（无），这意味着他们没有限制，可以访问所有工单 organization（组织），表示终端用户或团队成员组织中的用户请求的工单 requested（已请求），表示他们自己的工单（请求者是终端用户或团队成员） Light Agent（低权限专员），这意味着用户享有与低权限专员相同的限制。数据导入工具不支持此值。 当用户的角色设置为“终端用户”时，可以向其分配“组织”和“已请求”限制值。 注意：在 Enterprise 服务模式中，专员用户角色会覆盖标准专员限制。这意味着您无法使用上表中列出的任何标准限制来导入或更新专员。您必须指定专员用户角色。如果您不小心使用了 Support 中不存在的用户角色名称，则该用户的角色将默认为低权限专员。
ticket_restriction （仅限数据导入工具）
组织 （非数据导入工具）	用户将被添加到的组织的名称。组织必须已经存在，否则导入将失败。 在 Professional 和 Enterprise 服务模式中，您可以用竖线字符分隔组织名称，从而将用户添加到多个组织。例如：Organization1|Organization2|Organization3 用户的默认组织设置为按字母顺序排列的第一个组织。批量导入期间无法设置不同的默认组织。但是，用户的默认组织可以手动调整，也可以使用 Support API - 将成员身份设置为默认端点进行调整。
organizations （仅限数据导入工具）
tags	当 Zendesk Support 启用用户和组织工单标签时（请参阅添加工单标签和用户到组织），您可以添加用户工单标签。用逗号分隔每个工单标签。
品牌 （非数据导入工具）	如果帐户有多个品牌，您可以指定品牌子域名。您指定的品牌子域名决定着发送给用户的欢迎电邮的品牌，前提是该品牌是活跃的并已启用帮助中心。如果您指定的品牌子域名不是活跃的、没有启用帮助中心或不存在，则该列将被忽略，并使用默认品牌发送欢迎电邮。 仅指定品牌子域名的名称。例如，使用 mydomain 而不是 mydomain.zendesk.com。
custom_fields.<字段键>	在执行批量用户导入时，您可以指定 custom_fields 的前缀和字段键，以导入自定义用户字段。  例如，对于字段键 subscription_date，使用以下内容设置此字段的导入值。 custom_fields.subscription_date 请注意，自定义字段键区分大小写，必须以小写字母输入。 如果您要将信息导入到复选框，请输入“True”将其选中，或输入“False”取消选中。要设置下拉列表选项的值，使用您在创建下拉列表时添加的标签。对于自定义日期字段，使用 YY/MM/DD 或 YYYY-MM-DD 格式。 要查找自定义用户字段的键值： 在管理中心，单击侧栏中的人员，然后选择配置 > 用户字段。最后单击自定义字段的名称。字段键将显示在右侧的属性面板中。 如果字段值的格式不正确，导入将失败，您将收到一条错误报告，说明哪些记录保存失败。 注意：如果要导入的自定义用户字段是查找关系字段，请输入相关对象的 ID 作为此字段的值。例如，对于组织，输入组织的 ID；对于用户，输入用户的 ID；对于自定义对象记录，输入自定义对象记录的 ID。要查找组织、用户或自定义对象记录 ID，您可以从帐户导出数据，或使用组织 API、用户 API 或自定义对象 API。

导入 CSV 用户数据文件

您可以使用批量导入来创建新用户或更新现有用户。

当导入过程完成后，您的导入将被添加到队列中，而用户将被添加到 Zendesk Support。CSV 文件的大小和队列大小决定了每次导入完成所需的时间。

您可以通过以下方式之一批量导入用户：

• 使用数据导入工具导入用户数据
• 使用批量操作导入用户数据

使用数据导入工具导入用户数据

您可以使用数据导入工具导入 CSV 文件，该文件可创建或更新现有用户，并捕获尝试通过数据导入工具页面进行的所有导入的日志。

使用数据导入工具添加或更新用户

1. 在管理中心，单击侧栏中的对象和规则 ()，然后选择工具 > 数据导入工具。
2. 单击导入。
3. 在目标下，选择用户。
4. 在导入类型下，选择以下任一选项：
   • 仅创建：仅添加新用户。CSV 文件中与现有用户相关的所有数据都将被忽略。
   • 仅更新：更新 CSV 文件中列出的现有用户数据。更新用户时，external_id 必填。与新用户相关的所有数据都将被忽略。
   • 创建和更新：添加新用户并更新 CSV 文件中列出的现有用户数据。
   注意：如果任何外部 ID、电邮地址或电话号码与多个现有用户匹配，则该行将被拒绝批量导入。此时，请检查导入历史记录。
5. 在文件上传下，拖放您的文件，或单击以上传并从文件浏览器中选择您的 CSV 文件。

   要更改所选文件，请单击文件名称旁边的删除图标 ()。

6. 单击下一步。
7. 查看字段映射列表。
   • 如果字段映射正确，单击下一步。
   • 如果字段映射不正确，单击上一步。编辑您的 CSV 文件，使其符合格式要求，然后重新上传文件。
8. 在确认对话框中查看导入详情概要，然后单击开始导入。

   导入开始后，无法撤消已导入的更改。要了解导入状态，请查看导入历史记录。

使用批量操作导入用户数据

建议使用数据导入工具，但您仍可以使用批量操作页面导入新增和更新的用户信息。

导入 CSV 用户数据

1. 在管理中心，单击侧栏中的 人员，然后选择批量操作 > 导入用户。
2. 选择导入选项：

   • 创建新用户：此项默认已选择，且无法取消选择。这是因为在 CSV 文件中列出的 Zendesk 帐户中不存在的用户总是会被创建。

   • 更新现有用户：要修改现有用户的数据，请选择此导入选项。

     CSV 文件中必须包含每个用户的 external_id 或电邮地址，以便识别用户。除用户识别字段外，仅包含您要在 CSV 文件中更新的字段。如果您未在 CSV 文件的字段中输入值，则现有用户的该值将被覆盖。请参阅更新现有用户个人资料数据。

     如果任何外部 ID、电邮地址或电话号码与多个现有用户匹配，则该行将被拒绝批量导入。

   注意：如果您不想添加新用户，则必须使用数据导入工具。使用批量操作页面时，如果 CSV 文件包含关于新用户的信息，则无论选择哪个导入选项，始终都会添加这些信息。
3. （可选）选择在 CSV 输出文件中包含外部 ID。

   导入过程完成后，您将收到一封电邮通知，其中包含指向单独的 CSV 导入结果文件的链接。使用此链接下载文件并查看导入结果。此文件会显示您尝试导入的用户数据的状态（已创建、已更新、已跳过）。如果选择此选项，报告将包含已创建或更新的每个用户的电邮地址或外部 ID。

   如果不选择此选项， CSV 导入结果文件将不包含外部 ID。对于已创建或更新的每个用户，仅列出用户自己的电邮地址。

4. 单击以下选项之一：选择文件或让我粘贴数据。
5. 单击导入。

当导入过程完成后，您的导入将被添加到队列中，而用户将被添加到 Zendesk Support。导入完成后您会收到一封电邮。