1
功能概述
企微联系人导入页用于把企业微信成员批量加入系统微信池。页面先在浏览器中读取 Excel 并展示预览，点击“立即导入”后会按手机号匹配企业微信成员，再保存为系统中的企微客服微信。
核心规则：当前批量导入页面以手机号码为导入入口。手机号必须能在所选企业微信通讯录中找到对应成员，否则该行会失败并继续处理后续行。如果只有企业微信账号或邮箱，请回到“客服微信设置”使用“添加微信”单个添加。
2
入口与界面
在客服微信设置的批量上传面板中点击“Excel批量导入企业联系人”，系统完成权限校验后自动进入本页。请从系统入口进入，以确保企业微信、项目、分组和权限信息正确加载。
图 1 · 生产环境导入企微联系人页面
下载模板
点击“模板”下载 contacts.xlsx，按模板整理企微成员资料。
打开 Excel 文件
选择或拖入文件后，页面会解析表头和数据，并在下方表格中预览。
确认手机号与归属信息
确认手机号码列、归属项目、企业微信、微信分组和启用状态。
立即导入
系统逐行查找企业微信成员并保存，失败行会提示原因，后续行继续处理。
3
模板与文件要求
| 项目 | 说明 |
|---|---|
| 模板地址 | 页面“模板”按钮下载 https://res.jvser.com/docs/contacts.xlsx。 |
| 支持格式 | .xls、.xlsx、.xlsb、.csv。 |
| 表头识别 | 系统会在前 200 行中寻找非空列最多的一行作为表头，并最多扫描 500 列。 |
| 数据清洗 | 单元格会自动去除首尾空格，末尾过于稀疏的空行会被移除。 |
| 多 Sheet | 打开文件后可切换不同 Sheet，每个 Sheet 会单独识别表头和字段映射。 |
导入前提：所选企业微信必须授权有效，并且通讯录权限、手机号可见性、成员实名认证状态都可能影响导入结果。
4
字段映射说明
| 字段 | 是否必填 | 自动识别表头 | 保存规则 |
|---|---|---|---|
| 手机号码 | 必填 | 手机、手机号、手机号码、Mobile、PhoneNumber | 用于匹配企业微信成员账号；手机号格式不正确会失败。 |
| 昵称 | 可选 | 昵称、NickName | 非空时写入昵称；为空时系统会尝试从企业微信成员资料补充名称。 |
| 手机编号 | 可选 | 备注名称、微信手机、RemarkName、手机编号 | 非空时写入备注名称。 |
| QQ号码 | 可选 | 非空时写入绑定 QQ。 | |
| 备注 | 可选 | 描述、说明、注释、Remark、description、备注 | 非空时写入备注。 |
| 启用状态 | 必选 | 页面选择 | 控制新导入成员是否启用，以及是否覆盖已存在成员状态。 |
| 归属项目 | 必填 | 页面选择 | 决定新导入企微联系人的归属项目。 |
| 企业微信 | 必填 | 页面选择 | 决定通过哪一个企业微信应用查找成员并生成联系人资料。 |
| 微信分组 | 必填 | 页面选择 | 当前页面提交前会校验必须选择微信分组。 |
5
启用状态规则
| 选项 | 新联系人 | 已存在联系人 | 适用场景 |
|---|---|---|---|
| 始终启用 | 导入后启用 | 更新为启用 | 批量上线一批企微联系人。 |
| 始终禁用 | 导入后禁用 | 更新为禁用 | 先导入资料，暂不参与分配或展示。 |
| 启用新微信，忽略已存的微信 | 导入后启用 | 保留原启用状态 | 只希望控制新增成员，不影响已有成员状态。 |
| 禁用新微信，忽略已存的微信 | 导入后禁用 | 保留原启用状态 | 先沉淀新增成员资料，已有成员继续按原状态运行。 |
6
导入执行逻辑
- 点击“立即导入”前，必须先打开 Excel 文件，并选择手机号码列、企业微信、归属项目和微信分组。
- 系统通过手机号匹配企业微信成员账号，再以企业微信账号或手机号查找系统中是否已存在。
- 不存在时会新增一条企微联系人，写入企业微信、项目、分组、手机号、昵称、QQ、备注等信息。
- 已存在时会更新非空字段；启用状态是否覆盖取决于所选启用状态规则。
- 昵称为空时，系统会尝试从企业微信成员资料补充名称和二维码。
- 联系人二维码为空时，系统会尝试创建或关联企业微信联系我二维码，并尝试创建获客助手配置。
- 单行失败会提示手机号和失败原因，然后继续处理下一行。
常见企微错误：
46004 表示指定用户不存在，40098 表示成员尚未实名认证。7
常见问题
为什么提示“指定的用户不存在”？
通常是手机号不在所选企业微信通讯录中，或选择了错误的企业微信应用。先确认手机号、企业微信归属和成员授权范围。
企微联系人没有手机号，能用邮箱批量导入吗？
当前批量导入页不支持用邮箱列批量匹配成员，只支持按手机号列导入。如果成员没有手机号，可在“客服微信设置”点击“添加微信”，选择企业微信主体后，在“账号／邮箱”中填写企业微信账号或邮箱进行单个添加。
为什么提示“成员尚未实名认证”？
企业微信接口返回成员实名认证状态不满足要求。需要在企业微信侧完成成员实名或调整成员资料后再导入。
为什么已存在联系人状态被改变？
选择“始终启用”或“始终禁用”会覆盖已存在联系人的启用状态；如果不想影响已有联系人，请选择“启用新微信，忽略已存的微信”或“禁用新微信，忽略已存的微信”。
8
注意事项
- 导入前确认企业微信授权有效，并确认通讯录接口可根据手机号查到成员。
- 本页说明的是 Excel 批量导入限制，不代表系统只能用手机号添加企微联系人；单个添加可使用企业微信账号或邮箱。
- 同一批导入建议使用同一个项目、企业微信和分组，避免手动选择时混淆。
- 如果只想补充资料，不想改变已有联系人的启用状态，请使用“忽略已存的微信”的两个选项。
- 导入后回到企微联系人或微信池列表，按手机号、企业微信和分组筛选确认结果。