WhatsApp 联系人与分组操作指南：CSV 批量导入字段映射、标签筛选与归档恢复管理

概览

联系人是工作区的通讯录 — 每个你能触达的人，包含姓名、手机号、邮箱、语言、分组与内部备注。分组则是你整理联系人的细分集合（VIP 客户、新注册、弃购客户等），用于把广播、WhatsApp 营销活动、商品目录发送与流程注册精准投放到正确的受众。

从顶部导航的 Contacts 进入。页面左侧是视图与分组筛选栏，上方是四格统计卡片，中间是可切换列表/网格的搜索式联系人表格。同一页面的 Groups 视图列出所有分组及其实时成员数。每位联系人还有对应的 360 详情页，汇总其标签、活动时间线、商机、订单与生命周期价值（LTV），可从群成员、账号通讯录等入口打开。

按工作区共享：联系人与分组属于工作区，而不是创建它们的个人。唯一例外是工作区机制上线前导入的历史记录 — 在重新导入前，它们仅对原所有者可见。

前置条件

联系人不需要外部凭据 — 你可以立即开始添加。以下几点决定你能容纳多少联系人、以及能对它们做什么：

套餐上限：如果工作区已达到联系人数上限，添加或导入联系人会被阻止，直到升级套餐或删除部分联系人。检查会在创建联系人之前、导入开始之前执行。

添加联系人

1. 点击右上角的 Add contact 打开联系人弹窗。
2. 至少填写名字与手机号（仅有的必填字段）。
3. 可选填写称谓、中间名、姓氏、国家代码、邮箱、语言、一个或多个分组、标签、地址、内部备注与头像图片。
4. 点击保存。联系人会出现在表格顶部（最新在前）。

字段参考

显示名如何拼装：填写了完整的 Name 字段时以它为准；否则 WAthink 把存在的 title、first name、middle name 与 last name 用空格拼接。保存时 WAthink 还会按号码自动识别国家 / 地区，并在列表中显示国旗与本地化国名。

从 CSV 导入联系人

点击 Bulk upload 导入 CSV 文件。WAthink 采用先预览、后确认的两步流程，避免盲目导入。

操作步骤

1. 选择文件。选择 .csv 文件（最大 5 MB）。
2. 核对自动映射。WAthink 读取表头行，自动识别各列对应的字段，并显示前 5 行数据供你确认映射是否正确。
3. 设置「应用到所有行」默认值（可选）。选择 Status、Source、Group 与 Tags，应用到每一行导入数据（各字段如何保存见下表）。
4. 导入。再次提交文件。每个有效行都会成为联系人，并返回汇总："Imported N contacts (M skipped)"（导入 N 位，跳过 M 位）。

列自动识别

表头名称在匹配前会先规范化 — 转为小写并去掉所有非字母数字字符 — 因此 Phone Number、phone_number 与 PHONE-NUMBER 都会解析到同一字段。第一个匹配某个字段的表头生效。系统识别以下名称：

行处理规则

• 没有姓名或没有手机号的行会被跳过，跳过数量会在汇总中报告。
• 导入时，导入的 name 会同时存为全名与名字；如需拆分姓氏，请映射 last name 列。
• CSV 的 Group 列可以用逗号分隔多个分组名。名称对工作区已有分组做大小写不敏感匹配；尚不存在的分组会自动创建并归属当前工作区。
• CSV 自带的分组列优先；「应用到所有行」的分组作为兜底合并，确保联系人至少归入该分组。
• 去重更新：号码与已有联系人相同（按国家代码 + 号码规范化后比较）时不会重复创建，而是更新该联系人的姓名、邮箱等字段，因此重复导入同一份 CSV 是安全的。
• 国家与语言：导入时按号码自动识别国家 / 地区；「按识别到的国家自动补全语言」默认勾选，CSV 中显式填写的语言优先。

「应用到所有行」各开关的作用

文件要求：仅支持 CSV，最大 5 MB。手机号请使用带国家代码的国际格式，连接后即可直接发送。导入开始前会检查联系人数上限 — 已达上限的工作区会被阻止。

分组（细分）

分组是切分受众的方式。点击 New group 创建。

1. 为分组设置名称（必填）。
2. 可选添加备注并选择颜色。
3. 保存。分组会出现在左侧栏与 Groups 视图中，并显示实时成员数。

• 切换到 Groups 视图可查看所有分组及当前成员数。
• 编辑分组可重命名、修改备注或颜色。
• 删除分组会先把它从所有联系人上移除，再删除分组本身。联系人保留 — 只是不再属于该分组。

分组为什么重要：广播、WhatsApp 营销活动、商品目录发送与流程注册都按分组定位受众。成员数始终实时计算，因此始终准确，不会过期。标签（Tags）与分组互补：标签可跨分组灵活标记，支持批量打标签 / 去标签，并可在联系人列表按标签过滤。

搜索、筛选与统计

联系人表格自带以下控件：

• 搜索：按姓名、邮箱或手机号搜索 — 输入即实时过滤。
• 侧栏视图：All contacts、Groups、Imported（通过 CSV 导入的联系人）与 No group（不属于任何分组的联系人）。
• 分组筛选：点击左侧栏任意分组，只显示其成员。
• 标签筛选：点击任意标签即可筛选该标签下的联系人；批量栏支持为所选联系人打标签 / 去标签。
• 国家 / 语言筛选：按识别到的国家与语言过滤联系人。
• 列表 / 网格切换：在紧凑列表与卡片网格之间切换。
• 导出与去重：工具栏的 Export all 按当前筛选导出 CSV；Remove duplicates 一键清理同一号码的重复联系人，保留最早的一条。

顶部统计行始终显示四个工作区范围的计数：

编辑、删除与回收站

每行都有编辑图标（在弹窗中打开联系人）与删除图标（会先要求确认）。要一次删除多位，勾选复选框后使用 Delete selected。

1. 编辑：打开行、修改任意字段并保存。添加联系人中的显示名拼装与国家代码补全规则同样适用于更新。
2. 单个删除：点击删除图标并确认。
3. 批量删除：选择多行后点击 Delete selected。

删除会先归档，而不是立即抹除。单个与批量删除都只作用于当前工作区，因此不可能删到其他工作区的联系人。删除会把联系人移入回收站（Recycle bin）；在保留期（默认 30 天，以部署配置为准）内你可以从回收站恢复，也可以选择立即清除（purge）。清除后资料才真正删除。已归档联系人不再出现在选择器、分组或营销活动受众中，但收件箱中的历史会话仍会保留。

故障排查

账号通讯录与反写

除了工作区共享的系统联系人（CRM），每个已连接账号还有一份属于它自己的 WhatsApp 通讯录。两者分开管理：系统联系人是工作区的客户资料；账号通讯录是某个账号在 WhatsApp 侧保存的联系人快照。账号通讯录页面按账号分别浏览，不会把不同账号的通讯录混在一起。

拉取账号通讯录在用户界面统一称为「同步」：

• 同步 WhatsApp 联系人：针对一个明确的已连接账号，把该账号实际保存的通讯录拉取到工作区；一次同步只针对一个账号，不跨账号批量采集。
• 最近同步任务：任务区显示每次同步的状态与结果，成功与失败分开呈现，以该账号实际返回的内容为准。
• 自动同步：连接后、重连后或定时的自动运行由系统管理员在管理端配置，普通用户端不提供开关或停止操作。

导入映射（账号通讯录 → 系统联系人）

可以把账号通讯录中的联系人导入为系统联系人：先做字段映射与预览，确认后再执行。导入按规范化手机号去重 — 命中已有系统联系人时原地更新并关联身份，不会重复创建；同一号码在不同账号下分别保存，系统不会仅凭号码猜测合并跨账号身份。

导出

账号通讯录与同步结果支持导出为 CSV、XLSX 或 VCF；导出范围跟随当前筛选与账号权限，文件在本地生成。

写进 WhatsApp 通讯录（反写批次）

反写把工作区选定的联系人号码写回某个账号的 WhatsApp 通讯录，按批次执行，全程可追溯：

范围提醒：反写只作用于所选账号的 WhatsApp 通讯录，不批量发送消息，也不改变系统联系人资料。执行前请再次核对目标账号与号码集合。

相关页面：WhatsApp 号码检测 — 在反写前先检测号码的注册与在线状态；地图获客 — 把公开线索转为系统联系人后再导入或反写。