从Excel导入好友

功能教程：从 Excel 导入好友

一、功能概述

“从 Excel 导入好友”功能允许您通过标准格式的 Excel 文件（.xlsx），批量将联系人数据导入到系统中，实现对好友资料的统一管理、补充或修正。

与“从微信导入好友”功能不同，此功能不需要微信客户端在线或执行自动化操作，更适用于以下场景：

• 将从其他CRM或系统导出的客户名单批量录入。
• 将手动整理好的联系人资料（如线下收集的名片信息）快速导入系统。
• 对系统中已存在的联系人批量补充或更新信息（如统一添加标签、修正称呼）。

二、如何找到入口？

您可以在工作台 (Workspace)​ 中找到此功能的入口：

• 当左侧好友列表为空时，点击 “从 Excel 导入好友”​ 按钮。
• 在好友列表工具栏中，点击 “导入”​ 按钮，然后在下拉菜单中选择 “从 Excel 导入好友”。

点击后，会弹出 “联系人 Excel 导入”​ 对话框，请按其中的步骤顺序操作即可。

三、操作步骤详解

1. 下载 Excel 模板 点击对话框顶部的 “下载 Excel 模板 / 导出现有联系人”​ 链接，下载名为 Excel导入模板.xlsx的文件。模板中包含预定义的列，是成功导入的关键。 模板列说明（带 * 为必填）： 列名说明必填微信号​联系人的微信号，作为唯一标识✅昵称​微信昵称✅备注在微信中给对方的备注名—标签联系人标签，多个用英文逗号分隔，如 客户,VIP—称呼如“张总”、“李女士”—地区所在地区—说明额外的备注说明—手机号手机号—重要提示：
   • 微信号​ 和 昵称​ 是必填项，缺少任意一项的行将被跳过，不予导入。
   • 如果 Excel 中存在重复的微信号，系统将以最后一条数据为准。
   • 非必填列可以根据您的需要直接删除，不会影响导入。
2. 选择导入策略 您需要决定当Excel中的数据与系统中现有数据冲突时如何处理。 策略说明适用场景
   • 合并（推荐）​对比微信号判断是否存在。已存在则用Excel数据更新对应字段；不存在则新增联系人。绝大多数情况，安全且常用。
   • 覆盖​已存在的联系人，强制以Excel数据完全替换系统中该联系人的所有字段（Excel中没有的列，系统对应字段会被清空）。需要完全用一份新的Excel数据替换掉旧系统数据时。
   • 慎用！​跳过​已存在的联系人完全跳过，只导入系统中不存在的新联系人。需要严格保留系统中原有联系人的数据不被任何修改。
   • 合并 vs 覆盖的核心区别示例：假设系统中某联系人有“说明”字段内容为“老客户”，但您上传的Excel模板中删除了“说明”列。采用“合并”策略，系统中该联系人的“说明”会保留“老客户”；采用“覆盖”策略，该联系人的“说明”字段将被清空。
3. 按示例填写 Excel 点击对话框中的 “按示例填写 Excel”​ 链接，可以查看详细的填写格式示意图，确保您的数据格式正确。
4. 上传 Excel 文件 将填写好的 Excel 文件拖拽到上传区域，或点击上传区域选择文件。
   • 仅支持 .xlsx格式（新版Excel）。如果是旧版 .xls文件，请先在Excel软件中“另存为” .xlsx格式后再上传。
   • 上传后系统会自动校验表头，必须包含“微信号”和“昵称”列，否则会提示错误。
5. 预览数据 上传成功后，对话框下方会显示 Excel 文件前 10 行数据的预览表格。请利用此功能核查数据格式（如标签分隔符是否正确）是否正确。 预览仅用于快速检查，实际导入将处理文件中的所有有效行。
6. 开始导入 点击 “开始导入”​ 按钮。系统将执行以下操作：
   • 将文件上传至服务器临时目录。在后台启动一个异步导入任务 (ExcelContactImportTask)。逐行解析 Excel 文件，并按照您选择的策略（合并/覆盖/跳过）将数据写入本地数据库。每处理5条记录或任务结束时，通过SSE事件向“任务中心”推送实时进度。导入完成后自动清理服务器上的临时文件。

四、在任务中心查看进度

在任务中心，您可以查看导入任务的状态：

• 运行中：正在处理。
• 已完成：所有行处理完毕。
• 已停止：被手动停止。
• 导入失败：发生异常（如文件损坏、数据库错误）。

进度条会显示 已处理行数 / 总行数（不包含表头和被跳过的空行）。

五、重要注意事项

1. 任务独占：同一个微信实例同时只能运行一个导入任务。如果已有任务在运行，再次提交会收到409错误提示。
2. 文件格式：仅支持 .xlsx格式，请务必转换 .xls文件。
3. 容错处理：单行数据写入失败（如数据格式错误）不会导致整个任务中断，系统会跳过该行继续处理后续行。
4. 标签自动创建：如果Excel中填写的标签在系统中尚不存在，系统会自动创建这些新标签并关联给对应的联系人，无需您提前手动创建。
5. 慎用“覆盖”策略：该策略会强制用Excel数据替换所有字段，可能导致您系统中原有的、但Excel中未包含的字段信息被清空，请确认后再使用。

---

为本文生成的SEO元信息：

• SEO描述 (Description): 本文详细指导如何使用Excel文件批量导入微信好友到客户管理系统。内容涵盖模板下载、必填字段说明、合并/覆盖/跳过三大导入策略的区别与选择、完整操作步骤，以及任务监控和重要注意事项，帮助您高效、准确地完成联系人数据迁移。
• SEO关键词 (Keywords): Excel导入好友， 批量导入联系人， Excel模板， 导入策略， 合并覆盖跳过， 微信号导入， 联系人管理， 数据迁移， 任务中心， .xlsx格式