WA Lookup
WA Lookup workflow illustration for 利用 WhatsApp 号码验证 API 优化 B2B 线索验证
本文所述流程的可视化概览。

了解如何将 WA Lookup API 集成到 B2B 线索验证工作流程中，以使用 E.164 格式的号码同步验证 WhatsApp 账户的存在性。

WA Lookup API 为 B2B 团队提供了一个同步 WhatsApp 号码验证 API，用于验证电话号码是否在平台上注册。通过向端点提交 E.164 格式的号码，开发人员可以在同一个 HTTP 响应中立即获得账户存在性信号。这种同步检查支持实时线索验证工作流程，帮助营销运营经理区分标准账户、商业账户和已启用头像的账户，从而在没有异步延迟的情况下为外联策略提供参考。

WhatsApp 验证在 B2B 工作流程中的作用

B2B 线索生成专家经常需要管理跨全球市场的海量电话号码列表。了解哪些号码具有平台账户存在性信号，有助于团队优先处理外联工作并有效地细分沟通渠道。WhatsApp 注册状态仅作为账户存在性信号。它通过确认号码在检查时已在平台上注册，为内部决策提供依据。 该信号有助于实现更整洁的工作流程输入，确保 CRM 操作员能够根据平台存在性将线索路由到适当的消息发送或呼叫队列。通过在线索生命周期的早期集成这些检查，组织可以更好地构建数据、准确更新联系人记录并支持更高效的销售运营。

理解同步 API 集成

WA Lookup API 围绕同步请求-响应模式设计。当系统提交请求时，结果会在同一个 HTTP 响应中返回，而不是通过 Webhook 或轮询机制异步交付。这种同步架构简化了开发人员在 Web 表单、CRM 触发器或数据扩充管道中构建实时验证的集成过程。 由于无需构建单独的 Webhook 监听器或管理延迟回调，工程团队可以立即解析电话号码的状态。该 API 使用标准的 POST 请求访问 /api/v1/check 端点，并通过 X-API-Key 标头进行保护。由于检查是同步进行的，调用应用程序可以立即使用账户存在性信号来路由线索、标记记录以供审查或即时更新数据库。

选择正确的服务类型

所有三种 WhatsApp 产品都使用相同的同步端点。请求体中的 service_type 参数控制执行的具体检查、返回的字段以及适用的余额成本。

  • WhatsApp 检查器 (ws)：确认提交的电话号码是否在 WhatsApp 上注册。响应包含 registered 字段，提供基础的账户存在性信号。
  • WhatsApp 头像检查器 (ws_avatar)：检查 WhatsApp 注册并增加个人资料扩充。它返回一个 avatar 布尔值，并在上游服务提供时返回 avatar_url 字符串。这有助于团队验证视觉个人资料元素。
  • WhatsApp 商业检查器 (ws_business)：检查注册并确定账户是否使用 WhatsApp Business。它返回一个 business 布尔值，这对于旨在识别其他商业实体的 B2B 工作流程特别有用。 这种单端点设计允许开发人员根据工作流程的具体需求动态调整账户存在性信号的深度，而无需更改核心集成。

技术实施要求

要成功查询 WhatsApp 号码验证 API，所有提交的电话号码必须符合 E.164 标准。该国际电话编号计划要求使用“+”前缀，后跟国家代码和用户号码。 记录在案的请求契约要求向 /api/v1/check 发送 POST 请求，并包含标头 X-API-Key: <key> 和 Content-Type: application/json。JSON 正文必须包含两个字段：service_type（接受 ws、ws_avatar 或 ws_business）和 identifier（包含 E.164 格式的号码）。 例如，一个有效的 JSON 有效负载为 {"service_type": "ws", "identifier": "+1234567890"}。每次成功的检查响应都包含标准字段，包括 id、identifier、registered、transaction_id、status、service_type 和 charged_amount_micros。transaction_id 和 charged_amount_micros 的包含确保开发人员可以在其内部系统中维护精确的审计日志并跟踪每次同步检查的确切成本。

管理成本与可靠性

WA Lookup 采用直接的按次付费计费模式。为了支持可靠的成本管理，平台执行自动退款政策：任何失败或未确定的检查都会自动退还到账户余额中。新账户可以申请 0.10 美元的试用余额，以便在将集成扩展到更大的线索列表之前测试注册、头像和商业账户检查。 管理员和营销运营经理可以通过平台仪表板监控其使用情况。仪表板支持 API 密钥管理、当前余额跟踪、检查历史记录和产品级报告。团队还可以查看最近的检查、监控余额支出并分析 7 天趋势。这些报告工具为运营经理提供了了解验证 API 在其 B2B 工作流程中如何被利用所需的可见性，并能准确预测未来的使用量。

常见问题解答

电话号码应该采用什么格式？

所有电话号码必须以 E.164 格式提交。该国际标准要求使用“+”前缀，后跟国家代码和用户号码（例如 +1234567890）。

失败的检查会从我的账户中扣费吗？

不会。API 使用按次计费模式，任何失败或未确定的检查都会自动退还到您的账户余额中。

三种服务类型之间有什么区别？

ws 服务类型检查基本的 WhatsApp 注册状态。ws_avatar 类型检查注册并返回头像可用性以及头像 URL（如果提供）。ws_business 类型检查注册并指示该号码是否与 WhatsApp Business 账户关联。

API 是否会检查用户当前是否在线？

不会。注册结果仅报告检查时可用的 WhatsApp 状态字段。它仅作为账户存在性信号，不会检查在线状态、最后上线时间戳、消息历史记录或号码是否可以联系。

参考来源