如何准备批量 WhatsApp 号码验证的数据

一份关于准备批量电话号码检查 CSV/TXT 文件、将标识符格式化为 E.164 以及检索同步账户存在信号的实用工作流程指南。

要执行批量电话号码检查 CSV/TXT 文件工作流程，您必须严格按照 E.164 国际编号标准格式化所有提交的标识符。在从列表中清除所有非数字字符和本地前缀后，您可以将这些号码提交给 WA Lookup 平台以检索账户存在信号。根据您的工作流程需求，您将选择以下三种服务类型之一：ws（用于基础注册状态）、ws_avatar（包含头像可用性）或 ws_business（用于识别 WhatsApp Business 账户）。该平台通过同步检查处理这些请求，这意味着每个提交号码的验证结果都会在同一个 HTTP 响应中立即返回。这种即时反馈支持高效的列表处理，并有助于团队在无需等待异步批处理完成的情况下查看账户存在情况。

理解 WhatsApp 验证信号

在准备批量电话号码检查 CSV/TXT 文件时，第一步是确定哪种账户存在信号支持您的特定工作流程。WA Lookup 提供三种不同的服务类型，均通过同一个同步端点访问。service_type 参数控制响应中返回的字段。

基础注册检查 (ws)

ws 服务类型用于确认提交的电话号码当前是否已在 WhatsApp 上注册。此检查返回一个 registered 字段，提供直接的账户存在信号。它为内部决策提供参考，帮助确定您的 CSV 或 TXT 文件中的哪些号码在检查时关联了平台账户存在信号。

头像丰富化检查 (ws_avatar)

ws_avatar 服务类型包含基础注册检查，并增加了个人资料丰富化功能。除了 registered 状态外，此检查还会返回一个指示头像可用性的 avatar 布尔值。如果上游服务提供，它还会返回一个 avatar_url 字符串。在审查用户资料时，此额外背景信息可作为其他检查之外的参考输入。

商业账户检查 (ws_business)

ws_business 服务类型在检查 WhatsApp 注册的基础上，识别该账户是否使用 WhatsApp Business。它返回一个 business 布尔值。此信号有助于团队通过区分标准账户和商业资料来细分列表，从而支持更具针对性的工作流程路由。

准备数据文件

处理批量电话号码检查 CSV/TXT 文件最关键的要求是正确的数据格式。WA Lookup 要求所有号码必须以 E.164 格式提交。E.164 是一种国际电话编号计划，为每个设备分配一个全球唯一的标识符。

要准备您的 CSV 或 TXT 文件：

1. 包含国家代码： 每个号码必须以相应的国际国家代码开头。
2. 移除格式字符： 从列表中剔除空格、连字符、括号以及任何其他非数字字符。
3. 省略前导零： 移除不属于国际拨号代码的任何本地中继前缀（通常是开头的零）。

例如，美国号码应格式化为以国家代码（例如 1）开头的连续数字字符串。确认您的整个批次符合 E.164 标准有助于避免在同步检查过程中出现格式错误。一个干净、标准化的输入文件对于检索每个提交号码的准确账户存在信号至关重要。

提交批次进行验证

一旦您的批量电话号码检查 CSV/TXT 文件格式正确，您就可以将标识符提交给 WA Lookup 平台。该平台利用同步检查流程，这意味着结果是在与请求相同的 HTTP 响应中返回的，而不是在稍后异步交付。

对于集成该服务的技术团队，记录的请求契约使用 POST /api/v1/check 端点。请求需要 X-API-Key 标头和 Content-Type: application/json 标头。JSON 正文必须包含 service_type（ws、ws_avatar 或 ws_business）和 identifier（E.164 格式的号码）。由于该端点是同步的，您的应用程序可以遍历 CSV 或 TXT 文件，提交每个号码并立即获得反馈。

WA Lookup 仪表板通过提供全面的 API 密钥管理和报告工具来支持此工作流程。用户可以监控余额、查看检查历史记录并访问产品级报告。仪表板还显示最近的检查、余额支出和 7 天趋势，使团队能够清晰地了解其验证活动。此外，该平台采用按次付费模式，失败或未确定的检查会自动退款，这意味着资源仅用于成功的查询。新账户还可以利用 0.10 美元的试用余额，在处理更大的列表之前测试注册、头像和商业账户检查。

解读结果

了解批量电话号码检查 CSV/TXT 文件的输出对于将数据集成到更广泛的系统中至关重要。每次成功的检查响应都包含特定字段：id、identifier、registered、transaction_id、status、service_type 和 charged_amount_micros。

registered 结果报告了在检查那一刻可用的 WhatsApp 状态字段。了解此账户存在信号的边界非常重要。

此外，验证过程不会检查在线状态、最后上线时间戳、消息历史记录或联系人同意情况。它也不会指示该号码是否可以成功联系或消息是否会被送达。该信号仅用于向您的内部数据库告知平台注册情况，在组织 CRM 或路由记录时，它可以作为其他检查之外的参考输入。

常见问题解答

电话号码所需的格式是什么？

所有电话号码必须严格以 E.164 格式提交。此国际编号计划要求包含国家代码，并移除所有非数字字符、空格和本地前导零。

我可以批量检查 WhatsApp Business 状态吗？

可以，通过选择 ws_business 服务类型，您可以同时检查基础注册状态以及该账户是否使用 WhatsApp Business。这将返回一个指示商业账户存在情况的特定布尔值。

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

不是，该平台使用同步检查流程。每个提交号码的验证结果都会在与请求相同的 HTTP 响应中立即返回，而不是异步处理和交付。

如果检查失败会怎样？

该平台采用按次付费的计费模式，任何失败或未确定的检查都会自动退还到您的账户余额中。