**借助 [Papo](https://papo.global/) 的 REST API，您可以列出已有的收件箱，并为 WhatsApp、Instagram 等渠道创建新连接——全部通过经过身份验证的请求完成，无需打开面板。这是以编程方式配置服务渠道、集成外部系统，并让多渠道运营与自动化保持一致的途径。**

Papo API 公开了收件箱资源，可用于查询当前配置并添加新渠道。由此，IT 团队、集成商和 white label 经销商能够批量管理连接、在账户之间复制设置，并自动化渠道激活，而无需依赖界面。

## 通过 API 管理收件箱的操作摘要

| 操作 | 作用 | 使用场景 |
| :--- | :--- | :--- |
| 列出收件箱 | 返回账户的收件箱，包含关联渠道（WhatsApp、Instagram、电子邮件等）和配置详情。 | 审计活跃渠道、与监控系统同步，或准备迁移。 |
| 创建收件箱 | 创建新的收件箱，定义渠道、名称以及可访问的坐席。 | 在集成新客户、单位或品牌时自动配置渠道。 |

## API 身份验证如何工作

所有 API 调用（包括列出收件箱）都需要账户的**密钥**。它必须作为 Bearer token 在 `Authorization` 请求头中发送。账户的**公钥**是可选的，但如果发送，则必须与密钥属于同一账户。

API 的基础 URL 是 `https://app.papo.global/api/v1`。密钥在 Papo 面板的开发者区域生成。密钥在创建时仅显示一次；请将其保存在安全位置，如有泄露嫌疑请撤销。

要验证身份验证，您可以调用 `GET /api/v1/me` 端点，它会返回账户数据。身份验证模式与所有其他端点相同：

```
curl https://app.papo.global/api/v1/me \
  -H "Authorization: Bearer sk_live_…" \
  -H "X-Papo-Public-Key: pk_live_…"
```

## 如何实际管理收件箱

1. 在 Papo 面板中访问开发者/API 区域，并生成密钥。同时复制账户的公钥。
2. 在每个请求中，使用密钥作为 Bearer token 进行身份验证。如果要加强验证，请在 `X-Papo-Public-Key` 请求头中发送公钥。
3. 要**列出收件箱**，请调用收件箱列表端点。响应会包含每个收件箱的标识符、已配置渠道和其他属性，让您可以在创建新收件箱之前映射已有内容。
4. 要**创建新收件箱**，请发送包含所需渠道信息的 JSON payload——例如 WhatsApp（Meta 官方 API）、Instagram、电子邮件或 Telegram。包括收件箱名称以及应有权访问的坐席标识符。请查阅官方文档，了解字段和可接受值的准确格式。
5. 创建后，收件箱会立即在面板中可用，并在渠道连接完成后开始接收消息（对于需要配对的渠道，如 WhatsApp，API 会返回所需说明）。

由于 API 是 REST 并使用 JSON，任何支持 HTTP 的语言都可以用来将收件箱管理集成到脚本、自动化工具（如 n8n）或配置系统中。官方文档位于 `https://papo.global/pt/docs`，其中包含身份验证、参数、响应和代码示例的详细信息。

## 这种集成适合谁

- **为新单位、特许经营或品牌批量配置渠道的 IT 团队**，无需逐个访问面板。
- **希望为每个新客户自动化创建收件箱的 white label 经销商**，同时保持配置标准化。
- **在账户之间迁移或复制配置的运营团队**，使用列表进行审计，使用创建来镜像渠道。
- **将 Papo 连接到外部渠道管理系统的集成商**，确保服务环境自动反映变更。

## 常见问题

### 列出收件箱需要密钥吗？

是的。列出收件箱需要使用账户密钥进行身份验证，因为它会返回敏感的配置信息。模式与其他 API 调用相同：在 `Authorization` 请求头中发送 Bearer token。

### 我可以通过 API 为 WhatsApp 创建收件箱吗？

可以。创建收件箱时，您需要指定所需的渠道类型——包括 WhatsApp（Meta 官方 API）和其他支持的渠道。payload 必须遵循所选渠道的预期格式，具体请参阅官方文档。

### 可以通过 API 更新现有收件箱吗？

当前 API 允许列出和创建收件箱。要更改现有收件箱的配置（例如更换坐席或重命名），您可以使用 Papo 面板，或者如有必要，使用新参数重新创建收件箱。

### 创建时如何将坐席关联到收件箱？

在创建 payload 中，您可以提供应有权访问该收件箱的坐席标识符。这些 ID 可以通过团队和成员 API 获取。请查阅文档了解准确格式。

### 身份验证与其他 Papo 端点相同吗？

是的。所有访问账户资源的调用都使用密钥作为 Bearer token。公钥是可选的，如果发送，则必须属于同一账户。

### 在哪里可以找到确切的路径和 payload 格式？

在官方 API 文档中，地址为 `https://papo.global/pt/docs`。那里有收件箱和其他资源的身份验证、参数、响应和代码示例的详细信息。

## 另请阅读

- [如何使用 Papo API 管理团队和成员](/hc/papo/articles/how-to-use-papo-api-manage-teams-members)
- [如何使用 Papo API 创建和管理标签（tags）](/hc/papo/articles/papo-api-create-manage-tags-zh)

---

**[立即开始自动化您的连接 →](https://chat.papo.global/app/auth/signup?papo_lp=home&utm_source=lp&utm_medium=landing&utm_campaign=home&utm_content=start-free&papo_lp_v=start-free)**

创建免费账户，无需打开面板即可通过 API 集成渠道。