如何查询手机号是否注册了 WhatsApp（API 教程）

发布于 2026年8月23日

如果你的业务会收集手机号——来自注册表单、CRM 导入、广告线索或外购名单——其中相当一部分号码可能根本无法在 WhatsApp 上触达。向这些从未注册的号码发起营销或引导流程，既浪费预算又拉低送达率。WhatsApp 号码检测能在你发送任何消息之前，告诉你某个号码是否真的注册了 WhatsApp。

本指南介绍如何用 WhatsApp 号码校验 API 查询单个号码，以及如何批量校验号码。

「检测号码」会返回什么

一次注册检测接收一个手机号，返回它是否绑定了活跃的 WhatsApp 账户。根据不同接口，你还可以拉取已注册号码的公开资料——例如昵称、头像、「关于」签名、企业资料以及在线状态/最后在线时间——这些数据非常适合做线索补全与打分。

第一步 —— 获取 API Key

所有请求都通过 API Key 鉴权：

  1. 注册一个免费账户。
  2. 打开控制台，复制你的有效 API Key。

每个新账户都赠送免费点数，可以不花一分钱先测试 API。

第二步 —— 查询单个号码

调用 check-exist-by-phone 接口，传入国际格式的完整号码（纯数字，不带 +、空格或连字符）：

curl "https://api.opendata-api.com/api/project/whatsapp/check-exist-by-phone?key=你的API_KEY&phoneNumber=15551234567"

响应会告诉你该号码是否已注册。如果你本来就是分开存储国家码和本地号码，check-exist-by-cc-phone 这个变体接口可以把它们作为两个字段分别传入。

号码格式很关键。 务必统一为不带前导 + 的 E.164 纯数字。15551234567 可以；+1 (555) 123-4567 不行。

第三步 —— 批量校验号码

逐个请求校验成千上万条线索既慢又容易触发限流。batch-check-10 接口可在一次请求中校验最多 10 个号码：

curl "https://api.opendata-api.com/api/project/whatsapp/batch-check-10?key=你的API_KEY&accounts=15551234567,15557654321,442071234567"

传入逗号分隔的号码列表，即可在一次调用中拿到每个号码的结果——清洗名单时大约减少 10 倍请求量。名单更大时，按每批 10 个循环即可。

常见应用场景

  • 线索名单清洗 —— 在发起营销前剔除未注册 WhatsApp 的号码，只为可触达的联系人付费。
  • 注册验证 —— 在把 OTP 或客服路由到某号码前，先确认它支持 WhatsApp。
  • CRM 数据补全 —— 为已注册联系人补充头像、签名与企业资料。
  • 反欺诈筛查 —— 在引导流程中标记一次性或从未注册的可疑号码。

最佳实践

  • 先做归一化。 只保留数字并带上国家码。
  • 先 dedup 再检测，避免同一个号码重复消耗点数。
  • 缓存结果。 注册状态不会每分钟变化，按周期（如每隔几周）复检即可，不必每次发送前都查。
  • 遵守平台规则。 只检测你有正当依据处理的号码，并遵守 WhatsApp 条款及所在地区的隐私法规（如 GDPR）。

立即体验

你可以在 WhatsApp 号码校验页面在线交互式测试——无需写代码——也可以查看 check-exist-by-phone 与 batch-check-10 的接口文档。准备集成时，获取一个 API Key，从账户赠送的免费点数开始即可。