管理 WhatsApp 号码

打开 Numbers 查看您的 WhatsApp 号码、连接状态及其商业账户。要添加号码，请参阅连接您的号码。

Bird 中的 WhatsApp Numbers 页面，显示号码状态及其商业账户

检查连接状态

状态	操作说明
Preparing	等待 Bird 验证您工作区持有的号码。
Pre-verified	选择 Finish setting up 通过 Meta 完成连接。
Pending	等待 Bird 向 Meta 注册该号码。
Connected	您的号码已准备就绪，可以发送消息。
Failed	打开该号码查看失败原因。

对于 verification_code_not_received 或 verification_rate_limited，在号码页面选择 Try again。有关重试时间，请参阅预验证失败。对于其他设置失败，先断开失败的号码，然后重新连接。

查看已连接的号码

打开一个号码查看其 Quality rating、Messaging limit 和 Send rate。这些值来自 Meta。Not rated 表示 Meta 尚无足够的历史数据来评分该号码。

使用 Business profile 更新收件人看到的显示名称、描述、地址和头像。Activity 部分显示发送活动。

查看商业账户

在 WABA 列中选择账户，查看拥有该号码的 WhatsApp Business Account。

Bird 中的 WhatsApp Business Account，显示其审核状态、商业验证和账户详情

Business verification 影响对功能的访问，例如您自己的身份验证模板。
Marketing Messages API 显示 Meta 是否已接受该账户的营销投递优化。营销消息可在入驻前发送，但 GIF 消息头需要先完成入驻。
Last read from WhatsApp 显示 Bird 上次刷新这些详情的时间。

一个工作区可以拥有多个商业账户。请确认与您计划发送消息的号码关联的账户。

从 API 读取您的号码

使用具有 whatsapp_management 读取权限的 API 密钥。列出号码返回号码的游标分页结果：

for await (const number of bird.whatsapp.numbers.list({ limit: 25 })) {
  console.log(number.id, number.phone_number, number.status);
}

for number in client.whatsapp.numbers.list(limit=25):
    print(number.id, number.phone_number, number.status)

for number, err := range client.Whatsapp.Numbers.List(ctx, bird.WhatsappNumbersListParams{Limit: 25}) {
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(number.Id, number.PhoneNumber, number.Status)
}

foreach ($bird->whatsapp->numbers->list() as $number) {
    echo $number->getId(), ' ', $number->getPhoneNumber(), ' ', $number->getStatus(), PHP_EOL;
}

curl -sS "https://us1.platform.bird.com/v1/whatsapp/numbers?limit=25" \
  -H "Authorization: Bearer $BIRD_API_KEY"

读取号码可获取其状态、质量评级和发送限制。相关读取包括：

端点	返回内容
号码资料	描述、地址和网站。
号码事件	设置、状态、质量、限制和显示名称变更，按最新排列。
商业账户	工作区的 WhatsApp Business Account。
商业账户详情	账户审核、商业验证、营销入驻和 Meta 健康状态。

meta_synced_at 记录上次从 Meta 读取值的日期。默认号码上不存在该字段。meta_health_status 在 Bird 读取账户之前不存在。号码的 waba 包含 Meta 的账户 ID。

在设置过程中，status 可以是 preparing 或 awaiting_signup。next 字段描述下一步操作，finish_setup_url 打开浏览器步骤。事件 type 是开放枚举，因此请在不报错的前提下处理未知值。

使用仪表板或 CLI 连接、重命名或断开号码；这些操作不属于公共 API 或 SDK。CLI 的命令是 bird whatsapp numbers create|update|delete 和 bird whatsapp numbers profile update。创建连接会返回 finish_setup_url，因为 Meta 的授权步骤需要浏览器。

管理 WhatsApp 号码

检查连接状态

查看已连接的号码

查看商业账户

从 API 读取您的号码

接收消息

号码选项

后续步骤

相关资源