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

您可以通过导入 CSV（逗号分隔的值）文件批量添加多个组织，而不是一次添加一个组织。您可以使用批量导入来添加组织或更新组织。您必须是管理员才能批量导入组织。您还可以一次添加或更新多个用户和多个自定义对象记录。

注意：如果您要批量导入组织和用户，您必须先批量导入组织。如需了解有关批量导入用户的信息，请参阅批量导入用户。

批量导入组织操作不可撤消。在导入包含您所有组织信息的 CSV 文件之前，用单个组织记录测试同一个 CSV 文件，以确保上传正常。

本文章包含以下部分：
  • 使用数据导入工具批量导入组织
  • 批量导入组织（旧版）

使用数据导入工具批量导入组织

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

请参阅以下主题：
  • 使用数据导入工具批量导入的限制
  • 创建 CSV 组织数据文件
  • 使用数据导入工具导入组织

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

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

要批量导入组织，您将使用 CSV 组织数据文件。本节将讨论如何设置 CSV 数据文件。

在创建文件时，请记住以下重要事项：
  • 文件必须为正确的 CSV 格式，并使用 UTF-8 字符编码保存。
  • CSV 文件的第一行是标题行。
  • 标题行必须包含下表中的所有必填字段，以及您要包含在下表中的所有其他字段。
  • 在标题行中，使用 domain_names 或 default，具体取决于您的导入方法。它们不能一起使用。
  • 如果您不打算为某个字段导入数据，请不要将其列在标题行中。
  • 文件中的空白数据列将覆盖该组织的任何现有数据。
  • 按 ALT + ENTER (Windows) 或 CTRL + OPTION + RETURN (macOS) 可在注释或多行自定义字段中添加换行符。
下表列出了可以包含在文件中的字段。
表格 1：组织导入数据
字段 描述
名称 必填。组织名称。
external_id 选填，但建议填写；如果您打算以后使用数据导入工具更新这些记录，则为必填。唯一标识值，例如外部系统中的员工或客户标识号。
注释 关于组织的注释。注释仅对专员可见，不会对终端用户可见。
domain_names 关于该组织的详细信息，例如地址。此信息仅对专员可见，不会对终端用户可见。使用数据导入工具时使用，取代默认标头。
组 输入组织的默认组。请参阅映射组到组织
tags 当 Zendesk Support 启用用户和组织标签时，您可以为组织设置标签。每个标签以竖线字符 (|) 分隔。

当批量导入组织时，您的 CSV 文件中的标签将替换现有的组织标签。要避免这种情况，请使用标签 API 来更新标签。
organization_fields.<字段键值> 执行批量组织导入时，您可以通过指定 organization_fields. 前缀和字段键值导入自定义组织字段。 

例如，对于字段键值 subscription_date，使用以下内容设置此字段的导入值。

organization_fields.subscription_date

要查找组织字段的字段键，请参阅查找自定义字段的字段键或字段 ID。

如果字段值格式不正确，导入将失败，您将在导入历史记录日志中看到错误详情。对于自定义日期字段，使用 YY/MM/DD 或 YYYY-MM-DD 格式。对于复选框字段，使用 True 或 False。要设置下拉字段的值，使用您在创建下拉列表时添加的标签。

注意：在数据导入工具页面上导入组织时，不支持“查找关系”字段。

请参阅为组织添加自定义字段。

使用数据导入工具导入组织

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

当导入过程完成后，您的导入将被添加到队列中，而组织将被添加到 Zendesk Support。每个文件大约需要一个小时才能完成，但这取决于文件大小和队列大小。

使用数据导入工具创建或更新组织
  1. 在管理中心，单击侧栏中的对象和规则 ()，然后选择工具 > 数据导入工具。
  2. 单击导入。
  3. 在目标下，选择组织。
  4. 在导入类型下，选择以下任一选项：
    • 仅创建：仅创建新组织。CSV 文件中与现有组织相关的所有数据都将被忽略。
    • 仅更新：替换 CSV 文件中列出的现有组织的数据。更新组织时，external_id 必填。与新组织相关的所有数据都将被忽略。
    • 创建和更新：创建新组织，并更新 CSV 文件中现有组织的数据。
  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 导入用户

创建 CSV 组织数据文件

要批量导入组织，您将使用 CSV 组织数据文件。本节将讨论如何设置 CSV 数据文件。

在创建文件时，请记住以下重要事项：
  • 文件必须为正确的 CSV 格式，并使用 UTF-8 字符编码保存。
  • CSV 文件的第一行是标题行。
  • 标题行必须包含下表中的所有必填字段，以及您要包含在下表中的所有其他字段。
  • 在标题行中，使用 domain_names 或 default，具体取决于您的导入方法。它们不能一起使用。
  • 如果您不打算为某个字段导入数据，请不要将其列在标题行中。
  • 文件中的空白数据列将覆盖该组织的任何现有数据。
  • 按 ALT + ENTER (Windows) 或 CTRL + OPTION + RETURN (macOS) 可在注释或多行自定义字段中添加换行符。
下表列出了可以包含在文件中的字段。
表格 2.组织导入数据
字段 描述
名称 必填。组织名称。
external_id 选填，但建议填写；如果您打算以后使用数据导入工具更新这些记录，则为必填。唯一标识值，例如外部系统中的员工或客户标识号。
注释 关于组织的注释。注释仅对专员可见，不会对终端用户可见。
默认 这是用于将用户映射到组织。输入一个或多个电邮域名，以空格分隔（例如 organization1.com organization2.com）。不使用数据导入器时使用，取代 domain_names 标头。

请参阅根据用户的电邮域名自动将其添加到组织。
已分享 True 或 False。将组织设置为共享组织。

请参阅为终端用户设置共享组织
shared_comments True 或 False。允许此组织内的所有用户互相评论工单。共享字段也必须设置为 true。

请参阅为终端用户设置共享组织
组 输入组织的默认组。请参阅映射组到组织
标签 当 Zendesk Support 启用用户和组织标签时（请参阅添加标签和用户到组织），您可以为组织设置标签。用空格分隔每个标签。

当批量导入组织时，您的 CSV 文件中的标签将替换现有的组织标签。要避免这种情况，请使用标签 API 来更新标签。
custom_fields.<字段键值> 执行批量组织导入时，您可以通过指定 custom_fields 前缀和字段键值导入自定义组织字段。 

例如，对于字段键值 subscription_date，使用以下内容设置此字段的导入值。

custom_fields.subscription_date

要查找自定义组织字段的字段键，请参阅查找自定义字段的字段键或字段 ID。

如果字段值的格式不正确，导入将失败，您将收到一条错误报告，说明哪些记录保存失败。对于自定义日期字段，使用 YY/MM/DD 或 YYYY-MM-DD 格式。对于复选框字段，使用 True 或 False。要设置下拉列表选项的值，使用您在创建下拉列表时添加的标签。

注意：如果要导入的自定义组织字段是查找关系字段，请输入相关对象的 ID 作为该字段的值。例如，对于组织，输入组织的 ID；对于用户，输入用户的 ID；对于自定义对象记录，输入自定义对象记录的 ID。要查找组织、用户或自定义对象记录 ID，您可以从帐户导出数据，或使用组织 API、用户 API 或自定义对象 API。

在数据导入工具页面上导入组织时，不支持“查找关系”字段。

请参阅为组织添加自定义字段。

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

建议使用数据导入工具，但您仍可以使用批量操作页面导入新增和更新的组织数据。当导入过程完成后，您的导入将被添加到队列中，而组织将被添加到 Zendesk Support。每个文件大约需要一个小时才能完成，但这取决于文件大小和队列大小。

从此页面导入完成时，您将收到一封电邮。

使用 CSV 导入创建或更新组织
  1. 在管理中心，单击侧栏中的人员 ()，然后选择批量操作 > 导入组织。
  2. 选择您要执行的导入类型：

    • 创建新组织

    • 更新现有的组织：使用此类型的导入以替换 CSV 文件中列出的组织现有数据。

      组织的 external_id 或名称必须包含在 CSV 中，以便识别。除了组织标识符字段之外，您只需在文件中包含您要更新的字段。如果组织的行有空白字段，它将覆盖该组织的现有数据。

  3. 单击选择文件或粘贴数据链接。
  4. 单击导入。

    导入开始后，无法撤消已导入的更改。

  5. （可选）在管理中心 > 对象和规则 > 工具 > 数据导入工具页面查看正在进行的导入状态。导入完成后，可在该页面上的“导入历史记录”日志中找到。

由 Zendesk 提供技术支持