免费注册，立即获得 100 次免费检测。免费注册
WA Lookup
手机号查询同时返回注册状态和 WhatsApp 头像的示意图
头像检测会同时返回注册状态和公开头像（如有）。

WA Lookup 头像检测只需一个手机号，就能在同一次响应中返回它是否注册了 WhatsApp，以及它正在使用的公开头像——无需保存联系人，也无需打开 WhatsApp。

在 WhatsApp 应用中，您通常要先保存对方的号码才能看到其头像，而且前提是对方的隐私设置允许。在业务流程中——新线索、客服工单、配送联系人——把每个号码都存进手机既费时，又会留下大量不需要的联系人。

实时头像检测（ws_avatar）直接回答这个问题：这个号码是否在使用 WhatsApp？它此刻显示的公开头像是什么？本指南介绍其工作方式、返回内容以及随附的功能。

实时头像查询如何运作

  1. 提交一个号码，使用国际格式，例如 +12345678900。+ 号可省略；参见 ITU-T E.164 建议书。
  2. WA Lookup 在同一次请求中检测注册状态和头像。
  3. 在同一次响应中读取两项结果——无需排队、无需轮询、无需回调。

您可以在任何方便的地方运行它，检测内容相同，共用同一余额：

  • 首页演示——切换到 头像检测；无需账号，每日次数有限。
  • 控制台——打开 实时检测 并选择 WhatsApp 头像检测。头像会显示在结果旁边。
  • REST API：
curl -X POST "https://walookup.com/api/v1/check" \
  -H "X-API-Key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "service_type": "ws_avatar", "identifier": "+12345678900" }'

{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "ws_avatar",
    "identifier": "+12345678900",
    "registered": true,
    "avatar": true,
    "avatar_url": "<image url>"
  }
}

解读结果

字段 含义
registered: true、avatar: true、avatar_url 有值 该账号已注册 WhatsApp，并返回了公开头像。
registered: true、avatar: true、avatar_url 为空 已设置头像，但本次检测未能获取图片链接。
registered: true、avatar: false 该账号已注册 WhatsApp，但未返回公开头像。
registered: false 检测时未找到该号码对应的 WhatsApp 账号。

avatar_url 可能是空字符串，因此请结合 avatar 标志一起判断。无法判定的检测不会返回结果，而是返回非零的 code。

为什么有些已注册号码没有头像

WhatsApp 用户可以自行选择谁能看到自己的头像。如果用户将头像设为仅联系人可见、隐藏头像，或根本没有设置头像，就没有可返回的公开头像，此时即使账号已注册，结果也是 avatar: false。因此 avatar: false 绝不代表“未注册 WhatsApp”——注册状态始终单独通过 registered 返回。

每次查询都包含的功能

一次请求同时获取注册状态和头像

您无需先做注册检测、再查询头像。一次请求即可同时返回两项结果，一次调用就足以决定如何处理该号码。

无需保存联系人，无需登录 WhatsApp

检测在 WA Lookup 自有的基础设施上运行。您无需把号码保存到手机、无需登录 WhatsApp、无需扫描二维码，也无需安装浏览器插件。整个过程不涉及您自己的 WhatsApp 账号，因此查询头像不会给它带来风险。

不会通知号码所有者

查询不会向该号码发送任何消息、来电或通知，号码所有者也无法得知自己的头像被查询过。

控制台与 API 结果一致

控制台、API 以及同步多号接口（POST /api/v1/batch-check）运行的是同一种检测，并共用同一余额，因此您测试时看到的结果就是集成后收到的结果。

注册即送 100 次免费检测

新账号会自动获得 100 次免费检测，无需领取。由于头像检测的单号费用高于注册检测，同样的免费额度可完成的头像检测次数会更少；当前价格请见价格页面。无法判定的查询不会消耗余额。

头像查询的适用场景

  • 确认新线索。 如果头像与表单上的公司或个人相符，销售团队在首次跟进前会更有把握。
  • 客服与账号找回。 客服人员可以在讨论账号事宜前，将客户的 WhatsApp 头像与客户档案进行比对。
  • CRM 数据补全。 记录联系人是否有公开头像——并在您的政策允许时保存头像本身——有助于团队在工具中识别联系人。

请把头像当作参考信息，而不是证据：头像由账号持有人自行选择，并不能验证身份、号码归属，也不代表对方同意被联系。如需处理整份名单，可使用作为附加功能提供的异步批量头像检测。

保持适度

在许多司法管辖区，头像属于个人数据。根据 GDPR 第 5 条，请只收集实现目的所必需的数据：只需注册状态时，请使用注册检测（ws）；仅在保留政策允许的范围内存储头像；切勿利用头像查询监视普通个人。在进行任何外联之前，请按照 WhatsApp Business 消息政策的要求获取对方的明确同意（opt-in）。

常见问题解答

需要把号码保存为联系人才能看到头像吗？

不需要。头像检测仅凭手机号即可完成。

为什么已注册 WhatsApp 的号码没有返回头像？

该用户可能没有设置头像，或将头像设为仅联系人可见。此时结果会显示 registered: true 和 avatar: false。

号码所有者会知道自己的头像被查询了吗？

不会。查询不会向该号码发送任何内容。

可以一次查询多个号码的头像吗？

可以。少量号码可使用控制台中的 多号检测 或同步多号接口；整份名单可使用批量头像检测。当前限制请参阅 API 文档。

了解更多

无需登录即可试用头像检测，或注册账号获取 100 次免费检测。

参考来源