What's my plan?
All Suites Team, Growth, Professional, Enterprise, or Enterprise Plus
Support Team, Professional, or Enterprise

已验证人工智能概要 ◀▼

管理员可通过创建包含用户数据（例如用户角色和组织详细信息）的 CSV 文件批量导入用户数据。此方法可以高效添加或更新用户。确保 CSV 文件格式正确，同时考虑到文件大小和数据字段等限制。如果您不希望在导入过程中发送欢迎邮件，请记得调整电邮设置。

位置：管理中心 > 对象和规则 > 工具 > 数据导入工具

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

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

重要提示：
  • 为了保护 Zendesk 帐户中的数据，默认不启用数据导入。帐户所有者或管理员必须联系 Zendesk 客户支持才能启用数据导出和访问导入页面。
  • 如要批量导入用户和组织，必须先导入组织。
本文章包含以下部分：
  • 使用数据导入工具批量导入用户
  • 批量导入用户（旧版）

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

数据导入工具提供了一种统一方法来导入用户、组织和自定义对象，是执行此类操作的理想选择。

请参阅以下主题：
  • 批量导入用户的注意事项
  • 创建 CSV 用户数据文件
  • 使用数据导入工具导入用户数据

批量导入用户的注意事项

在批量导入用户之前，您应查看各种限制和注意事项：
  • 使用数据导入工具批量导入的限制
  • 更新现有用户个人资料数据
  • 决定是否发送电邮给批量导入的用户

使用数据导入工具批量导入的限制

您可以导入关于用户和组织的核心数据集。要导入下表中未列出的数据，您必须改用 Zendesk REST API。请参阅使用 Zendesk API 导入用户。

  • 使用数据导入工具时，导入的 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 识别用户。
数据导入工具如何更新数据
使用数据导入工具时，仅附加以下用户数据（添加到现有数据）：
  • 电话（已添加为次要电话号码）
  • 电邮（已添加为次要电邮地址）

所有其他数据将由数据导入工具替换。

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

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

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

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

  3. 单击保存。

创建 CSV 用户数据文件

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

在创建文件时，请记住以下重要事项：
  • 您可以在管理中心 > 数据导入工具 > 导入 >下载 CSV 模板下载 CSV 模板。
  • 文件必须为正确的 CSV 格式，并使用 UTF-8 字符编码保存。
  • CSV 文件的第一行是标题行，您必须将其包含在文件中。
  • 标题行必须包含下表中的所有必填字段，以及您要包含在下表中的所有其他字段。
  • 包含的字段必须以其在下面列出的顺序出现在标题行中。
  • 如果您不打算导入字段数据，就不要将其列在标题行中。
  • 文件中的空白数据列将覆盖该用户的大部分现有数据。有关例外情况，请参阅更新现有用户个人资料数据。
  • 在 Windows 上按 ALT + ENTER，在 Mac 上按 CTRL + OPTION + RETURN，在注释或多行自定义字段中添加换行符。
注意：MSV Excel 不会立即保存您的文件。要保存文件，请将其上传到 Google Sheets，重新下载，然后再上传到 Zendesk。您也可以使用 Open Office 保存文件。

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

表 1.用户导入数据
字段 描述
name 导入新用户时必填。用户的全名。
emails 导入新用户时必填。用户的完整电邮地址 (someuser@mycompany.com)。如果一个用户包含多个电邮地址，则用竖线 (|) 分隔。例如：first@yourcompany.com|second@yourcompany.com
ticket_restriction 导入新用户时必填。限制用于设置团队成员或终端用户的权限、他们可访问的工单等。如果用户角色设置为“专员”，则导入新用户时此项必填。
在非 Enterprise 服务模式中，支持以下限制值：
  • 分配：团队成员只能访问分配给他们的工单。
  • 组：团队成员只能访问其组内的工单。要添加团队成员到组，请参阅查看和管理团队成员的组成员身份或使用 Support API。
  • 无：该用户没有限制，可访问所有工单。
  • 组织：用户仅可访问其自己或其组织中其他用户请求的工单。
  • 所请求的：用户只能访问自己的工单。他们必须被列为工单的请求者。
当用户角色设置为“终端用户”时，可以分配组织和已请求的限制值。所有其他仅适用于团队成员。
注意：在 Enterprise 服务模式中，专员用户角色会覆盖标准专员限制。这意味着您无法使用上表中列出的任何标准限制来导入或更新专员。您必须指定专员用户角色。如果您不小心使用了 Support 中不存在的用户角色名称，则该用户的角色将默认为低权限专员。
external_id 如果您有用户电邮地址以外的 ID（例如员工 ID 或客户参考号），也可以填在此处。每个用户的外部 ID 必须是唯一的，否则数据将被覆盖。

如果您需要为单个用户配置多个电邮地址或电话号码，可以在 CSV 文件中为该用户创建多个条目，并在您希望与该用户关联的所有行中使用相同的 external_id 列。对于每一行，除了额外的电邮或电话号码外，所有其他列中的值应保持一致。

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

注意：如果导入用户时只将 external_id 字段作为其唯一标识符（即同时不添加电邮地址），则仍需要在没有数据的 CSV 文件中添加电邮字段。例如：
details 关于此用户的详细信息，例如地址。此信息仅对团队成员可见，而对终端用户不可见。
notes 关于此用户的注释。注释仅对团队成员可见，不对终端用户可见。
电话 用户的电话号码。唯一电话号码将添加为直线。已存在的电话号码将添加为次要线路。要使用 Zendesk，电话号码应采用国际标准化 E.164 格式。
shared_phone 用户的共享电话号码。要使用 Zendesk，电话号码应采用国际标准化 E.164 格式。
role 区分大小写：终端用户或专员。如果不设置用户角色，用户将设置为终端用户。
custom_role 当用户角色设置为“专员”时，可以指定自定义用户角色名称（如管理中心的 用户角色页面所列）。也接受低权限专员。
skip_verify_email 如果您需要创建用户而不发送验证电邮，请将此值设置为 true。
time_zone 由字符串组成，例如“东部时间（美国和加拿大）”。有关有效名称的列表，请查看管理中心的本地化页面（帐户 > 外观 > 本地化）上的时区列表菜单。例如：如果菜单列出“(GMT+02:00) 柏林”，则使用“柏林”作为 time_zone 名称。
区域设置 用户的区域设置。用于区域设置的 BCP-47 标准标签（例如 en-US）。如果区域设置和 locale_id 同时存在，则 locale_id 将被忽略，仅使用 区域设置。
local_id 用户的语言标识符。
维护者 布尔值。指定用户是否具有论坛审阅功能。
only_private_comments 布尔值。当设置为 true 时，用户只能创建私密评论。
remote_photo_url 指向用户个人资料图片的 URL。
签名 用户的签名。只有专员和管理员可以有签名。
被阻止 布尔值。表示用户是否被阻止。来自被阻止用户的工单也将被阻止，这些用户无法登录终端用户门户。
别名 向终端用户显示的别名。
organizations 用户将被添加到的组织的名称。组织必须已经存在，否则导入将失败。

在 Professional 和 Enterprise 服务模式中，您可以用竖线字符分隔组织名称，从而将用户添加到多个组织。例如：Organization1|Organization2|Organization3

用户的默认组织设置为按字母顺序排列的第一个组织。批量导入期间无法设置不同的默认组织。但是，用户的默认组织可以手动调整，也可以使用 Support API - 将成员身份设置为默认端点进行调整。
default_group_id

新团队成员（管理员和专员）将自动添加到帐户的默认组中。但是，您可以使用此字段在批量导入期间为用户指定替代默认组。

终端用户无法添加到组。
tags 当 Zendesk Support 启用用户和组织标签时（请参阅将标签和用户添加到组织），您可以添加用户标签。用逗号分隔每个工单标签。
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 文件，该文件可创建或更新现有用户，并捕获尝试通过数据导入工具页面进行的所有导入的日志。

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

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

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

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

批量导入用户（旧版）

如果出于某种原因未使用数据导入工具，请参阅以下主题：
  • 批量导入用户的注意事项（旧版）
  • 创建 CSV 用户数据文件
  • 使用批量操作导入用户数据（旧版）

批量导入用户的注意事项（旧版）

批量导入用户和组织的限制（旧版）

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

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

批量操作导入如何更新数据

当使用旧版批量操作页面导入用户数据时，以下用户数据将被替换：
  • name
  • 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）。

表格 2.用户导入数据
字段 描述
名称 导入新用户时必填。用户的全名。
电邮 导入新用户时必填。用户的完整电邮地址 (someuser@mycompany.com)。电邮字段接受空白值或空值。如果电邮字段为空白或为空，系统仍会创建用户个人资料。
restriction 导入新用户时必填。限制用于设置团队成员或终端用户的权限、他们可访问的工单等。如果用户的角色设置为专员，则导入新用户时此项必填
在非 Enterprise 服务模式中，支持以下限制值：
  • 分配：团队成员只能访问分配给他们的工单。
  • 组：团队成员只能访问其组内的工单。注意：要添加团队成员到组，请参阅查看和管理团队成员的组成员身份或使用 Support API。
  • 无：该用户没有限制，可访问所有工单。
  • 组织：用户仅可访问其自己或其组织中其他用户请求的工单
  • 所请求的：用户只能访问自己的工单。他们必须被列为工单的请求者。
  • （不是数据导入工具）低权限专员：该用户的限制与低权限专员相同。
当用户的角色设置为“终端用户”时，可以向其分配“组织”和“已请求”限制值。所有其他仅适用于团队成员。
注意：在 Enterprise 服务模式中，专员用户角色会覆盖标准专员限制。这意味着您无法使用上表中列出的任何标准限制来导入或更新专员。您必须指定专员用户角色。如果您不小心使用了 Support 中不存在的用户角色名称，则该用户的角色将默认为低权限专员。
external_id 如果您有用户电邮地址以外的 ID（例如员工 ID 或客户参考号），也可以填在此处。每个用户的外部 ID 必须是唯一的，否则数据将被覆盖。

如果您需要为单个用户配置多个电邮地址或电话号码，可以在 CSV 文件中为该用户创建多个条目，并在您希望与该用户关联的所有行中使用相同的 external_id 列。对于每一行，除了额外的电邮或电话号码外，所有其他列中的值应保持一致。

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

注意：如果您导入用户时只将 external_id 字段作为其唯一标识符（也就是说不包括电邮地址），您仍需要在 CSV 文件中包括不含任何数据的电邮字段。例如：
details 关于此用户的详细信息，例如地址。此信息仅对团队成员可见，不对终端用户可见。
notes 关于此用户的注释。注释仅对团队成员可见，不对终端用户可见。
电话 用户的电话号码。唯一电话号码将添加为直线。已存在的电话号码将添加为次要线路。要使用 Zendesk，电话号码应采用国际标准化 E.164 格式。
shared_phone_number 如果这是一个共享电话号码，请设置为“True”。共享电话号码无法用作用户身份。
用户角色 区分大小写：终端用户、专员或管理员。如果不设置用户角色，用户将设置为终端用户。
organization 用户将被添加到的组织的名称。组织必须已经存在，否则导入将失败。

在 Professional 和 Enterprise 服务模式中，您可以用竖线字符分隔组织名称，从而将用户添加到多个组织。例如：Organization1|Organization2|Organization3

用户的默认组织设置为按字母顺序排列的第一个组织。批量导入期间无法设置不同的默认组织。但是，用户的默认组织可以手动调整，也可以使用 Support API - 将成员身份设置为默认端点进行调整。
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 用户数据
  1. 在管理中心，单击侧栏中的人员 ()，然后选择批量操作 > 导入用户。
  2. 选择导入选项：

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

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

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

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

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

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

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

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

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

由 Zendesk 提供技术支持