定义
WA Lookup 是什么?
- 用于检测 WhatsApp 注册状态和账号字段的网页后台与 REST API。
- 按 service_type 检测号码是否注册,以及头像可用性、商业账号状态。
- 单号与批量请求都同步返回 JSON 结果;批量接口单次最多支持 100 个号码。
- 仅对可用结果扣费,失败或无判定自动退回余额。
在发送消息或分配线索前,查询 WhatsApp 号码的注册状态、头像情况与商业账号属性。支持网页后台和 API,失败或无判定会退回余额。
定义
检测前须知
网页后台与 API 将一个提交的手机号发送给后端,并在同一次请求中返回所选状态字段。
请输入你的工作流要检测的手机号。
ws 返回注册状态;ws_avatar 增加头像可用性;ws_business 增加商业账号字段。
工作流可以立即读取返回的 JSON;需要更新状态时,请重新发起检测。
检测产品
三款产品共用同一个同步接口,通过 service_type 选择返回字段与余额消耗。
使用场景
在触达、记录更新或自动路由前,确认注册状态和可用的账号信息。
在导入营销活动或分配给销售前,先剔除未注册号码。
为联系人补充注册状态、头像或商业账号检测结果。
在后端任务、路由规则或客服工具中按单号实时验证。
核心能力
通过网页后台或 API 发起检测,统一管理余额、API Key 和每一次检测结果。
每次检测都会在同一个 HTTP 响应中返回结果,无需轮询或配置回调。
ws 判断注册状态,ws_avatar 查询头像及头像 URL,ws_business 识别商业账号;三款产品共用同一接口,通过 service_type 参数切换。
余额、API Key、检测日志和统计都在同一个后台里完成。
使用流程
可先使用网页手动检测,也可将同一验证服务接入自己的应用。
注册后直接进入后台,管理账号资料和 API Key。
系统先预扣余额,再发起检测;如果失败或无明确结果,会自动退回余额。
在后台查看近期检测、产品用量、余额消耗和 7 天趋势。
常见问题
快速了解 WhatsApp 产品、余额、API 接入和失败检测的处理方式。
WA Lookup 提供三款产品:ws(注册状态检测)、ws_avatar(注册状态 + 头像检测,可返回头像 URL)、ws_business(注册状态 + 商业账号识别)。不检测在线状态、最近在线时间或消息内容。
仅在检测完成后扣除余额。余额一次性购买,无月费;检测失败或无明确结果,系统自动退回余额。
创建免费账号后,联系客服即可领取 $0.10 试用额度,用于注册、头像和商业账号检测;你也可以随时充值。
在设置中创建 API Key,然后携带 X-API-Key 请求头向 /api/v1/check 发起 POST 请求,传入要检测的手机号和 service_type(ws、ws_avatar 或 ws_business),即可获得同步 JSON 响应。
不是。结果仅反映检测时可获得的 WhatsApp 状态字段。联系前仍需由您自行确保已取得同意、尊重接收方偏好并遵守适用的平台规则。