将 WhatsApp LID 解析为电话号码：CRM 数据完整性指南

了解如何使用 WA Lookup API 进行 WhatsApp LID 到电话号码的解析。同步验证注册状态、头像可用性及企业账户信号，以支持 CRM 数据完整性。

要验证 WhatsApp 注册情况并支持 WhatsApp LID 到电话号码的解析工作流，请使用 WA Lookup REST API。通过将 E.164 格式的电话号码发送至 POST /api/v1/check 端点并指定 service_type（ws、ws_avatar 或 ws_business），您将收到一个同步的 JSON 响应，确认账户存在信号。此过程有助于团队维护干净的联系人数据，并实时为 CRM 分段提供参考。

为什么 WhatsApp 验证对 CRM 数据至关重要

维护准确的 CRM 数据需要验证哪些电话号码与特定平台相关联。当团队集成 WhatsApp LID 到电话号码的解析工作流时，他们依赖准确的账户存在信号来细分受众并适当地路由记录。在发起外联之前验证号码，有助于 CRM 管理员审查数据质量并确定联系人列表的优先级。 “已注册”结果确认提交的号码在检查时存在 WhatsApp 账户。此信号支持内部决策，并可作为维护数据卫生的输入项之一。它提供了一个基础数据点，为更广泛的 CRM 数据操作提供参考。

了解 WA Lookup 验证产品

WA Lookup 通过单个同步端点提供三种不同的验证产品。请求中的 service_type 参数控制返回的字段及适用的余额扣费。

WhatsApp 检查器 (ws)

此检查确认提交的电话号码是否在 WhatsApp 上注册。它仅返回 registered 字段，为基础数据验证提供直接的账户存在信号。

WhatsApp 头像检查器 (ws_avatar)

除了注册信号外，此检查还通过返回 avatar 布尔值来支持个人资料丰富化。如果上游服务提供，它还会返回 avatar_url 字符串，该字符串可用于通过视觉背景丰富 CRM 联系人记录。

WhatsApp 企业检查器 (ws_business)

此检查确认注册情况并识别账户是否使用 WhatsApp Business，返回 business 布尔值。这有助于团队在数据摄取阶段将 B2B 联系人与标准消费者账户进行细分。

集成 WA Lookup API

将 WA Lookup API 集成到您的 CRM 或数据管道中需要一个简单的 HTTP 请求。该平台使用同步 API 架构，这意味着结果在与初始请求相同的 HTTP 响应中返回，而不是异步交付。 要执行检查，请向 POST /api/v1/check 端点发送请求。请求必须包含用于身份验证的 X-API-Key 标头和 Content-Type: application/json 标头。 JSON 正文需要两个字段：

• service_type：设置为 ws、ws_avatar 或 ws_business。
• identifier：提交的电话号码，必须按照 E.164 国际编号计划格式化。 E.164 格式将全球拨号的电话号码标准化，通常包括加号 (+) 后跟国家代码、区号和本地用户号码。WA Lookup API 要求以严格的 E.164 格式提交号码，以便准确处理请求。 每次检查响应都包含标准字段，包括 id、identifier、registered、transaction_id、status、service_type 和 charged_amount_micros。由于结果是同步的，开发人员可以立即使用返回的 JSON 来更新 CRM 记录、路由潜在客户或标记需要人工审查的号码。

基于账户存在信号路由记录

一旦同步 API 返回账户存在信号，数据运营团队就可以使用 JSON 响应来指导下游路由。例如，如果 CRM 摄取了新的潜在客户列表，系统可以自动查询 POST /api/v1/check 端点。返回 registered 状态为正的号码可以被标记用于特定的外联活动，而未注册的号码可以路由到其他通信渠道。 使用 ws_business 服务类型时，工作流可以进一步分支。识别 WhatsApp 企业账户有助于团队将 B2B 联系人与标准消费者账户区分开来，从而支持更具针对性的沟通策略。同样，ws_avatar 检查可以通过将 avatar_url 附加到联系人记录来丰富 CRM 配置文件的视觉背景。通过将这些检查直接集成到数据摄取阶段，组织可以减少人工审查时间，并在其平台上保持更高标准的数据卫生。

管理成本与仪表板报告

WA Lookup 采用按次计费模式。所有三种 WhatsApp 产品使用相同的端点，所选的 service_type 决定了适用的余额成本。为了支持经济高效的数据管理，失败或未确定的检查将自动退还至您的账户余额。 新账户可以领取 $0.10 的试用余额，以便在扩展工作流之前测试注册、头像和企业账户检查。 WA Lookup 仪表板提供了用于管理集成的综合工具。管理员可以使用仪表板进行 API 密钥管理并监控可用余额。该界面还支持详细的检查历史记录、产品级报告以及近期检查的视图。为了帮助团队跟踪使用情况，仪表板会显示余额支出和 7 天趋势。产品级报告允许运营团队区分 ws、ws_avatar 和 ws_business 检查的使用情况，从而提高 API 消耗和 CRM 数据丰富化活动的可见性。

常见问题解答

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

这三者使用相同的同步端点，但根据 service_type 返回不同的字段。ws 检查返回注册状态。ws_avatar 检查增加了头像可用性，如果上游服务提供，还会返回头像 URL。ws_business 检查增加了一个布尔值，指示账户是否使用 WhatsApp Business。

WA Lookup 会检查用户当前是否在线吗？

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

失败的 API 请求在计费方面是如何处理的？

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