产品指南
使用 WA Lookup 同步 API 优化 B2B 线索资质审核
集成同步 WhatsApp 注册状态 API，以验证账户存在信号并高效优化 B2B 线索资质审核工作流。
了解如何集成 WA Lookup 同步 API，以验证 WhatsApp 账户存在情况、头像可用性及商业状态，从而进行 B2B 线索资质审核。
WA Lookup 同步 API 帮助 B2B 团队实时验证 WhatsApp 账户存在情况、头像可用性及商业状态。通过发送带有 E.164 格式电话号码的 POST 请求，开发者可以在同一个 HTTP 响应中立即获得账户存在信号。这项按次计费的服务会自动退还失败的请求，为根据 WhatsApp 个人资料信号筛选线索提供了一种可靠的方法，而无需依赖异步轮询或复杂的 Webhook 架构。
理解同步工作流
在处理大批量 B2B 线索时，技术运营团队需要即时数据来指导路由和优先级排序。WA Lookup API 采用同步请求-响应模式。这意味着 API 在初始请求的同一个 HTTP 响应中返回结果，而不是异步交付。这种同步行为支持在线索资质审核流程中进行即时决策，允许开发者在将线索录入 CRM 或销售队列之前，为其附加账户存在信号。 为确保在全球线索列表中进行准确处理，所有提交的电话号码必须使用 E.164 格式。该国际电话编号计划要求号码以“+”前缀开头，后跟国家代码和用户号码。将输入标准化为 E.164 格式可防止路由错误，并确保 API 能够准确地针对平台检查提交的标识符。
选择正确的服务类型
WA Lookup 将其功能整合到一个同步端点中，其中 service_type 参数控制返回哪些字段以及适用哪种余额成本。团队可以根据其特定的线索资质审核需求，从三种不同的服务类型中进行选择：
| 服务类型 | 范围和返回字段 |
|---|---|
ws |
确认基本的 WhatsApp 注册。返回 registered 字段以指示账户存在。 |
ws_avatar |
检查注册情况及头像可用性。添加 avatar 布尔值和 avatar_url 字符串（仅在上游服务提供时存在）。 |
ws_business |
检查注册情况以及账户是否使用 WhatsApp Business。添加 business 布尔值。 |
使用 ws_business 对于 B2B 工作流特别有用，因为它有助于团队筛选并优先处理那些维护专业 WhatsApp Business 个人资料的线索。同时，ws_avatar 提供个人资料丰富化信号，而标准的 ws 检查通过确认平台注册情况来支持基础的列表清理。 |
技术实现概述
集成该 API 需要一个简单的 HTTP 请求。文档化的请求契约使用 POST /api/v1/check。请求必须包含 X-API-Key 和 Content-Type: application/json 头部。JSON 主体需要两个字段：service_type（设置为 ws、ws_avatar 或 ws_business）和 identifier（E.164 格式的号码）。
标准请求载荷如下所示：
{"service_type": "<ws|ws_avatar|ws_business>", "identifier": "<E.164 number>"}
每个检查响应都包含一组可预测的字段：id、identifier、registered、transaction_id、status、service_type 和 charged_amount_micros。根据所选的服务类型，响应将附加用于头像和商业状态的额外布尔值或字符串字段。由于所有三种 WhatsApp 产品都使用同一个同步端点，开发者可以通过修改请求载荷中的单个字符串轻松切换检查类型，从而最大限度地减少代码维护。
解读账户存在信号
在将这些信号集成到 B2B 工作流中时，了解数据的边界至关重要。registered 结果报告的是在检查时点可用的 WhatsApp 状态字段。它仅作为账户存在信号。
该 API 不会检查在线状态、最后上线时间戳或消息历史记录。团队应将这些检查作为除其他资质审核标准之外的一个输入项。
管理成本与可靠性
大批量线索资质审核需要可预测的成本管理。该 API 采用严格的按次计费模式。为确保团队仅为可操作的数据付费，失败或未确定的检查将自动退款。这种自动退款机制在处理大量未经核实的列表（其中部分号码可能无效或无法通过检查）时，可以保护预算。 为了进行运营监督，平台仪表板支持全面的 API 密钥管理和财务跟踪。运营团队可以监控余额、查看检查历史记录并访问产品级报告。仪表板还显示最近的检查、余额支出和 7 天趋势，帮助管理人员预测使用量并相应地调整线索摄入量。新账户可以领取 $0.10 的试用余额，以便在投入更大规模使用前测试注册、头像和商业账户检查。
常见问题解答
三种服务类型之间有什么区别？
ws 服务类型确认基本的 WhatsApp 注册。ws_avatar 类型检查注册情况并添加头像可用性及头像 URL（如果提供）。ws_business 类型检查注册情况并添加一个布尔值，指示账户是否使用 WhatsApp Business。
API 是否检查消息是否可以送达？
不。registered 结果报告的是检查时点可用的 WhatsApp 状态字段。它仅作为账户存在信号，不会检查在线状态、最后上线时间、消息历史记录、联系人许可或消息是否可以送达。
计费模式中如何处理失败的检查？
该 API 使用按次计费模式，失败或未确定的检查会自动退款，确保您仅为已完成的账户存在信号付费。
API 需要什么电话号码格式？
所有提交的电话号码必须采用 E.164 格式。该国际标准要求以“+”前缀开头，后跟国家代码和用户号码。
API 响应是如何交付的？
该 API 是同步的，这意味着结果在初始请求的同一个 HTTP 响应中返回，而不是通过 Webhook 或轮询异步交付。