管理员可以通过批量导入添加多个用户,而不是每次手动添加一个用户。为此,您可以创建一个包含用户数据的逗号分隔值 (CSV) 文件。除了基本的用户数据(例如电邮地址和电话号码)之外,您还可以设置用户角色、定义专员的权限,以及将用户添加到组织。您可以使用批量导入来添加新用户或更新现有用户。通过 CSV 文件批量导入仅适用于 Support 用户和用户角色。
只有管理员可以批量导入用户和组织。
- 为了保护 Zendesk 帐户中的数据,默认不启用数据导入。帐户所有者或管理员必须联系 Zendesk 客户支持才能启用数据导出和访问导入页面。
- 如要批量导入用户和组织,必须先导入组织。
批量导入用户的注意事项
批量导入用户和组织的限制
您可以导入关于用户和组织的核心数据集。例如,使用批量导入,您可导入下表中的数据;但是,您无法导入时区、照片、语言首选设置等。要导入下表中未列出的数据,您需要改用 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 导入用户。
更新现有用户个人资料数据
以下用户数据已被替换:
- 名称
- external_id
- 用户角色
- 限制
- 组织
- 自定义字段
以下用户数据是附加的(添加到现有数据):
- 详细信息
- 注释
- 标签
- 电话(已添加为次要电话号码)
- 电邮(已添加为次要电邮地址)
创建 CSV 用户数据文件
在创建要导入的用户列表时,您可能会从其他用户管理系统(如员工数据库)生成此列表。大多数此类系统都允许创建 CSV 导出文件。如果您需要从头创建列表,可以使用 Microsoft Excel 或 OpenOffice.org Calc 等程序。
- 文件必须为正确的 CSV 格式,并使用 UTF-8 字符编码保存。
- CSV 文件的第一行是标题行,您必须将其包含在文件中。
- 标题行必须包含下表中的所有必填字段,以及您要包含在下表中的所有其他字段。
- 包含的字段必须以其在下面列出的顺序出现在标题行中。
- 如果您不打算导入字段数据,就不要将其列在标题行中。
- 文件中的空白数据列将覆盖该用户的大部分现有数据。有关例外情况,请参阅更新现有用户个人资料数据。
- 在 Windows 上按 ALT + ENTER,在 Mac 上按 CTRL + OPTION + RETURN,在注释或多行自定义字段中添加换行符。
下表列出了可以包含在文件中的字段。导入新用户时,名称、电邮和限制字段都是必填字段。通过批量导入功能更新现有用户时,只需填写一个唯一标识符(例如电邮或外部 ID)。
字段 | 描述 |
---|---|
名称 | 导入新用户时必填。用户的全名。 |
电邮 |
导入新用户时必填。用户的完整电邮地址 (someuser@mycompany.com)。如果一个用户包含多个电邮地址,则用竖线 (|) 分隔。例如:first@yourcompany.com|second@yourcompany.com
|
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 服务模式中,支持以下限制值:
当用户的角色设置为“终端用户”时,可以向其分配“组织”和“已请求”限制值。
注意:在 Enterprise 服务模式中,专员用户角色会覆盖标准专员限制。这意味着您无法使用上表中列出的任何标准限制来导入或更新专员。您必须指定专员用户角色。如果您不小心使用了 Support 中不存在的用户角色名称,则该用户的角色将默认为低权限专员。
|
ticket_restriction (仅限数据导入工具) |
|
组织 (非数据导入工具) |
用户将被添加到的组织的名称。组织必须已经存在,否则导入将失败。 在 Professional 和 Enterprise 服务模式中,您可以用竖线字符分隔组织名称,从而将用户添加到多个组织。例如: 用户的默认组织设置为按字母顺序排列的第一个组织。批量导入期间无法设置不同的默认组织。但是,用户的默认组织可以手动调整,也可以使用 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 格式。 要查找自定义用户字段的键值:
如果字段值的格式不正确,导入将失败,您将收到一条错误报告,说明哪些记录保存失败。 |
导入 CSV 用户数据文件
您可以使用批量导入来创建新用户或更新现有用户。
当导入过程完成后,您的导入将被添加到队列中,而用户将被添加到 Zendesk Support。CSV 文件的大小和队列大小决定了每次导入完成所需的时间。
使用数据导入工具导入用户数据
您可以使用数据导入工具导入 CSV 文件,该文件可创建或更新现有用户,并捕获尝试通过数据导入工具页面进行的所有导入的日志。
- 在管理中心,单击侧栏中的对象和规则 (),然后选择工具 > 数据导入工具。
- 单击导入。
- 在目标下,选择用户。
- 在导入类型下,选择以下任一选项:
- 仅创建:仅添加新用户。CSV 文件中与现有用户相关的所有数据都将被忽略。
- 仅更新:更新 CSV 文件中列出的现有用户数据。更新用户时,external_id 必填。与新用户相关的所有数据都将被忽略。
- 创建和更新:添加新用户并更新 CSV 文件中列出的现有用户数据。
注意:如果任何外部 ID、电邮地址或电话号码与多个现有用户匹配,则该行将被拒绝批量导入。此时,请检查导入历史记录。 - 在文件上传下,拖放您的文件,或单击以上传并从文件浏览器中选择您的 CSV 文件。
要更改所选文件,请单击文件名称旁边的删除图标 ()。
- 单击下一步。
- 查看字段映射列表。
- 如果字段映射正确,单击下一步。
- 如果字段映射不正确,单击上一步。编辑您的 CSV 文件,使其符合格式要求,然后重新上传文件。
- 在确认对话框中查看导入详情概要,然后单击开始导入。
导入开始后,无法撤消已导入的更改。要了解导入状态,请查看导入历史记录。
使用批量操作导入用户数据
建议使用数据导入工具,但您仍可以使用批量操作页面导入新增和更新的用户信息。
- 在管理中心,单击侧栏中的 人员,然后选择批量操作 > 导入用户。
- 选择导入选项:
-
创建新用户:此项默认已选择,且无法取消选择。这是因为在 CSV 文件中列出的 Zendesk 帐户中不存在的用户总是会被创建。
-
更新现有用户:要修改现有用户的数据,请选择此导入选项。
CSV 文件中必须包含每个用户的 external_id 或电邮地址,以便识别用户。除用户识别字段外,仅包含您要在 CSV 文件中更新的字段。如果您未在 CSV 文件的字段中输入值,则现有用户的该值将被覆盖。请参阅更新现有用户个人资料数据。
如果任何外部 ID、电邮地址或电话号码与多个现有用户匹配,则该行将被拒绝批量导入。
注意:如果您不想添加新用户,则必须使用数据导入工具。使用批量操作页面时,如果 CSV 文件包含关于新用户的信息,则无论选择哪个导入选项,始终都会添加这些信息。 -
- (可选)选择在 CSV 输出文件中包含外部 ID。
导入过程完成后,您将收到一封电邮通知,其中包含指向单独的 CSV 导入结果文件的链接。使用此链接下载文件并查看导入结果。此文件会显示您尝试导入的用户数据的状态(已创建、已更新、已跳过)。如果选择此选项,报告将包含已创建或更新的每个用户的电邮地址或外部 ID。
如果不选择此选项, CSV 导入结果文件将不包含外部 ID。对于已创建或更新的每个用户,仅列出用户自己的电邮地址。
- 单击以下选项之一:选择文件或让我粘贴数据。
- 单击导入。
当导入过程完成后,您的导入将被添加到队列中,而用户将被添加到 Zendesk Support。导入完成后您会收到一封电邮。