指南

导入数据

适用角色与场景

当团队已经在 Excel 或 CSV 中积累了客户、联系人或商机资料时，可以用导入向导一次性创建多条 CRM 记录。导入向导会先读取文件，再让你确认字段映射、修正具体值，最后生成预览并提交后台任务。

导入适合迁移一批已经整理过的数据，也适合先用少量真实记录验证字段设计。它不是“把任意表格原样复制进 CRM”：每一列都需要明确对应到哪个对象字段，无法确认含义的列应跳过或先创建合适的自定义属性。

当前支持的范围

当前向导可以将文件导入为以下三种对象：

客户：公司或组织级记录。
联系人：个人记录，可以通过关系字段关联到客户。
商机：具体销售机会，可以通过关系字段关联到客户或联系人。

文件格式支持 CSV、.xlsx 和 .xlsm，文件不能超过 10 MB。导入向导当前执行的是“仅新增”流程：如果一行数据根据唯一匹配字段命中已有记录，该行会在预览中标记为跳过，不会更新已有记录。

导入不会自动创建客户、联系人或商机的关联对象。关系列必须能够匹配到工作空间中已经存在的记录；未匹配的关系值需要在校验步骤中选择已有记录、跳过该关系值，或修正原始文件后重新导入。

推荐流程

准备文件

每行代表一条目标记录

先确定文件要创建哪一种对象，再让每一行代表一条该对象记录。例如：

客户文件：一行代表一家公司。
联系人文件：一行代表一个人，并准备一列用于关联客户。
商机文件：一行代表一个商机，并准备客户或联系人关系列。

不要把客户、联系人和商机混在同一张表里期待系统自动拆分。需要导入多种对象时，分别准备文件，并先导入能够被其他对象引用的客户记录。

保留可以识别记录的字段

为了让你能检查重复和关系匹配，每条记录至少应保留一个稳定的识别信息：

客户通常使用公司名称或网站。
联系人通常使用邮箱、电话或姓名。
商机通常使用商机名称。

如果文件中有产品的 Record ID，也可以使用 Record ID。不要把每次导出时都会变化的行号、排序编号或临时序号当作唯一识别字段。

清理会影响校验的值

导入前建议完成以下检查：

删除空行、测试行和明显重复行。
统一邮箱、电话、网站和日期的写法。
去掉密码、验证码、访问令牌等不应进入 CRM 的内容。
检查表头是否唯一、是否位于正确的行。
保留原始文件副本，不要直接覆盖唯一版本。
先用一小批真实数据试导入，再处理完整历史库。

导入向导的五个步骤

向导按以下顺序处理文件：上传文件 → 映射列 → 校验值 → 预览导入结果 → 执行导入。

1. 上传文件

打开产品中的导入入口，选择 CSV 或 Excel 文件，也可以把文件拖入上传区域。上传后系统会读取表头和数据行，并显示文件列的示例值。

如果表头不在第一行，打开行设置，填写正确的“列头行”和“数据起始行”，再重新读取文件。数据起始行必须晚于列头行；调整行设置会重新解析当前文件，之前的列映射需要重新确认。

上传阶段只创建一个导入草稿和文件快照，不会创建客户、联系人或商机。文件读取失败时，先检查扩展名、文件是否为空、表头行是否正确以及文件大小。

2. 映射列

在“映射列”页面，每一行对应文件中的一列。左侧可以看到文件列名和示例值，右侧选择 CRM 的目标字段。系统可能根据列名和示例值预填映射，但预填结果仍需要人工检查。

每列可以做三种处理：

映射：把文件列写入当前对象的普通字段或自定义字段。
关系：把文件中的名称、邮箱、网站等值解析为已存在的关联记录。
跳过：明确确认这列不导入。跳过不会删除文件中的数据，也不会创建字段。

如果一列包含业务信息但当前对象没有合适字段，工作空间管理员可以在映射页面创建自定义属性，再把该列映射到新属性。创建属性只改变字段配置；它不会替你确认每一行的数据是否正确。

关系列应该怎样映射

关系列不能只选择“客户”或“联系人”，还要选择用于匹配的唯一字段。例如，联系人文件中的“客户网站”可以映射到“所属客户”，并选择客户的网站作为匹配字段；联系人邮箱则应映射到联系人相关字段并使用邮箱匹配。

选择匹配字段时，以源数据的真实含义为准：

文件里是公司名称，就选择客户名称。
文件里是公司网站或域名，就选择客户网站。
文件里是联系人邮箱，就选择邮箱。
文件里是产品 Record ID，才选择 Record ID。

不要因为 Record ID 在列表中靠前，就把它当成所有关系列的默认匹配字段。匹配值不稳定或一列混用了名称、域名和备注时，关系解析很容易产生阻断问题。

映射完成前检查三件事

必填字段已经映射到有实际值的文件列。
同一个目标字段没有被多列重复映射。
所有不导入的列都已经明确选择“跳过”。

点击下一步后，系统会保存目标对象、字段映射和唯一匹配字段，并进入值校验。此时仍然没有写入 CRM。

3. 校验值

“校验值”会按当前字段定义检查文件中的实际值，而不只是检查列名。页面会显示阻断问题、警告和每个已映射列的状态。

常见问题包括：

必填字段为空。
数字、日期、日期时间、链接或列表值格式不正确。
单选或多选值不在当前字段选项中。
负责人值无法匹配到工作空间成员。
关系字段找不到对应的客户、联系人或商机。
同一目标字段被重复映射。

对于重复出现的值，页面会按源文件列聚合展示。你可以直接修正某个值、将该值标记为跳过，或在关系字段中搜索并选择已有记录。保存后系统会重新校验，不要只修改页面上的输入框而不保存。

关系值未匹配时，先确认原始值是否有空格、大小写、域名或名称差异；仍然无法判断时，不要随意选择相似记录。选择错误的客户会让后续沟通、任务和商机都出现在错误的对象下。

只有阻断问题全部解决后，才能生成可提交的预览。警告不一定阻止提交，但应在预览前确认它不会造成空值、错误关联或不符合团队约定的数据。

4. 预览导入结果

点击“预览导入结果”后，系统会按当前映射和校验结果计算每一行将发生什么。预览会区分新增、跳过、阻断和警告，并显示汇总数量和行级状态。

预览是提交前的检查步骤，不等于已经导入。此时 CRM 中不会因为预览而新增记录；如果返回“仍有阻断问题”，请回到“校验值”处理后重新生成预览。

重点检查：

计划新增数量是否与文件中真正需要创建的记录数量接近。
因命中已有记录而跳过的行是否符合预期。
联系人和商机是否关联到了正确的客户。
负责人、阶段、金额、日期等关键字段是否显示为正确值。
警告和跳过行是否有业务上不能接受的情况。

如果发现映射错误，返回“映射列”调整字段，或返回“校验值”修正具体值，再重新预览。不要在预览不可信时直接执行导入。

5. 执行导入

确认预览后点击“执行导入”。这一步才会启动真实的后台导入任务，按行执行权限检查、查重和 CRM 写入。执行页会显示排队、成功、失败和跳过等行级状态，并在任务运行期间刷新结果。

提交后不要再次点击执行，也不要用同一文件连续创建多个导入任务。需要停止仍可取消的任务时，从导入任务或结果入口发起取消；已经进入不可取消或终态的任务，只能等待当前结果收敛。

导入完成后验收

不要只看“任务已启动”。任务结束后，在结果页检查：

成功、失败、跳过数量与预览和文件行数是否能对应起来。
随机打开几条客户、联系人或商机，确认关键字段已经写入。
检查联系人所属客户、商机所属客户或联系人关系。
检查负责人、阶段、金额、日期和自定义属性。
如果有失败行，点击“下载失败数据”，按失败原因修正原文件。

失败行适合用于定位和重新整理，不建议未经检查就把整份原文件重新提交。当前向导以创建为主，重复提交同一批数据可能造成不必要的重复记录；重新导入前先确认哪些行已经成功、哪些行确实需要重新处理。

为什么这样做

导入是批量写入，错误映射或关系匹配会同时影响多条记录。按照“先定义对象 → 准备文件 → 映射字段 → 校验实际值 → 预览 → 执行 → 抽查”的顺序，可以在写入前发现大多数问题。

当前向导执行“仅新增”流程，并且不会自动创建缺失的关联对象。因此，先导入客户、再导入联系人和商机，比把多种对象混在一个文件中更容易验证和追溯。

最佳实践

示例：导入联系人并关联客户

假设你有一份联系人表：

姓名	邮箱	职位	客户网站
李明	liming@example.com	技术负责人	example.com

可以按以下方式完成：

选择“联系人”作为导入对象。
将“姓名”“邮箱”“职位”映射到联系人字段。
将“客户网站”映射到联系人的客户关系字段。
在关系设置中选择“客户网站”作为关联客户的唯一匹配字段。
在“校验值”中确认 example.com 能匹配到工作空间中已有客户。
对未匹配值逐条选择正确客户、跳过该关系，或修正文件后重新上传。
预览确认新增数量和关联关系后，再执行导入。
任务完成后打开联系人详情，检查联系人所属客户和邮箱是否正确。

如果客户还不存在，应先导入客户文件或在 CRM 中创建客户，再导入联系人。导入联系人不会因为关系列找不到客户而自动创建客户。

安全和质量建议：

不要上传密码、验证码、访问令牌或与导入无关的敏感信息。
先用少量真实记录试导入，再处理完整历史库。
保留原始文件、预览结果和失败行，便于追溯。
对负责人、阶段、金额、日期和关系字段进行抽样检查。
只重新提交确认失败且已经修正的行，不要盲目重复完整文件。

常见错误

为什么我导入后已有记录没有被更新？

当前向导是“仅新增”流程。命中唯一匹配字段的已有记录会被标记为跳过，不会更新。需要修改已有资料时，应在 CRM 中编辑，或使用当前产品明确提供的其他更新入口；不要把“导入”理解为批量更新。

为什么文件列没有自动映射？

自动映射只是根据列名和当前对象字段目录给出的初始建议。列名含义不明确、字段不存在、字段不可编辑或数据类型不匹配时，需要手动选择目标字段、创建自定义属性或明确跳过。

为什么关系字段一直提示未匹配？

检查三点：关联对象是否已经存在、源值是否与所选唯一字段完全对应、关系列是否混用了不同格式。名称、网站、邮箱和 Record ID 不能互相替代；确认不清时选择已有记录或修正文件，不要凭相似名称猜测。

为什么预览通过后还要等待？

预览只计算计划结果，不执行写入。点击“执行导入”后，任务还要在后台完成逐行校验和写入，因此结果可能先显示排队或导入中，再逐步变为成功、失败或跳过。

导入失败后应该怎么做？

先在结果页查看失败原因并下载失败数据，再针对失败行修正格式、必填字段或关系值。保留原文件和第一次结果，修正后用一份新的、范围明确的文件重试，不要盲目重复提交完整文件。

看不到导入入口怎么办？

导入入口、可配置字段和创建自定义属性受当前工作空间能力与成员权限影响。请让工作空间管理员确认入口是否开放，以及你是否有目标对象和字段配置权限。