WhatsApp 号码检测操作指南：批量导入名单预检清洗、识别已注册账号并回写 CRM 状态

概览

WhatsApp 号码检测对一批号码做两种只读检测：可用性检测（通过 USync 注册查询判断号码是否注册 WhatsApp）与最后在线检测（通过 presence 订阅观察在线 / 最后在线）。它用于群发前清洗名单、复检沉睡客户、挑选人工跟进的时点，并保持 CRM 号码数据的整洁。

检测有两个入口：独立的号码检测页（URL /number-check）适合导入整批外部名单；联系人页则按与联系人列表相同的筛选维度，对选中客户或当前筛选全量一键发起检测，超过任务容量时自动拆分。

检测过程绝不发消息、不写通讯录、不触发自动化：它只查询号码状态，不会向号码发送任何内容，不会写入账号通讯录，也不会触发流程、AI、关键词或通知。检测结果只在你确认后，才会用于导出或加入联系人分组。

关于 unknown：结果里的“未知（unknown）”只表示本次没有取得明确证据，不代表号码未注册，也不代表号码无效；任何时候都不会为凑结论而编造注册或在线状态。

两种检测模式与结果语义

注册与在线由两条独立通道查询，结果分别记录、互不替代。

• 注册与在线分开。可用性来自 USync 注册查询，在线来自 presence 订阅观察，两者独立记录。“已注册但最后在线未知”是正常情况 — 不会因为在线未知而把注册结论改成未注册，也不会用在线状态反推注册。
• 隐私受限一律未知。号码的隐私设置或协议没有明确返回时，在线与最后在线保持未知，绝不编造在线时间。
• unknown 不代表未注册。未知只是本次没有取得明确证据，不能当作无效号码，也不能据此判定号码不存在；可以在之后重新检测。
• 异常不误判。号码格式不合法等请求错误会让整块结果记为未知，而不是误记为“不可用”。
• 保存前观测。把联系人写入账号的 WhatsApp 通讯录前，系统会再做一次独立的注册观测，观测默认有效 900 秒；写入是否成功以该保存任务的回执为准，而不是以检测结果为准。

创建检测任务

入口一：独立号码检测页批量导入

1. 打开号码检测（URL /number-check），新建检测任务。
2. 导入号码：支持直接粘贴、CSV / TXT / VCF 文件，并提供模板下载；无效项与重复项可单独下载，修正后重新预检。
3. 查看预检分类：有效、重复、无效的数量与逐条结论。注意预检有效 ≠ 已注册 — 预检只检查号码格式与重复。
4. 确认30 分钟冻结预览：候选范围冻结后再由你确认拆分任务；预览过期需要重建，避免确认时实际使用了另一份名单。
5. 选择检测模式与执行账号池，确认后按容量自动拆分为批次任务，由账号池逐块执行。

入口二：联系人页按筛选一键检测

• 使用与联系人列表相同的筛选维度：分组、国家、WA 状态、stale 过期时间等。
• 选择对选中客户或当前筛选全量发起检测；超过容量时自动拆分，每次最多 10 个任务。
• 结果回写客户的 WA 徽标与检测时间，可继续用于联系人筛选与复检。

从可用结果派生最后在线任务

在可用性任务的结果中，可对明确 available 的号码一键派生独立的最后在线任务：小批量默认不超过 50 条，派生操作不会改动原任务的注册结果。

账号轮换与安全限额

检测任务由工作区中多个已连接的账号轮换执行。任务固定账号池后，系统按账号用量与剩余额度安排下一数据块；服务端强制以下规则，尽量减少对账号的影响。

执行资源为 contacts 队列与账号锁，逐号探测由辅助服务（连接运行服务）完成。实际的任务容量、间隔与上限由服务端限制（夹取），以服务端实际执行为准。

任务控制与结果导出

任务列表与任务详情页提供完整的执行视图：状态（待启动 / 检测中 / 已完成 / 已暂停）、进度、暂停原因、逐号明细与按账号统计。

• 任务控制。可随时暂停、继续或取消任务；暂停后已完成的结果会保留，处理完暂停原因即可继续未完成条目。
• 结果查看。按可用 / 不可用 / 未知等状态筛选逐号结果，核对每个号码的检测时间。
• 结果导出。支持 CSV / XLSX 导出；明确可用的号码可导出 VCF，仅包含明确 available 的号码。
• 下载文件。结果下载使用私有文件，下载后删除，不长期留存。
• 审计。检测任务与结果导入等关键操作留有审计记录，可按需追溯。

结果导入联系人分组

检测结果可以用两步式确认导入联系人分组，把明确可用的号码变成可运营的客户。

1. 预览。系统先给出将新建、加入已有分组或跳过的数量，供你核对。
2. 确认导入。确认后才执行写入；只有明确已注册（available）的结果参与导入，未知结果不会被当作可用号导入。

• 可选择已存在联系人的处理策略（建号 / 跳过），并为导入的联系人打标签、写入 WA 状态属性。
• 检测本身不触发自动化；但目标分组如果已经配置了流程规则，新成员入组后会按该规则执行 — 这属于分组流程的正常联动，与检测动作无关。
• 结果导入操作会写入审计记录（number_check.import_contacts），便于追溯。

联系人徽标与 stale 复检

每次检测的结果会回写联系人，供列表筛选与后续复检：

联系人列表支持按 WA 状态（wa）维度筛选这些徽标，并可查看最近检测时间。检测时间超过默认 30 天 的结果会进入 stale 范围，可以按该范围一键发起复检；注册结果是过去某个时点的观察，建议按业务节奏定期复检。

启用条件与限制

常见问题

Q：独立号码页怎样处理上千行名单？

A：支持批量粘贴与 CSV / TXT / VCF 导入，先规范号码并分类为有效、重复、无效，核对 30 分钟冻结预览后再按容量拆分。以 1,200 个有效号码为例，可用性检测可拆成 500、500、200 三个任务，由账号池逐块处理。

Q：已注册但最后在线未知是什么情况？

A：注册由 USync 查询、在线由 presence 观察。隐私限制或没有明确返回时，在线保持未知，不会因此把注册结论改成未注册。

Q：unknown 是不是代表号码未注册？

A：不是。unknown 只表示本次没有取得明确证据，既不代表已注册也不代表未注册，更不能当作无效号码；后续可以重新检测。

Q：为什么任务会暂停，而不是自动一直重试？

A：账号断连、每日额度不足或连续协议错误需要先处理原因。系统会保留已完成的结果并暂停后续探测，恢复后再继续处理剩余条目，避免风暴式重试。

Q：可以从联系人列表直接检测吗？

A：可以。按分组、国家、WA 状态或 stale 过期条件圈选后，对选中客户或当前筛选全量发起；超限自动拆分，每次最多 10 个任务，结果回写 WA 徽标与检测时间。

Q：可用号导入联系人分组会发生什么？

A：先预览“新建、加入已有分组、跳过”的数量，再确认。只有明确已注册的结果参与导入，可打标签并写入 WA 属性；目标分组已配置的流程规则会在入组后生效。

Q：号码注册成功，代表已经存入账号通讯录吗？

A：不代表。检测是只读的，不会写通讯录；写入 WhatsApp 通讯录使用独立的保存任务，并需要有效期内的注册观测，是否成功以该任务回执为准。

Q：检测会向号码发消息吗？

A：不会。检测是只读查询（USync / presence），绝不发消息、不写通讯录、不触发自动化。

相关页面

• 联系人与分组 — 检测结果回写的 WA 徽标、分组与复检入口都在这里。
• 地图获客 — 先采集公开商户线索，再把名单交给号码检测筛选。
• 套餐与试用 — 查看套餐包含的功能与试用方式。
• 营销活动 — 用检测后的明确可用名单准备发送受众。