什么是静默平台注册检查

本指南全面介绍了静默平台注册检查，解释了它们如何在不通知账户所有者的情况下提供同步的可达性信号。

静默平台注册检查是一种验证方法，用于确定提交的电话号码当前是否在特定消息平台上注册，且不会提醒账户所有者、发送消息或要求用户交互。组织在发起外联之前使用这些检查来确认号码在目标平台上是否处于活跃状态，从而帮助团队根据平台账户的存在情况对受众进行细分并规划沟通工作流。

定义静默平台注册检查

静默平台注册检查评估特定电话号码是否与消息平台上的账户相关联。“静默”一词指代其操作方法：检查直接查询平台目录，而不与终端用户的设备进行交互。系统不会发送短信、触发应用程序推送通知或提示用户进行身份验证。组织通过提交 E.164 标准格式的电话号码来发起检查。验证平台处理此输入并返回同步响应。由于工作流是同步的，结果会在发起的 HTTP 响应中直接交付，而不是通过异步回调或轮询机制。这种即时反馈循环允许应用程序根据账户存在信号做出实时路由决策。

静默检查与网络身份验证的区别

在设计沟通工作流时，组织通常会同时评估平台级检查和网络级检查。虽然两者在操作时都不会给用户带来干扰，但它们查询的是完全不同的基础设施层。静默网络身份验证 (SNA) 通常涉及运营商级的信令。它与移动网络运营商通信，以验证特定的 SIM 卡或设备当前是否在蜂窝网络上处于活跃状态。SNA 在很大程度上依赖于物理电信基础设施。相比之下，静默平台注册检查严格关注应用层的账户存在情况。它验证该号码是否在特定服务（如 WhatsApp）中注册。用户可能拥有一个有效的运营商号码，但并未在 WhatsApp 上注册；反之，他们也可能在 WhatsApp 上注册一个在传统蜂窝网络上不存在的 VoIP 号码。

理解可达性信号

注册信号确认提交的 E.164 号码当前与目标平台上的账户相关联，这意味着平台的基础设施能够接收发送至该标识符的消息。它作为一种基础工作流输入。通过确认可达性，该信号有助于团队高效分配资源，确保仅针对确实拥有相应应用程序账户的号码生成平台特定消息。

注册信号的操作用例

组织将静默平台注册检查集成到各种操作工作流中，以支持数据清理和沟通规划。

受众细分

营销和销售运营团队使用注册信号根据平台可用性对联系人列表进行细分。通过识别哪些联系人在 WhatsApp 上可达，团队可以定制外联策略，将富媒体营销活动定向发送给平台用户，同时为没有应用程序账户的联系人保留标准短信。

全渠道路由

客户支持平台利用同步检查来通知消息路由。当客户发起支持工单时，系统可以立即检查提供的电话号码。如果号码返回正向的平台注册信号，系统可以通过消息应用路由后续通知；否则，则默认使用电子邮件或短信。

CRM 数据清理

数据库管理员使用批量检查定期审计遗留的 CRM 记录。此过程有助于组织维护准确的记录，了解哪些联系人仍保持活跃的平台注册，从而支持更好的分析和更准确的营销活动规划。

API 集成与同步工作流

技术团队使用同步 REST API 实现静默平台注册检查。记录在案的请求契约使用 POST /api/v1/check 端点。请求需要 X-API-Key 标头进行身份验证，以及 Content-Type: application/json 标头。JSON 有效负载必须包含两个主要字段：service_type（指定正在查询的特定产品）和 identifier（包含 E.164 格式的目标电话号码）。API 架构是严格同步的。每个检查端点都在发起的 HTTP 响应中返回其结果。已完成检查的外部响应包由 code、msg 和 data 组成。如果系统无法判定检查结果，API 将返回非零的业务代码，而不是已完成的结果对象。对于更高容量的操作，平台提供同步批量端点。该端点在单个请求中最多可接受 100 个标识符。它同步处理整个批次并在一个响应中返回完整的结果集，避免了任务提交、轮询或回调工作流的复杂性。

WhatsApp 特定检查类型

在查询 WhatsApp 注册状态时，组织可以使用 service_type 参数从三种不同的检查类型中进行选择。这三种产品均使用相同的同步端点，service_type 控制在公共 data 对象中返回哪些字段。

标准注册检查 (ws)

ws 服务类型提供基准平台注册信号。返回的数据对象包含 service_type、identifier 以及指示账户存在情况的布尔值 registered 字段。

头像丰富化检查 (ws_avatar)

ws_avatar 服务类型包括基准注册信号并添加个人资料丰富化数据。响应包括一个 avatar 布尔值和一个 avatar_url 字符串。URL 字段提供个人资料图像的位置，尽管根据账户的配置，它可能返回为空字符串。

商业资料检查 (ws_business)

ws_business 服务类型检查标准注册，并评估账户是否使用 WhatsApp Business 应用程序。响应在标准数据对象中附加了一个 business 布尔值，帮助团队区分标准用户和商业账户。

模型上下文协议 (MCP) 集成

对于利用 AI 驱动工作流的团队，静默平台注册检查可以直接通过 AI 助手执行。WA Lookup 在网站的 /mcp 路径上通过 Streamable HTTP / JSON-RPC 提供官方模型上下文协议 (MCP) 服务器。此集成允许支持 MCP 的 AI 客户端（如 Claude Code、Cursor 和 Claude Desktop）使用组织现有的 API 密钥执行实时检查。MCP 服务器共享与标准 REST API 完全相同的产品、余额、身份验证、并发限制和同步结果语义。向 AI 助手公开的工具包括列出可用产品、检查单个 E.164 号码、同步检查最多 100 个号码的小批量数据以及查询账户余额。由于 MCP 调用是实时且同步的，它们可以无缝集成到对话式 AI 工作流中，而无需异步任务管理。

常见问题解答

静默平台注册检查返回什么？

对于 WhatsApp，该检查确认提交的 E.164 电话号码当前是否与 WhatsApp 账户相关联。

注册检查的电话号码格式要求是什么？

所有提交的电话号码必须按照 E.164 标准进行格式化。这确保平台能够在同步请求期间准确解析国家代码和用户号码。

组织可以一次检查多个号码吗？

可以。API 提供了一个同步批量端点，在单个请求中最多可接受 100 个标识符。系统处理整个批次并在同一个 HTTP 响应中返回完整的结果集。

如果检查无法判定结果会怎样？

如果系统无法确定注册状态，API 将返回非零的业务代码，而不是已完成的结果对象。计费按次计算，失败或无法判定的检查将自动退款。