如何批量验证 CSV 中的电话号码

了解如何准备 E.164 格式的电话号码 CSV 文件，并使用 WA Lookup 的同步 API 进行处理，以获取即时的账号存在性信号。

要使用 WA Lookup 批量验证 CSV 中的电话号码，请先将所有号码格式化为国际 E.164 标准。接下来，通过向 /api/v1/check 端点提交单独的同步 POST 请求来处理您的列表。通过选择适当的服务类型（ws 用于标准注册，ws_avatar 用于个人资料丰富化，或 ws_business 用于商业账号识别），您可以在同一个 HTTP 响应中收到即时的账号存在性信号。失败或未确定的检查将自动退款，帮助团队系统地审查联系人列表，并根据已验证的平台注册情况对受众进行细分。

准备验证数据

在发起任何 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 涉及遍历您的格式化列表，并向 WA Lookup API 发出单独的请求。该平台使用同步 POST 请求访问 /api/v1/check 端点。 要进行身份验证，请在 X-API-Key 请求头中包含您的 API 密钥，并添加 Content-Type: application/json 请求头。JSON 正文必须包含您选择的 service_type 和 identifier（E.164 格式的号码）。每次成功的检查响应都会携带标准字段，包括 id、identifier、registered 状态、transaction_id、service_type 和 charged_amount_micros。注册结果确认了检查时刻的账号存在性；它不会检查在线状态、最后上线时间戳或消息历史记录。

管理成本与结果

WA Lookup 采用按次付费模式，这意味着您的余额仅在完成验证时扣除。如果检查失败或返回未确定的结果，费用将自动退还到您的账户。 团队可以通过 WA Lookup 仪表板监控批量验证的进度和成本。仪表板支持 API 密钥管理、余额跟踪、检查历史记录、产品级报告、近期检查、余额支出和 7 天趋势分析。新账户还可以领取 0.10 美元的试用余额，以便在处理大型 CSV 文件之前测试注册、头像和商业账号检查功能。

常见问题解答

WA Lookup 是否支持异步批量处理？

不支持，WA Lookup 不支持异步批量处理。所有检查均为同步进行，这意味着每个提交的电话号码的结果都会在与请求相同的 HTTP 响应中立即返回。

ws、ws_avatar 和 ws_business 之间有什么区别？

ws 服务类型返回标准平台注册状态。ws_avatar 类型增加了头像可用性检查，并在存在时返回头像 URL。ws_business 类型在检查注册的基础上，识别该号码是否关联了 WhatsApp 商业账号。

失败的检查会扣除我的余额吗？

不会，计费严格按照单次检查计算。任何失败或未确定的检查都会自动退还到您的账户余额中。