返回全部文章

Product guidance

在 ws、ws_avatar 和 ws_business 之间进行选择

WA Lookup 的三种 WhatsApp 检查均使用同一个同步调用,区别仅在于 service_type 的值。以下是如何选择正确选项的指南。

WA Lookup Product Documentation发布于 2026年8月6日2 分钟阅读
WA Lookup workflow illustration for 在 ws、ws_avatar 和 ws_business 之间进行选择
A visual overview of the workflow discussed in this WA Lookup article.

WA Lookup 通过单一调用提供三种 WhatsApp 检查。在它们之间进行选择,取决于您的工作流程实际需要读取哪些字段,而不是能力层级的差异。

WA Lookup 的三种 WhatsApp 检查均使用 POST /api/v1/check,区别仅在于 service_type 的值:ws 返回注册状态字段,ws_avatar 在此基础上增加了头像和头像 URL,而 ws_business 则增加了商业账户布尔值。

当单一字段即可决定结果时选择 ws

如果您的工作流程下一步仅根据是否存在 WhatsApp 账户进行分支,那么 ws 返回的信息恰好满足需求,且不会包含您不需要读取的内容。在这种情况下选择更丰富的 service_type 会增加每次调用的成本,而不会改变您代码所做的任何决策。

当个人资料可见性很重要时选择 ws_avatar

当下游流程需要读取头像字段时,请选择 ws_avatar:例如对潜在客户队列进行排序、丰富 CRM 记录或为审核人员提供额外背景信息。区分的关键在于是否有任何代码或人员会查看头像值。如果没有,ws 是更好的选择。

当账户类型决定路由时选择 ws_business

ws_business 增加了商业账户布尔值,适用于将商业账户与其他账户区别对待的工作流程。与 ws_avatar 一样,判断标准是该字段是否会影响决策——如果字段被返回却被忽略,则纯属成本浪费。

按调用选择而非按集成选择

由于 service_type 是同一个调用中的请求体参数,因此一个集成可以在不同的列表或不同的阶段选择不同的检查方式。团队通常会先对大型列表运行 ws,然后对重要的子集运行更丰富的 service_type,这样可以将支出与每个阶段的价值保持一致。

常见问题解答

这三种检查使用不同的 URL 吗?

不。这三种检查均使用 POST /api/v1/check,并通过请求体中的 service_type 值进行选择。

一个集成可以混合使用不同的服务类型吗?

可以。service_type 是每个请求的请求体参数,因此不同的列表或阶段可以通过同一个集成选择不同的检查方式。

ws_avatar 是否包含 ws 返回的内容?

是的。它会返回注册状态字段,并在其基础上增加头像字段。

参考来源