WA Lookup
WA Lookup workflow illustration for 超越 Webhook：同步 WhatsApp 号码验证
本文所述流程的可视化概览。

使用同步 REST API 替代复杂的事件驱动型 Webhook 架构，实时获取 WhatsApp 账户存在信号。

在评估用于号码验证的 WhatsApp 调用 Webhook 集成时，您无需为了检查 WhatsApp 账户状态而部署复杂的事件驱动型基础设施。通过使用同步 REST API，您可以提交 E.164 格式的电话号码，并在同一个 HTTP 响应中直接获取注册状态、头像或商业账户状态。这种同步方法消除了对轮询、异步状态管理或专用 Webhook 监听器的需求，为您的 CRM 丰富化或路由工作流提供即时数据支持。

事件驱动验证的复杂性

事件驱动架构在消息平台中很常见，但仅为了简单的号码验证而依赖 WhatsApp 调用 Webhook 集成会带来巨大的开销。Webhook 需要专门的基础设施来监听传入的负载、处理事件并向源服务器确认接收。对于开发团队而言，这意味着需要维护面向公众的端点、管理异步状态，并处理潜在的交付重试或负载解析错误。 当目标仅仅是在路由记录前确认账户存在信号时，事件驱动模型往往会引入不必要的延迟和维护负担。团队无需等待异步回调来确认号码是否已注册，而是可以通过请求所需的精确状态并立即接收结果，从而简化架构。

同步的优势

同步 API 模型提供了一种比管理 Webhook 监听器更高效的替代方案。使用 WA Lookup，结果是同步的，这意味着验证数据在初始请求的同一个 HTTP 响应中返回。该模型完全消除了对 Webhook 端点、持续轮询或异步状态管理的需求。 WA Lookup 将其验证检查整合到一个单一的同步端点中。通过调整请求的服务类型，开发人员无需更改网络架构即可获取不同层级的账户存在信号。该平台通过此单一端点支持三种不同的检查：

  • ws：确认提交的电话号码是否在 WhatsApp 上注册。
  • ws_avatar：检查 WhatsApp 注册情况并添加头像可用性，包括在上游服务提供头像 URL 时的相关信息。
  • ws_business：检查 WhatsApp 注册情况，并指出该账户是否使用 WhatsApp Business。 由于请求和响应在单个连接内完成，团队可以将这些检查直接集成到顺序数据管道或潜在客户评分逻辑中，而无需因外部事件而暂停。

通过 REST API 实现 WhatsApp 验证

集成同步检查需要的是简单的 HTTP 请求，而非复杂的事件监听器。公开的 API 指南描述了向 /api/v1/check 端点发送 POST 请求的方式。身份验证通过包含 X-API-Key 请求头来处理。 记录在案的请求契约要求 JSON 正文包含两个字段：service_type 值（ws、ws_avatar 或 ws_business）以及 identifier。标识符必须是以 E.164 格式提交的电话号码（例如 +14155552671）。 请求成功后，API 会返回一个包含所请求账户字段的 JSON 响应。每个检查响应都包含标准字段，包括 id、identifier、registered、transaction_id、status、service_type 和 charged_amount_micros。根据所选的服务类型，响应还将包含头像或商业状态的特定布尔字段。这种可预测的、统一的响应结构有助于开发人员立即解析账户存在信号，并将数据传递给下游应用程序。 为了支持持续管理，WA Lookup 仪表板提供了 API 密钥管理、余额跟踪、检查历史记录、产品级报告、近期检查、余额支出和 7 天趋势等工具。

数据丰富化与路由的最佳实践

在更广泛的业务工作流中将验证数据情境化，有助于团队优先处理外联工作并高效管理记录。使用同步 API 检查注册状态，可以作为在发起外联活动前清理潜在客户列表的多种检查手段之一。 在丰富 CRM 记录时，团队可以使用 ws_avatar 或 ws_business 服务类型来辅助内部路由规则。例如，识别出 WhatsApp Business 账户可以将记录路由至 B2B 销售队列，而头像 URL 则可以为客户支持团队提供额外的背景信息。 理解账户存在信号的边界非常重要。registered 结果仅报告检查时刻的 WhatsApp 状态字段。它不会检查在线状态、最后上线时间戳、消息历史记录、联系人许可或号码是否可被联系。该信号仅用于支持基于平台存在情况的内部审查和路由决策。 从运营角度来看，WA Lookup 采用按次计费模式。失败或未确定的检查会自动退款，这意味着工作流仅在成功获取状态时才会消耗余额。新账户还可以领取 0.10 美元的试用余额，以便在自己的管道中测试注册、头像和商业账户检查。

常见问题解答

我需要设置 Webhook 才能使用 WA Lookup API 吗？

不需要。WA Lookup 的结果是同步的，这意味着它们会在您请求的同一个 HTTP 响应中返回。您无需配置 Webhook 端点、事件监听器或轮询机制即可接收验证数据。

ws、ws_avatar 和 ws_business 服务类型之间有什么区别？

这三种类型都使用同一个同步端点，但返回的字段不同。ws 服务类型仅返回注册状态。ws_avatar 类型增加了头像布尔值和头像 URL（在上游服务提供时）。ws_business 类型增加了一个布尔值，用于指示该账户是否使用 WhatsApp Business。

在计费模式中，失败或未确定的检查是如何处理的？

WA Lookup 使用按次计费模式。如果检查失败或返回未确定的结果，费用会自动退还到您的账户余额中。

“已注册”状态是否意味着我有权联系该用户？

不。已注册结果仅提供检查时刻的账户存在信号。它不会检查联系人许可、在线状态、消息历史记录或号码是否可被联系。

参考来源