企业搜索“WhatsApp筛号API”，很多时候并不是一定要实时接口，而是希望把号码清洗、WS筛选和CRM回填做成稳定流程。爱普筛当前不提供直接API：输入仅支持TXT文件，每行一个手机号；任务完成后导出对应服务的Excel。本篇重点讲怎样把这套文件流程接入企业内部数据治理。
先定义这条流程要解决什么
一条可用的号码清洗流程至少要回答：号码来自哪个业务系统、是否有权处理、采用哪种WS任务、结果如何与原记录匹配、异常由谁复核。若只把号码导出再导入，却没有批次和字段定义，即使以后换成API，同样会出现错列、重复和无法追踪的问题。
建议使用三张逻辑表
| 逻辑表 | 保留内容 | 作用 |
|---|---|---|
| 任务主表 | batch_id、服务、提交时间、负责人 | 追踪每次筛选 |
| 号码映射表 | record_id、标准化手机号、来源 | 连接CRM与导出结果 |
| 结果表 | 手机号、原始结果、checked_at | 保留每次检测快照 |
上传TXT中不要加入record_id、姓名或备注；这些字段留在内部映射表。这样既符合一行一号，也减少向任务文件放入无关信息。
从CRM生成TXT
- 筛选具有明确来源和处理依据的记录；
- 统一国家代码，清理空格、括号、短横线与说明文字；
- 保留标准化前后的号码，方便回查；
- 去重时记录被合并的record_id，不直接删除关系；
- 导出UTF-8 TXT，不加表头，每行一个号码。
根据问题选择WS任务
- 只判断开通：WS筛开通，字段为手机号、是否开通。
- 需要商业号与映射号码：WS精筛开通。
- 需要活动时间信号：WS筛活跃。
- 需要头像：WS筛头像。
- 确有画像用途：WS筛性别年龄。
- 需要多维组合字段：再评估WS全格式。
不同服务的Excel字段不同，导入程序必须按service_name加载对应数据字典，不能固定读取“第二列是开通、第三列是活跃”。
Excel回填的5个校验
- 表头是否与所选服务一致；
- 导出手机号能否与映射表匹配；
- 重复号码是否产生冲突结果；
- 未知、空值和异常是否被保留；
- 同一批次重复导入是否会生成重复记录。
推荐把结果作为有时间戳的快照，而不是覆盖客户主表。号码和账号状态可能变化，保留历史才能解释不同日期的差异。
与另一篇API文章怎样分工
本文解决的是CRM数据表、批次和回填治理；WhatsApp筛号API与批处理选择侧重判断何时文件流程够用、何时必须寻找实时接口。两个页面都明确：当前爱普筛是TXT到Excel，不把人工批处理宣传成API。
权限与合规边界
限制谁能导出号码、上传任务和下载结果；制定文件保存期限；保留退出名单。WhatsApp开通或活跃结果不等于用户同意接收消息。官方商业消息政策要求企业获得相应同意并尊重拒收，筛选只用于有权处理的名单整理。
具体字段可在WhatsApp筛号服务页核对。企业流程成熟的标志不是标题中出现“API”，而是每个号码、批次、字段和异常都有清楚去向。
