理解用于业务工作流的电话检查信号类别

了解如何解读不同的电话检查信号类别，包括 WhatsApp 注册、头像可用性以及商业账户状态，从而为内部审核流程提供参考。

电话检查信号类别提供了关于提交的电话号码在消息平台上状态的特定、即时数据。基础注册信号可确认账户是否存在，而头像可用性或商业账户状态等丰富信号则为内部审核提供了额外背景。这些信号是同步的决策支持工具，旨在为业务工作流提供参考。理解这些类别有助于团队有效地路由记录并优化其数据验证流程。

平台特定信号的作用

平台注册信号是一种验证检查，用于确认特定电话号码当前是否在 WhatsApp 等消息平台上注册。在现代数据运营中，企业依赖这些信号在检查时获取账户存在信息。这些信号并非独立的解决方案，而是与其他检查并列的输入项，用于支持优先级排序、细分潜在客户列表以及为内部尽职调查提供参考。 管理这些信号需要一个集中的运营中心。WA Lookup 仪表板通过提供 API 密钥管理、余额跟踪和检查历史记录等工具来支持此工作流。团队可以监控产品级报告、查看近期检查、分析余额支出并观察 7 天趋势。通过将这些平台特定信号集成到更广泛的工作流中，组织可以更好地了解提交号码的状态，并根据其内部业务逻辑路由记录。

区分信号类别

了解不同服务类型之间的区别，使团队能够在控制单次检查成本的同时获取细粒度数据。所有三款 WhatsApp 产品均使用同一个同步端点，其中 service_type 参数控制返回哪些字段以及适用哪种余额成本。

WhatsApp 检查器 (ws)

基础 WhatsApp 检查器旨在确认提交的电话号码是否在 WhatsApp 上注册。当使用 ws 服务类型发出请求时，API 仅返回 registered 字段。这提供了一个直接的账户存在信号，不包含额外的个人资料数据。

WhatsApp 头像检查器 (ws_avatar)

WhatsApp 头像检查器在基础注册检查的基础上增加了个人资料丰富信息。通过使用 ws_avatar 服务类型，响应中除了注册状态外，还包含一个 avatar 布尔值。如果上游服务提供，它还会返回一个 avatar_url 字符串。此信号有助于团队收集关于账户公开个人资料可用性的额外背景信息。

WhatsApp 商业检查器 (ws_business)

WhatsApp 商业检查器用于识别已注册账户是否使用 WhatsApp Business。使用 ws_business 服务类型提交请求，将返回注册状态并增加一个 business 布尔值。此特定信号为需要区分标准用户账户和商业资料的工作流提供参考。

技术实现与工作流

集成电话检查信号类别需要遵守特定的输入格式和 API 合约。首先，所有提交的电话号码必须采用 E.164 标准格式。记录在案的请求合约使用 POST /api/v1/check 端点。请求必须包含 X-API-Key 标头和 Content-Type: application/json 标头。JSON 正文需要两个字段：service_type（接受 ws、ws_avatar 或 ws_business）和 identifier（E.164 格式的号码）。 此工作流的一个关键点在于结果是同步的。验证结果在与初始请求相同的 HTTP 响应中返回，而不是异步交付或需要单独的轮询机制。每个检查响应都包含一组一致的字段：id、identifier、registered、transaction_id、status、service_type 和 charged_amount_micros。 从运营角度来看，计费采用按次付费模式。为确保成本效益，失败或无法确定的检查将自动退款。对于正在评估集成的团队，新账户可以领取 $0.10 的试用余额，在投入生产环境使用前测试注册、头像和商业账户检查。

解读结果以支持决策

虽然电话检查信号提供了有价值的背景信息，但必须了解其边界，以避免误读数据。注册结果报告的是检查时点可用的 WhatsApp 状态字段。它不会检查在线状态、最后上线时间、消息历史、同意情况或号码是否可被联系。 这些信号严格用于决策支持。团队应利用这些信号为内部路由、审核流程和数据清理工作提供参考，将其视为更广泛运营策略的一个组成部分，而非合规或用户验证的最终解决方案。

常见问题解答

注册检查和商业状态检查有什么区别？

基础注册检查确认提交的电话号码是否在 WhatsApp 上注册，仅返回注册状态。商业状态检查包含注册确认，并增加一个信号，指示该账户是否使用 WhatsApp Business。两者使用相同的端点，但所选的服务类型决定了返回的字段。

这些检查在 API 工作流中是如何处理的？

这些检查是同步处理的。请求会携带 E.164 格式的电话号码和所需的服务类型发送到 API 端点。验证结果在与初始请求相同的 HTTP 响应中返回，而不是异步交付。