如果你正在找“WhatsApp筛号API”，先确认业务究竟需要实时接口，还是需要把一批号码可靠地筛选后回填系统。爱普筛当前不提供本文旧版本所描述的直接API接入，目前采用TXT上传、任务处理、Excel导出的方式。保留这个页面，是为了给API搜索用户一个准确答案，并提供可实际执行的文件集成方案。
先判断：你需要API还是批处理
| 业务情形 | 更适合的方式 |
|---|---|
| 每周或每月整理一次历史名单 | TXT与Excel批处理 |
| 单次号码多，但允许任务完成后集中回填 | TXT与Excel批处理 |
| 用户操作时必须实时返回结果 | 需要真正API，当前流程不适用 |
| 需要Webhook、自动重试或严格延迟承诺 | 需要先确认API能力和SLA |
WhatsApp批量筛号的实际工作流
- 从CRM导出具有合法来源的号码，并保留内部客户ID与同意记录；
- 标准化国家代码、去重，把手机号单独生成TXT；
- 根据问题选择WS筛开通、精筛开通、筛活跃、筛头像、筛性别年龄或全格式；
- 任务完成后下载对应Excel；
- 验证表头、行数与异常结果，再按手机号回填CRM；
- 保存批次、检测时间和服务名称，支持以后复核。
WS任务与Excel字段映射
- WS筛开通：手机号、是否开通。
- WS精筛开通：手机号、商业号、WhatsApp映射手机号。
- WS筛活跃：手机号、活跃时间、活跃天数、WhatsApp映射手机号。
- WS筛头像：手机号、商业号、头像、WhatsApp映射手机号。
- WS筛性别年龄：手机号、年龄、性别、头像、WhatsApp映射手机号。
- WS全格式：在活跃、画像、头像等维度上输出完整支持字段。
“全格式”并不意味着任何企业都应该收集全部字段。数据最小化的原则是：只选择当前业务问题需要的任务，避免为了“以后可能用”而增加敏感画像数据。
怎样把TXT与Excel接进系统
生成任务文件
由CRM或数据仓库生成两个文件：内部映射表保存record_id与标准化手机号；上传TXT只保存手机号。这样既满足一行一号，也能在导出后恢复企业内部对应关系。
导入前校验
为每种服务建立允许的表头清单，检查重复号码、空行、异常格式和未知状态。若导出列与任务不符，停止导入并人工确认，而不是把第三列默认当成活跃天数。
保留审计字段
在企业系统中增加checked_at、service_type、source_batch和result_status。筛选结果可能随时间变化，检测日期应与结果一起保存。
筛号与WhatsApp发消息是两套规则
某号码被标记为已开通，并不代表可以向其发送营销信息。WhatsApp官方商业消息政策要求企业获得用户提供的手机号和后续沟通同意，并尊重拒收。官方也说明，未经授权的大规模消息可能导致服务访问受限。请参考WhatsApp Business Messaging Policy。
评估集成是否成功
不要只看“本次筛了多少号码”。更有意义的指标包括：格式异常率、结果匹配率、未知率、重复导入率、人工复核时间，以及授权名单中的有效回复、退订和投诉变化。若回填后无法解释某列来自哪个任务，说明流程仍需调整。
具体服务可查看WhatsApp筛号产品页；需要完整操作示例，可阅读WhatsApp开通与活跃筛选指南。如果项目明确要求实时API，请在开发前向客服核实当前能力，不要把文件批处理当成实时接口。
