我的服务模式是什么？
Suite，所有版本 Team、Growth、Professional、Enterprise 或 Enterprise Plus
Support Team、Professional 或 Enterprise

已验证人工智能概要 ◀▼

管理员可使用 CSV 文件批量导入用户数据，以添加或更新用户信息，包括用户角色和组织成员身份。导入之前，请确保已启用数据导入，并首先导入了组织。请注意限制，例如每个文件最多 2,000 行，以及无法导入某些数据类型。考虑您的欢迎电邮设置来管理新用户的通知。

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

Zendesk 建议使用 数据导入工具 导入用户数据，而不是使用本文所述的旧版批量操作页面。但是，如果您愿意，仍然可以使用批量操作页面导入新增或更新的用户信息。

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

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

重要提示：
  • 为了保护 Zendesk 帐户中的数据，默认不启用数据导入。帐户所有者或管理员必须联系 Zendesk 客户支持才能启用数据导出和访问导入页面。
  • 如要批量导入用户和组织，必须先导入组织。
本文章包含以下部分：
  • 批量导入用户的注意事项（旧版）
  • 创建 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，在注释或多行自定义字段中添加换行符。
注意：Microsoft Excel 无法立即保存您的文件。要保存文件，请将其上传到 Google Sheets，重新下载，然后再上传到 Zendesk。您也可以使用 Open Office 保存文件。

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

表 1.用户导入数据
字段 描述
名称 导入新用户时必填。用户的全名。
电邮 导入新用户时必填。用户的完整电邮地址 (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 启用用户和组织标签时（请参阅将标签和用户添加到组织），您可以添加用户标签。用逗号分隔每个工单标签。
brand 如果帐户有多个品牌，您可以指定品牌子域名。您指定的品牌子域名决定着发送给用户的欢迎电邮的品牌，前提是该品牌是活跃的并已启用帮助中心。如果您指定的品牌子域名不是活跃的、未启用帮助中心或不存在，则该列将被忽略，并使用默认品牌发送欢迎电邮。品牌子域名区分大小写，必须完全匹配才能导入。

仅指定品牌子域名的名称。例如，使用 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。

使用批量操作导入用户数据（旧版）

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

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

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

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

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

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

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

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

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

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

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

翻译免责声明：本文章使用自动翻译软件翻译，以便您了解基本内容。 我们已采取合理措施提供准确翻译，但不保证翻译准确性

如对翻译准确性有任何疑问，请以文章的英语版本为准。

由 Zendesk 提供技术支持