检测内容
WhatsApp 注册检测 会返回什么？
WhatsApp 注册检测（ws）可确认手机号是否已注册 WhatsApp，适合群发、线索分配或外呼前校验。
service_type： ws
WhatsApp 注册检测
通过同步 API 或网页后台确认手机号是否已注册 WhatsApp，适合发送前检查联系人名单。
响应方式: 同步
POST /api/v1/check
WhatsApp 注册检测公开演示
无需登录；公开演示有每日次数限制。
适用场景
在以下场景使用本产品
- 联系人名单检查
- 线索资格判定
- 发送前校验
- CRM 数据质量
结果解释
WhatsApp 注册检测结果代表什么？
一次完成的 ws 检测会报告所提交的手机号在请求时是否注册 WhatsApp。请把 registered 与失败或无判定请求分开理解：只有完成的检测才会给出可用的 true 或 false；需要更晚状态时，应重新检测。
把 true 视为当时状态
registered=true 表示本次检测报告该号码已注册 WhatsApp；它不代表账号活跃、号码归属或联系许可。
区分 false 与请求错误
registered=false 是一个已完成结果；失败或无判定不是同一结论，并会退款，而不是记录为未注册。
用于分流，不用于身份认定
可用该字段清洗或分流联系人记录，但不能仅凭注册状态确认号码背后的个人或企业身份。
正确使用结果
让一次单号码检测真正有用的三个细节
提交一个手机号
请包含国家区号，例如 +14155552671，确保每次请求对应一个明确的号码。
读取所选产品字段
当前 service_type 只返回其定义的 WhatsApp 字段；需要不同字段时请选择对应产品。
使用同步返回结果
后端会同步返回所选字段；需要更新状态时请重新检测，联系用户前仍需取得相应同意。
直接答案
注册检测 是什么？
WhatsApp 注册检测 是一个返回注册状态的 service_type。调用时把 service_type 设为 ws，并提交一个手机号，即可在同一次 API 响应中获得结果，并保存后台检测记录。仅在检测完成后扣除余额；失败或无判定检测会自动退回余额。
能力边界
不会返回哪些内容
- 不会返回聊天记录、会话内容或任何私密账号内容。
- 不会返回在线状态、最后上线时间或实时活跃情况。
- 只返回当前 service_type 响应中定义的字段。
API 契约
一次请求，立即返回
提交一个手机号，并用 service_type 选择本产品；认证使用你的 API Key。
请求
POST /api/v1/check{
"service_type": "ws",
"identifier": "+14155552671"
}响应
200 OK{
"code": 0,
"msg": "ok",
"data": {
"service_type": "ws",
"identifier": "+14155552671",
"registered": true
}
}产品常见问题
关于注册检测的常见问题
WhatsApp 注册检测 检测什么？
它对一个手机号进行检测，并在同一次同步响应中返回注册状态。
注册检测如何计费？
仅在检测完成后扣除余额；上游失败或无判定的请求不会保留扣费。
需要提交什么？
请提交你的工作流要检测的手机号。
显示已注册，是否代表获得了联系许可？
不是。结果仅反映检测时可获得的 WhatsApp 状态字段；同意、接收方偏好和适用的平台规则仍需由您自行遵守。
相关产品