# 管理 WhatsApp 号码

打开 [**Numbers**](https://bird.com/dashboard/w/whatsapp/numbers) 查看您的 WhatsApp 号码、连接状态及其商业账户。要添加号码，请参阅[连接您的号码](/docs/guides/whatsapp/numbers/connect)。

![Bird 中的 WhatsApp Numbers 页面，显示号码状态及其商业账户](/images/docs/dashboard-whatsapp-numbers.png)

## 检查连接状态

<span id="what-a-numbers-status-means"></span>

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

对于 `verification_code_not_received` 或 `verification_rate_limited`，在号码页面选择 **Try again**。有关重试时间，请参阅[预验证失败](/docs/knowledge-base/whatsapp/pre-verification-failures)。对于其他设置失败，先断开失败的号码，然后重新连接。

## 查看已连接的号码

<span id="what-a-connected-number-shows"></span>

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

![Bird 中已连接的 WhatsApp 号码，显示其质量评级、消息限制、发送速率和 Business profile 标签页](/images/docs/dashboard-whatsapp-number-detail.png)

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

## 查看商业账户

<span id="the-business-account-behind-a-number"></span>

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

![Bird 中的 WhatsApp Business Account，显示其审核状态、商业验证和账户详情](/images/docs/dashboard-whatsapp-number-business-account.png)

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

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

## 从 API 读取您的号码

使用具有 `whatsapp_management` 读取权限的 API 密钥。[列出号码](/docs/api/reference/list-whatsapp-numbers)返回号码的游标分页结果：

**TypeScript**

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

Examples: [TypeScript](/zh-sg/wendang/guides/whatsapp/numbers/managing.ts.md) · [Python](/zh-sg/wendang/guides/whatsapp/numbers/managing.py.md) · [Go](/zh-sg/wendang/guides/whatsapp/numbers/managing.go.md) · [PHP](/zh-sg/wendang/guides/whatsapp/numbers/managing.php.md) · [cURL](/zh-sg/wendang/guides/whatsapp/numbers/managing.curl.md)

[读取号码](/docs/api/reference/get-whatsapp-number)可获取其状态、质量评级和发送限制。相关读取包括：

| 端点                                                              | 返回内容                                           |
| ----------------------------------------------------------------- | -------------------------------------------------- |
| [号码资料](/docs/api/reference/get-whatsapp-number-profile)       | 描述、地址和网站。                                 |
| [号码事件](/docs/api/reference/list-whatsapp-number-events)       | 设置、状态、质量、限制和显示名称变更，按最新排列。 |
| [商业账户](/docs/api/reference/list-whatsapp-business-accounts)   | 工作区的 WhatsApp Business Account。               |
| [商业账户详情](/docs/api/reference/get-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 的授权步骤需要浏览器。

## 接收消息

<span id="inbound-messages"></span>

发送到已连接号码的消息会显示在 [WhatsApp 日志](/docs/guides/whatsapp/message-log)中。[**Inbound** 指标](https://bird.com/dashboard/w/whatsapp/metrics/inbound)按号码显示接收量。每条入站消息会打开 [24 小时客服窗口](/docs/knowledge-base/whatsapp/customer-service-window)，允许自由回复。

## 号码选项

<span id="your-own-number"></span>
<span id="verification-on-a-number-bird-holds"></span>

对于工作区在 Bird 持有的号码，[连接您的号码](/docs/guides/whatsapp/numbers/connect)会展示自动验证和 Meta 设置流程。对于在其他地方持有的号码，选择 **I have my own number** 并自行接收 Meta 的 SMS 或语音验证码。对于已有注册，使用支持的迁移路径或符合条件的 Business 应用共存路径。仅当号码在 WhatsApp 上已设置 **Phone registration PIN** 时才需输入。

<span id="bird-managed-numbers"></span>

[默认号码](/docs/guides/whatsapp/numbers/default)无需连接自有号码即可发送受支持的模板。

## 后续步骤

- [发送 WhatsApp 消息](/docs/guides/whatsapp/sending-whatsapp)
- [选择模板](/docs/guides/whatsapp/templates)
- [查看 WhatsApp 日志](/docs/guides/whatsapp/message-log)

## Related resources

- [Connecting WhatsApp to Bird: from buying a number to a live channel](/learn/whatsapp/connecting-whatsapp-to-bird) (video)
- [What is the 24-hour customer service window on WhatsApp?](/explained/whatsapp/what-is-the-24-hour-customer-service-window) (answer)
- [WhatsApp message builder](/tools/whatsapp-message-builder) (tool)
- [WhatsApp](/whatsapp-api) (product)

[Get an implementation brief](/learn/workspace?topic=whatsapp)