使用场景指南
安全清洗 WhatsApp 联系人名单的流程
联系人清洗不只是给每行号码打勾。可靠流程应保留来源数据、规范号码、合并重复记录、区分已完成结果与可重试失败，并记录每个联系人被保留、修正、抑制或复核的原因。
审核日期：2026 年 7 月 21 日
清洗后的联系人记录应包含什么？
保留原始号码、E.164 规范号码、规范化状态、所选产品、完成结果或重试状态、检测时间和路由决策。输入无效、registered=false 与临时服务失败需要完全不同的后续动作，不能合并成一个“无效号码”字段。
使用分阶段流程，而不是单一通过/失败列
每个阶段都应增加证据，同时保留诊断错误所需的原始输入。
- 1
保留来源记录
为每行分配稳定 ID，并保留原始号码、来源、导入时间和可用国家信息。
- 2
规范化并去重
生成 E.164 号码，将有歧义的行送去纠错，并按规范值识别重复记录。
- 3
运行最小必要检测
名单清洗默认使用 ws；只有明确工作流需要时才请求头像或商业账号字段。
- 4
分类结果
分别保存已注册、未注册、输入无效、可重试和余额阻断。
- 5
结合同意规则路由
任何触达前都要结合已有同意、退订、接收方偏好与适用规则。
建议的输出字段
结构化输出可以支持纠错、定向重试与审计，无需重新导入原文件。
| 字段 | 作用 | 示例 |
|---|---|---|
| source_phone | 保留导入值 | +1 (415) 555-2671 |
| normalized_phone | 规范匹配与请求标识 | +14155552671 |
| normalization_status | 区分有效、已修正和有歧义 | valid / needs_review |
| verification_status | 区分完成判断与运行故障 | registered / unregistered / retry |
| verified_at | 标记该时点结果 | ISO 8601 时间 |
| routing_decision | 记录动作和原因 | keep / suppress / review |
围绕同步限制处理大名单
API 每次只检查一个号码。客户端批量功能或后端任务应控制并发、遵守用户限速，并只重试运行故障。
- 每个用户最多保持 3 个在途检测。
- 网页后台与 API 合计不超过每分钟 200 次。
- 429 不扣余额；保留对应号码，等待窗口或并发名额恢复后再自行提交。
- 503 与无判定稍后重试；已完成的 registered=false 不属于重试错误。
- 保存处理进度，使中断任务无需重复已完成行。
导出前检查数据质量与合规
技术上已注册的号码仍可能不适合触达，最终路由责任仍属于数据使用方。
- 在号码规范化后应用退订与抑制名单，避免格式差异绕过规则。
- 只向确有需要的团队与系统导出手机号和检测字段。
- 按业务用途设定复核或过期策略，不假设结果永久有效。
- 在验证结果之外单独记录合法用途、同意来源与接收方偏好。