批量检测WhatsApp注册状态，不应只看“把文件传上去、把结果下载下来”两个动作。真正影响结果能否使用的，是原始名单是否留存、号码是否按国家信息规范化、任务选得是否正确、Excel行数是否对得上，以及回填CRM时有没有覆盖许可和历史互动。
流程目标：用WS筛开通回答“本次任务是否返回开通信号”，同时保留每一行的来源、检测日期和异常状态。它不是活跃度检测，也不是营销许可判断。
先定义本次检测要回答什么
| 业务问题 | 对应任务 | Excel字段 | 不能推断 |
|---|---|---|---|
| 号码是否返回开通信号 | WS筛开通 | 手机号、是否开通 | 活跃、回复、许可 |
| 需要活跃度字段 | WS筛活跃度 | 手机号、活跃时间、活跃天数、映射号 | 实时在线 |
| 需要完整支持字段 | WS全类型 | 10类受支持字段 | 客户价值或身份 |
| 只清理格式错误 | 本地规范化 | 错误原因、规范号码 | 平台状态 |
本教程只围绕WS筛开通。把不同任务混在一次验收中，会让CRM字段来源不清，也会让“没有运行”被误读成“没有结果”。
建立批次清单，不直接改原文件
先给批次一个唯一ID，原文件只读保存，工作副本增加行号与联系人ID。这样即使号码重复、Excel排序变化，也能回到来源记录。
| 字段 | 用途 | 保留原因 |
|---|---|---|
| batch_id | 任务唯一编号 | 连接TXT、Excel和导入日志 |
| source_row | 原文件行号 | 定位错误与重复 |
| contact_id | CRM内部ID | 避免只靠手机号关联 |
| phone_raw | 原始号码 | 保留审计依据 |
| country_evidence | 订单或表单国家 | 决定国家码 |
| permission_status | 独立许可记录 | 绝不由筛号覆盖 |
步骤一：按国家证据规范号码
号码应尽量转为带国家码的国际格式。ITU-T E.164国际编号计划提供国际编号计划的标准背景，但转换仍需要可靠国家信息。不要仅凭号码开头、界面语言或销售印象批量补国家码。
- 去除展示用空格、括号和连字符，同时保留原值。
- 把00国际拨号前缀统一为加号表达。
- 根据订单、表单或CRM国家字段确认国家码。
- 把国家未知、长度异常、含字母的行放入异常表。
- 保留重复来源，另建去重视图供任务使用。
步骤二：生成可回溯的TXT
爱普筛WhatsApp（WA/WS）筛号只允许上传TXT，输入应为UTF-8 TXT，一行一个手机号；任务完成后导出Excel。不要上传Excel，也不要把姓名、标签或逗号混进号码行。
| 检查项 | 通过标准 | 失败处理 |
|---|---|---|
| 编码 | UTF-8可正常打开 | 重新导出 |
| 行结构 | 一行一个号码 | 移除表头、逗号和备注 |
| 空行 | 无空白记录 | 清除并重算行数 |
| 批次规模 | 与清单去重数一致 | 先找遗漏和重复 |
| 文件名 | 含batch_id和版本 | 禁止覆盖旧版 |
步骤三：先跑小样本，再跑全量
从正常、重复、不同国家和边界格式中抽取小样本。确认任务选择为WS筛开通，结果确实只有手机号和是否开通等预期字段，再运行全量。小样本的价值是发现格式与字段问题，不是估算全国开通率。
小样本还应包含团队最容易忽略的边界：同一号码出现两次、国家信息缺失、号码前带00、CRM中一个联系人保存多个号码。逐行写下预期处理和实际输出；如果两者不一致，先修正规则和TXT，再生成新版本，而不是在导出的Excel里手工补答案。
步骤四：验收Excel，而不是下载即导入
| 验收指标 | 计算口径 | 异常信号 |
|---|---|---|
| 输入唯一数 | TXT去重有效行 | 与清单不一致 |
| 输出行数 | Excel数据行 | 无解释的少行或多行 |
| 状态覆盖 | 有明确状态行÷输出行 | 大量空值或未知 |
| 号码匹配 | 可回连清单行÷输出行 | 无法关联 |
| 重复输出 | 重复号码组数 | 任务或导入需复核 |
不要擅自把空白、未知、格式错误都填成“未开通”。未知表示目前没有足够结果，未开通是任务给出的状态，两者对后续决策不同。
步骤五：安全回填CRM
| 目标字段 | 写入值 | 更新规则 |
|---|---|---|
| wa_registration_status | 是否开通 | 仅来自WS筛开通 |
| wa_checked_at | 任务完成时间 | 与状态一起更新 |
| wa_check_batch_id | 批次ID | 支持追溯与回滚 |
| wa_check_exception | 未知或匹配失败原因 | 不得强制转否 |
| permission_whatsapp | 原许可记录 | 筛号不得写入 |
| last_reply_at | 真实会话数据 | Excel不得覆盖 |
建议先导入暂存表，以contact_id优先匹配，手机号作为受控备选；生成新增、更新、冲突、未匹配四份差异清单，人工抽样后再合并主表。
抽样不能只挑“已开通”行。至少覆盖已开通、未开通、未知、重复和无法匹配五种状态，并逐项核对原始号码、规范号码、联系人ID和目标CRM字段。若同一联系人存在多个手机号，应先定义主号码与备用号码规则，避免检测结果写错对象。
步骤六：让批次可回滚、可重跑
保存原始文件、规范化清单、最终TXT、原始Excel、导入映射和CRM差异报告。回滚应按batch_id恢复受影响字段，而不是恢复整张联系人表，以免覆盖任务以后产生的新回复或退订。
一份可执行的验收清单
- 任务名称与业务问题一致；
- TXT是UTF-8且一行一个号码；
- 输入、输出、异常和去重数量能闭环；
- Excel原件没有手工改值；
- CRM状态、检测日期和批次ID同时写入；
- 许可、退出和互动字段没有被覆盖；
- 差异报告已抽样，回滚文件可用。
常见问题
导出的Excel能直接群发吗？
不能。它是所选任务的结果，不是许可名单。发送还要检查来源、选择加入、退出、内容和平台规则。
未开通号码应立即删除吗？
先核对格式、国家信息和业务保留规则。可停止将其投入WhatsApp流程，但不要让一次状态检测擅自删除主数据。
多久重跑一次？
没有通用周期。根据数据变化、使用场景和成本制定触发条件，并始终保存checked_at。
一套可靠的WhatsApp批量检测流程，最终交付的不是一列“是/否”，而是一组能解释来源、任务、时间、异常和CRM变化的证据，也能让下一次复检沿用同一口径。
