格式验证与实时验证：您真正需要的是什么

本文对格式验证和实时电话验证进行了技术对比，详细说明了何时使用静态语法检查，以及何时实施同步平台注册信号。

格式验证用于检查提交的电话号码字符串是否符合预期的结构规则（例如 E.164 标准），而无需查询外部数据库。相比之下，实时电话验证会对特定平台执行同步检查，以确认该号码当前是否作为平台账户存在信号进行注册。虽然格式验证为初始输入清理提供了基本的数据卫生，但实时验证返回的账户存在信号有助于团队对列表进行细分，并为通信工作流提供参考。

理解格式验证

在将电话号码与实时平台进行核对之前，它必须在结构上是正确的。格式验证是一个本地的静态过程，用于评估号码的语法。此步骤可确保提交的字符串包含国际标准要求的正确国家代码、区号和数字长度。 例如，WA Lookup API 要求所有提交的号码必须采用 E.164 格式。在数据管道中运行格式验证步骤可确保尽早捕获格式错误的条目，从而减少不必要的 API 调用。此方法对于初始数据输入清理非常有效，但它无法确认该号码是否确实关联了消息平台上的注册账户。

实时平台验证的机制

实时验证通过直接查询平台超越了语法检查。此过程使用同步 REST API 来请求提交电话号码的当前注册状态。结果在与请求相同的 HTTP 响应中返回，使其适用于实时工作流集成。 WA Lookup 的记录请求契约涉及发送 POST /api/v1/check 请求。此请求必须包含 X-API-Key 标头以及一个 JSON 正文，其中包含 E.164 格式的电话号码和特定的 service_type。每个检查响应都包含标准字段，包括 id、identifier、registered、transaction_id、status、service_type 和 charged_amount_micros。由于检查是同步的，团队可以立即使用返回的账户存在信号来路由记录或更新 CRM 字段。

比较 WhatsApp 验证信号

在实施 WhatsApp 实时验证时，返回的具体信号取决于所选的检查类型。WA Lookup 通过单个同步端点提供三种不同的服务类型，允许团队根据其工作流需求定制请求。

• WhatsApp Checker (ws)：此检查确认提交的电话号码是否在 WhatsApp 上注册。它返回 registered 字段，提供基准账户存在信号。
• WhatsApp Avatar Checker (ws_avatar)：此检查包含基准注册状态，并添加了一个 avatar 布尔值。如果上游服务提供头像，它还会返回一个 avatar_url 字符串，支持个人资料丰富化工作流。
• WhatsApp Business Checker (ws_business)：此检查确认标准注册，并添加一个 business 布尔值，以指示该账户是否使用 WhatsApp Business。此信号有助于团队将商业联系人与标准账户区分开来。 所有这三种产品均采用按次付费模式，其中 service_type 控制返回哪些字段以及适用哪种余额成本。失败或无法确定的检查将自动退款。

决策框架：您需要什么？

在格式验证与实时电话验证之间进行选择，取决于您数据管道的具体阶段。 何时依赖格式验证：

• 在初始用户注册或网页表单提交期间，以捕获拼写错误。
• 将旧数据库标准化为 E.164 格式时。
• 作为启动任何实时平台检查之前的先决步骤。 何时实施实时验证：
• 当您的工作流需要账户存在信号来细分受众时。
• 当您需要使用 ws_business 检查来区分标准账户和商业账户时。
• 当需要进行个人资料丰富化时，利用 ws_avatar 检查来检索可用的头像 URL。 实时验证结果报告的是检查时可用的平台状态。此信号为内部决策提供参考，并与其他数据检查一起支持优先级排序。

管理验证工作流

集成实时验证需要对使用情况和性能有清晰的了解。WA Lookup 仪表板支持 API 密钥管理，允许管理员安全地配置其集成。 操作员可以监控余额、查看检查历史记录并访问产品级报告。仪表板提供了对近期检查、余额支出和 7 天趋势的洞察，为团队有效管理验证量提供了所需的背景信息。对于正在评估该平台的团队，新账户可以领取 $0.10 的试用余额，以便在扩展业务之前测试注册、头像和商业账户检查。

常见问题解答

实时验证请求是如何构建的？

记录的请求契约是带有 X-API-Key 标头的 POST /api/v1/check，以及包含 service_type（ws、ws_avatar 或 ws_business）和 identifier（E.164 格式的号码）的 JSON 正文。

实时验证结果是异步交付的吗？

不是，结果是同步的。账户存在信号在与请求相同的 HTTP 响应中返回，而不是异步交付。

每次检查响应中包含哪些字段？

每次检查响应都包含 id、identifier、registered、transaction_id、status、service_type 和 charged_amount_micros 字段。

不同检查类型的计费模式是如何运作的？

计费按次计算，所选的 service_type 控制适用的余额成本。失败或无法确定的检查将自动退款。