API用于号码检查商业账户V2

您需要自动验证一个电话号码是否在WhatsApp上，特别是它是否是WhatsApp商业账户。在本指南结束时，您将能够访问一个生产就绪的端点，该端点可以回答这两个问题，并将其集成到您的入职流程、潜在客户验证、内部CRM检查或反欺诈规则中——本周。

您可以使用此API构建的内容

WhatsApp号码检查API验证一个电话号码是否在WhatsApp上注册，以及它是否与WhatsApp商业账户相关联。典型的用例包括：

• 在启动WhatsApp通知之前验证客户联系数据。
• 路由潜在客户：优先考虑在WhatsApp上活跃或属于商业账户的号码。
• 执行联系规则：避免尝试向不符合条件的号码进行WhatsApp联系。
• CRM丰富：标记具有WhatsApp和商业账户状态的记录。

它可在 Zyla API Hub 上获得，这是一个API市场，提供超过10,000个公共API，使用一个账户、一个API密钥和订阅+配额模型（不是按调用计费）。WhatsApp号码检查API支持7天试用或50个请求——请查看API页面以获取当前访问选项和定价。

在Zyla API Hub上开始

要开始调用端点：

1. 打开API页面并开始您的试用： 开始WhatsApp号码检查API的7天试用。
2. 订阅并从您的仪表板获取API密钥。
3. 在每个请求中添加Authorization: Bearer YOUR_API_KEY头。

您可以在 zylalabs.com 浏览和订阅其他API，使用相同的账户和密钥。

您将使用的端点

1) 号码检查商业账户V2

方法： GET
URL： https://zylalabs.com/api/926/whatsapp-number-checker-api/18773/number-checker-business-acount-v2
描述： 快速识别一个电话号码是否对应于WhatsApp商业账户。
所需查询参数： phone (string)。示例：34605797764

curl示例：

curl -s -X GET "https://zylalabs.com/api/926/whatsapp-number-checker-api/743/number-checker?number=972508623456" \
-H "Authorization: Bearer YOUR_API_KEY"

示例响应：

{
"id": 12574,
"status": true,
"numberstatus": true,
"businessnumber": false
}

如何使用：

• 以国际格式发送电话号码，不带加号或空格。
• 检查与“phone”键相关联的响应值。在上面的示例中，该号码不是WhatsApp商业账户。

2) 号码检查

方法： GET
URL： https://zylalabs.com/api/926/whatsapp-number-checker-api/743/number-checker
描述： 输入带有国家代码的电话号码，但不带+号。该端点将告诉您该号码是否在WhatsApp上。示例格式：14083742784
所需查询参数： number (number)。示例：972508623456

curl示例（官方示例）：

JSON响应（官方示例）：

字段说明：

• id：此检查的内部参考。
• status：整体请求状态。
• numberstatus：该号码是否在WhatsApp上。
• businessnumber：该号码是否是WhatsApp商业账户。

Python中的端到端示例

下面的代码片段检查一个电话是否是WhatsApp商业账户，使用号码检查商业账户V2端点。将YOUR_API_KEY替换为您的实际密钥。

import requests

API_KEY = "YOUR_API_KEY"
phone = "34605797764" # 国际格式，无加号

url = "https://zylalabs.com/api/926/whatsapp-number-checker-api/18773/number-checker-business-acount-v2"
headers = {"Authorization": f"Bearer {API_KEY}"}
params = {"phone": phone}

resp = requests.get(url, headers=headers, params=params, timeout=15)
resp.raise_for_status()
data = resp.json()

# 示例响应: {"phone":"Not a Business Account"}
status_text = data.get("phone", "")
is_business = status_text and status_text.lower() != "not a business account"

print(f"输入: {phone}")
print(f"商业账户? {'yes' if is_business else 'no'}")

节省时间的实施细节

• 输入格式：始终包括国家代码，并省略+号和空格。例如，使用14083742784或34605797764。
• HTTP方法：两个端点都是简单的GET请求，带有查询参数。
• 认证：始终包括Authorization: Bearer YOUR_API_KEY。
• 同步检查：每个调用立即返回结果；您可以在表单提交或夜间批处理作业期间按需验证。
• 错误处理：根据您的系统适当处理非2xx响应的重试或回退。记录输入和响应有效负载以进行诊断。
• 缓存：如果您的工作流程频繁检查相同的号码，请短时间缓存结果以减少延迟并减少冗余调用。
• 订阅模型：访问是订阅+配额（不是按调用计费）。第一个API提供7天试用或50个请求。没有免费计划。请查看列表页面以获取当前详细信息。

现实世界的集成模式

• 潜在客户捕获验证：在表单提交时，调用号码检查以确认该号码是否在WhatsApp上。如果是，并且您需要商业联系，请调用号码检查商业账户V2（或在您的流程中可用时从号码检查响应中读取businessnumber）以确认潜在客户。
• 入职路由：对于与商家互动的市场，确保注册的电话号码属于WhatsApp商业账户，以简化通过WhatsApp渠道的支持和入职。
• CRM丰富：夜间作业遍历未验证的联系人，检查WhatsApp和商业状态，并标记记录以进行下游自动化（例如，仅对符合条件的号码启用WhatsApp模板）。
• 合规性保护：如果您的政策禁止向某些外展的非商业号码发送消息，请通过在商业账户V2检查上限制工作流程来强制执行。

通过MCP从AI代理调用此API

如果您希望通过AI代理（例如，在MCP兼容客户端内）调用API，您可以通过MCP端点和您的Zyla密钥路由您的调用。请参见此处的参考： MCP。向客户端提供您的Zyla API密钥，并配置一个工具，该工具向所需的端点URL发出GET请求，并带有Authorization头。这使得您的代理能够在对话工作流程或代码操作期间按需验证WhatsApp号码。

操作说明

• 安全性：绝不要记录您的API密钥。使用环境变量或秘密管理器。
• 重试：为瞬态网络问题实现短期、有界的重试（例如，指数退避）。
• 可观察性：记录请求ID（如果在头或响应中存在）、输入号码（如果需要则进行哈希或掩码处理）和最终决策标志以进行故障排除。
• 测试：在推出之前，在分阶段使用一小组代表性号码（有效WhatsApp、有效非WhatsApp以及已知是商业账户与非商业账户的号码）。

快速参考

号码检查商业账户V2

• GET https://zylalabs.com/api/926/whatsapp-number-checker-api/18773/number-checker-business-acount-v2
• 参数：phone (string, required)。示例：34605797764
• 结果：指示提供的号码是否为WhatsApp商业账户。

号码检查

• GET https://zylalabs.com/api/926/whatsapp-number-checker-api/743/number-checker
• 参数：number (number, required)。示例：972508623456
• 结果：返回包括numberstatus（WhatsApp存在）和businessnumber（商业状态）的字段。

常见问题

问：我应该使用什么输入格式来输入电话号码？
答：使用国际格式，带有国家代码，不带加号和空格（例如，34605797764）。

问：我如何进行身份验证？
答：在每个请求中包含Authorization: Bearer YOUR_API_KEY头。

问：哪个端点告诉我一个号码是否是WhatsApp商业账户？
答：使用GET https://zylalabs.com/api/926/whatsapp-number-checker-api/18773/number-checker-business-acount-v2，带有phone参数。您还可以在您的流程中检查号码检查响应中的businessnumber字段。

问：我可以在承诺之前测试API吗？
答：可以。该列表支持7天试用或50个请求。请查看API页面以获取当前访问选项和定价。

问：我可以从AI编码代理调用这个吗？
答：可以。使用MCP兼容的设置，并通过上述引用的MCP端点路由请求，提供您的Zyla API密钥。

如果您准备将其连接到您的表单验证、CRM或消息流中，请从这里开始： 开始WhatsApp号码检查API的7天试用。一个账户和一个API密钥立即解锁调用，您可以从同一仪表板扩展到Zyla目录的其余部分。