产品指南
如何实时验证 CSV 中的电话号码
使用 WA Lookup 实时验证 CSV 中的电话号码：E.164 格式、单号或同步多号接口一次最多 100 个，WhatsApp 账号存在性结果在同一次响应中返回。
了解如何准备 E.164 格式的电话号码 CSV 文件，并通过 WA Lookup 的实时单号与多号接口处理，以获取即时的账号存在性信号。
WA Lookup 以实时验证 WhatsApp 账号存在性为主：把一个 E.164 号码提交到 POST /api/v1/check，或把最多 100 个号码提交到同步多号接口 POST /api/v1/batch-check，完成结果都在同一个 HTTP 响应中返回。CSV 只是这些请求的数据来源——标准化号码列、选定服务类型，再通过多号接口按每次最多 100 个提交即可。远超一次实时请求的整份文件，也可以作为异步批量任务上传。
准备验证数据
在发起任何 API 请求之前，必须正确格式化您的 CSV 文件。WA Lookup 要求所有提交的电话号码必须使用 E.164 格式。这种国际电话编号计划规定每个号码都是唯一且明确的，通常以加号开头，后跟国家代码和用户号码。将 CSV 列标准化为此格式可减少 API 调用期间的错误，并支持工作流输入的准确处理。
选择合适的 WhatsApp 检查类型
WA Lookup 为同步单号与同步多号检测提供同样的三种服务类型。应根据工作流所需的账号存在性信号选择对应类型。
| 服务类型 | 范围与返回信号 |
|---|---|
| ws | 返回标准平台注册状态（registered 布尔值）。 |
| ws_avatar | 检查注册情况并添加个人资料丰富化信息（avatar 布尔值和 avatar_url 字符串；没有可用地址时为空字符串）。 |
| ws_business | 检查注册情况并识别 WhatsApp 商业账号（business 布尔值）。 |
service_type 参数控制返回哪些字段以及适用哪种余额扣费标准。
执行验证工作流
处理 CSV 时，可通过同步多号接口 POST /api/v1/batch-check 一次提交最多 100 个已格式化号码；单个号码使用 POST /api/v1/check。两种接口都会在发起请求的同一个 HTTP 响应中返回结果，没有任务提交、轮询或下载步骤。
对于完成的 WhatsApp 检测，返回的 data 包含 service_type、identifier 和 registered；ws_avatar 另有 avatar 与 avatar_url，ws_business 另有 business。内部记录、交易、状态和计费字段不会对外返回。
管理成本与结果
团队可以通过 WA Lookup 后台管理 API Key、查看检测历史，并监控余额与产品维度的用量。多号请求本身通过 API 同步完成，后台负责提供账户与用量的可见性。新账户还可以联系客服领取 100 次免费检测的赠送额度，在处理更大的 CSV 文件之前先测试注册、头像与商业账号三种检测。
常见问题解答
ws、ws_avatar 和 ws_business 之间有什么区别？
ws 服务类型返回标准平台注册状态。ws_avatar 类型增加了头像可用性检查，并在存在时返回头像 URL。ws_business 类型在检查注册的基础上，识别该号码是否关联了 WhatsApp 商业账号。
可以一次请求检测多个号码吗？
可以。同步多号接口 POST /api/v1/batch-check 一次最多接收 100 个号码，完成结果在同一个 HTTP 响应中返回，没有任务提交、轮询或下载步骤。远超这一规模的整份名单，另有异步批量任务可用（提交时选定号码所属国家，一份名单应基本属于这一个国家），但同步接口仍是主要的检测方式。
失败的检查会扣除我的余额吗？
失败、超时或无法判定的检测不会保留扣费；当前计费规则请以价格页为准。