注册并联系客服,免费领取 100 次检测。免费注册
WA Lookup 工作流示意图:如何检测号码是否使用 WhatsApp 商业账号
本文所述工作流的示意图(WA Lookup)。

了解如何通过实时检测和批量检测来验证电话号码是否使用 WhatsApp 商业账号,以支持沟通工作流程和受众细分。

为了检测电话号码是否使用 WhatsApp 商业账号,组织需要以国际格式提交号码至支持商业资料检测的验证服务。该检测会在请求时评估号码,确认该账号是否存在于 WhatsApp 上,以及其是否配置为商业账号。此账号存在性信号为沟通工作流程提供了背景信息,能够区分商业账号与标准个人资料,但不会验证法律层面的企业身份,也不会授予消息发送权限。

理解 WhatsApp 商业账号信号

WhatsApp 商业账号检测用于确认标识符是否在 WhatsApp 上注册,以及该注册资料是否配置为商业账号。

已记录的账号信号

在评估电话号码时,验证系统会区分标准平台注册与商业特定的资料元数据:

  • 标准注册检测 (ws): 在检测时评估提交的号码在 WhatsApp 上是否存在账号。
  • 头像检测 (ws_avatar): 确认账号存在,并在存在时报告头像可用性及头像 URL。
  • 商业账号检测 (ws_business): 返回账号存在信号,并指示该账号是否作为 WhatsApp 商业资料运行。

这些检测在查询时提供技术性的账号存在信号。

单个标识符的实时验证工作流程

实时验证同步评估单个电话号码或小批量号码。此设置适用于入站线索路由、联络中心查询和即时表单验证。

单个及小批量请求流程

  1. 格式化号码: 使用 ITU-T Recommendation E.164 定义的国际公共电信格式标准化标识符,并在号码前加上国家代码,总长度不超过 15 位数字。
  2. 选择服务类型: 指定商业检测服务 (ws_business) 以检索平台注册状态和商业资料状态。
  3. 发起请求: 通过 Web 控制面板或使用授权的 API 密钥通过 POST /api/v1/check 提交标识符。
  4. 评估直接响应: 系统在初始响应中提供结果。完成的检测将返回注册状态和商业标志。

对于小规模的多号码需求,同步批量端点 (POST /api/v1/batch-check) 每次请求最多可接受 100 个号码,并在同一响应中返回所有结果。此外,Web 控制面板界面最多可容纳 500 个粘贴的号码以供即时查看。

批量列表的异步处理

当组织管理用于受众细分或数据库清理的大型数据集时,异步批量任务提供了结构化的文件处理方式。

批量任务提交工作流程

  1. 准备数据文件: 以 TXT 或 CSV 格式构建文件,每行一个标识符。批量文件必须代表同一个国家/地区。预检查验证会拒绝其中 10% 或更多标识符属于其他国家/地区的文件。
  2. 上传文件: 通过 Web 控制面板或调用 POST /api/v1/bulk-tasks 提交数据集,使用异步商业批量服务 (ws_business_batch)。适用各产品的容量限制,团队可在当前的 API 文档中查看。
  3. 监控进度: 初始提交会返回一个唯一的任务标识符。系统通过 GET /api/v1/bulk-tasks/{id} 监控任务进度。
  4. 下载完成结果: 处理完成后,平台会生成一个可下载的 CSV 文件,其中包含每个提交行的账号存在性和商业资料指标。

批量处理在特定的地理边界内运行。实时单号码检测支持中国大陆 (+86)、香港 (+852) 和澳门 (+853) 的少量业务,但批量文件任务不支持这三个地区。

账号配置与合规边界

将商业账号检测集成到运营路由中,需要明确理解计费行为和消息合规性。

余额分配与对账

已注册和未注册的已完成检测均会消耗账户余额。对于异步批量任务,平台会在文件提交时根据提交的记录数量预留账户余额。任务完成后,任何未使用的预留余额将自动退回至账户余额。如果批量任务处理失败,所有预留余额将被释放。

监管与消息政策考量

商业账号标志确认了账号在平台上的配置方式,但它具有运营边界:

  • 消息发送许可: 验证不能满足监管或平台的许可要求。根据 WhatsApp Business Messaging Policy,组织在联系任何用户之前必须获得明确的 opt-in 许可。
  • 数据最小化: 根据 GDPR 第 5(1)(c) 条,处理个人数据必须保持充分、相关且仅限于特定运营目标所必需的范围。

理解这些边界可确保组织利用账号存在性数据来指导内部工作流程路由,同时保持合规性。

常见问题解答

WhatsApp 商业账号检测是否验证公司的法律地位?

不验证。该检测返回平台特定的账号存在性和资料信号,指示账号在检测时是否使用 WhatsApp 商业账号。

团队可以验证任何国家的电话号码以获取商业账号状态吗?

实时单次检测支持全球号码,包括中国大陆 (+86)、香港 (+852) 和澳门 (+853) 的少量业务,但台湾地区的覆盖范围尚未确认。批量文件处理不支持中国大陆、香港或澳门的号码。

实时检测和批量任务在运营上有什么区别?

实时检测同步运行,直接在初始响应中返回注册和商业信号。批量任务异步处理文件,提交时返回任务 ID,并在处理完成后提供可下载的结果 CSV。

识别出 WhatsApp 商业账号是否意味着可以向收件人发送消息?

不意味着。识别账号类型仅提供可触达性信号,并不能满足消息发送许可。根据 WhatsApp Business Messaging Policy,企业在发起外联之前必须收集直接的 opt-in 许可。

了解更多

选择符合您工作流程下一步的产品信息。

参考来源