号码查询 API 与 WhatsApp 检测：各自返回的内容
运营商和线路类型查询与 WhatsApp 注册检测回答的是不同的问题。了解各自的返回内容以及如何结合使用它们。
本文对比了通用电话号码查询 API 与 WhatsApp 注册检测，并就列表清洗工作流何时需要其中之一、两者皆需或两者均不需要提供了指导。
号码查询 API 和 WhatsApp 检测针对同一个电话号码回答的是不同的问题。号码查询 API 描述的是电话网络上的号码，通常包括其格式、国家/地区、运营商以及线路类型（如移动电话、固定电话或 VoIP）。WhatsApp 注册检测则描述的是单一平台：即在检测时该号码上是否存在 WhatsApp 账号。发送短信或拨打电话的团队需要号码查询；决定是否使用 WhatsApp 的团队则需要注册检测；而在多个渠道间进行路由的列表清洗工作流通常会按此顺序运行这两项检测。
号码查询 API 与 WhatsApp 检测概览
针对该主题的搜索结果往往要么是运营商查询的服务商页面，要么是 WhatsApp 检测的服务商页面，且各自仅描述其输出内容。下表将两者进行了对比。
| 问题 | 号码查询 API | WhatsApp 注册检测 |
|---|---|---|
| 它描述什么？ | 电话网络上的号码 | 该号码上的一个消息平台账号 |
| 典型输出 | 编号计划的有效性、国家/地区、运营商、线路类型 | 检测时是否已注册；可选的头像或商业账号信号 |
| 数据来源 | 编号计划和运营商数据 | 检测时刻的 WhatsApp 平台 |
| 适用场景 | 短信和语音路由、固定电话和 VoIP 筛选 | 决定 WhatsApp 是否为合理的渠道 |
| 它无法告知什么 | 是否存在 WhatsApp 账号 | 运营商、线路类型或短信能力 |
上述结果均无法证明号码的持有者是谁，也无法证明该人是否同意被联系。两者都是路由决策的输入，且都仅描述了某一时刻的状态。
号码查询 API 返回的内容
“号码查询”涵盖了多个层面，服务商提供的封装方式各不相同：
- 格式和编号计划验证。 解析器（如 libphonenumber）会检查号码的长度和前缀对于其所属地区是否有效，并将其转换为 E.164 格式。此过程离线运行，无需网络查询。
- 运营商和线路类型。 网络查询会返回当前的运营商和线路类型。例如，Twilio 的 Line Type Intelligence 会返回运营商名称、移动国家和网络代码，以及诸如移动电话、固定电话、固定 VoIP、非固定 VoIP 或免费电话等类型。
- 额外的风险或携号转网数据。 一些服务商将携号转网历史、SIM 卡更换或号码重分配数据作为独立产品提供。
这些结果回答的是电话通信方面的问题。移动线路类型通常意味着该号码可以接收短信；而固定电话类型通常无法接收。运营商查询不会报告该号码是否在 WhatsApp 或任何其他应用程序上拥有账号，因为这不是运营商数据。
WhatsApp 注册检测返回的内容
WhatsApp 检测直接针对平台特定的问题进行询问。在 WA Lookup 中，实时检测接收一个 E.164 格式的号码，并在同一响应中返回结果；service_type 值用于选择您获取的信号。
ws: 注册状态
检测时该号码上是否注册了 WhatsApp 账号。这是渠道选择的核心可触达性信号。
ws_avatar: 注册状态加头像可用性
增加了个人资料照片是否可用，并在存在时提供链接。缺少头像并不意味着该号码未注册。
ws_business: 注册状态加商业账号类型
增加了该账号是否为 WhatsApp 商业账号。它描述的是账号类型，而非经过验证的合法公司。
该检测可通过单号码 API 请求、最多 100 个号码的同步多号码请求、仪表板以及面向 AI 客户端的 MCP 服务器进行。无法判定的检测会返回非零业务代码，应进行重试，而不应存储为未注册。
何时使用号码查询 API、WhatsApp 检测或两者皆用
根据您的工作流所做的决策来匹配工具：
| 工作流 | 号码查询 API | WhatsApp 检测 |
|---|---|---|
| 仅短信营销活动 | 是，用于筛选固定电话和部分 VoIP 线路 | 否 |
| 仅针对已授权联系人的 WhatsApp 外联 | 仅格式检查 | 是 |
| 多渠道路由（优先 WhatsApp，短信兜底） | 是，用于兜底渠道 | 是，用于首选渠道 |
| 以 WhatsApp 作为联系选项的注册表单 | 输入时进行格式检查 | 是，作为路由的软信号 |
| B2B 列表细分 | 可选 | 是，配合商业账号检测 |
两种模式会导致大部分预算浪费。第一种是对仅通过 WhatsApp 发送消息的联系人运行运营商查询，此时线路类型不会改变决策。第二种是将线路类型作为 WhatsApp 的代理：移动号码可能拥有也可能没有账号，而列为 VoIP 或固定电话的号码也可能注册了 WhatsApp，因此注册检测是唯一直接的答案。
结合两者的列表清洗工作流
对于将在多个渠道间进行路由的混合列表，按此顺序操作可确保每一步都经济且有效：
- 离线规范化并验证格式。 使用编号计划库将每个号码转换为 E.164 格式并去除重复项。解析失败的号码进入审核流程；它们不值得进行付费查询。
- 对剩余号码运行 WhatsApp 注册检测。 对于小规模集合使用实时检测，对于导入操作使用每次同步 API 请求最多 100 个号码的检测，或使用仪表板中粘贴的实时批量检测。对于超大文件，异步批量任务支持上传 TXT 或 CSV 文件并返回可下载的结果文件，具体限制请参阅文档。
- 仅在计划使用短信或语音渠道时运行运营商和线路类型查询，例如针对未注册 WhatsApp 但将接收短信兜底的联系人。
- 将每个结果存储在各自的字段中，并注明来源和检测日期：来自查询的线路类型和运营商，以及来自 WhatsApp 检测的注册状态和可选的头像或商业账号信号。
- 将无法判定的结果单独存放并进行重试，而不是将其合并到任何一组中。
保持字段独立可以让分析师了解联系人进入特定渠道的原因，并允许每个信号按各自的计划进行刷新。
评估各步骤的服务商
在比较服务商时，请针对每个类别提出具体问题，而不是使用通用的检查清单。
对于 号码查询 API：哪些数据包是独立产品，线路类型是如何定义的，哪些国家/地区有运营商覆盖，以及是否存在批量请求还是每个号码对应一个请求。
对于 WhatsApp 检测：结果是在同一响应中返回还是通过任务工作流返回，无法判定的检测如何报告，已注册和未注册的答案是否均收费，哪些路径支持哪些地区，以及服务是否依赖于您自己的 WhatsApp 会话。例如，WA Lookup 支持在小规模实时单次检测中处理中国大陆、香港和澳门的号码，而其批量文件任务则不接受这些地区。
在两个类别中，请阅读当前的文档以了解使用控制和数据处理方式，而不是依赖营销页面，并确保授权记录独立于任何查询结果。
常见问题解答
团队如何通过运营商查询判断号码是否有 WhatsApp？
无法直接判断。运营商和线路类型数据描述的是电话网络，而非应用程序账号。WhatsApp 注册检测是获取该信号的直接途径。
团队何时需要同时使用号码查询 API 和 WhatsApp 检测？
当联系人在多个渠道间进行路由时，例如优先使用 WhatsApp，短信作为兜底。WhatsApp 检测为首选渠道提供信息，而线路类型查询为兜底渠道提供信息。
两个结果应如何存储在 CRM 中？
存储在独立的字段中，并分别注明来源和检测日期，以便可以独立刷新任一信号，并让分析师能够追踪路由决策。
在列表清洗工作流中，哪一步应该先运行？
先进行离线格式规范化和去重，然后进行注册检测，最后仅针对计划进行短信或语音沟通的联系人运行运营商和线路类型查询。
了解更多
选择符合您工作流下一步的产品信息。