借助 Papo 的 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_…"
如何实际管理收件箱
- 在 Papo 面板中访问开发者/API 区域，并生成密钥。同时复制账户的公钥。
- 在每个请求中，使用密钥作为 Bearer token 进行身份验证。如果要加强验证，请在
X-Papo-Public-Key请求头中发送公钥。 - 要列出收件箱，请调用收件箱列表端点。响应会包含每个收件箱的标识符、已配置渠道和其他属性，让您可以在创建新收件箱之前映射已有内容。
- 要创建新收件箱，请发送包含所需渠道信息的 JSON payload——例如 WhatsApp（Meta 官方 API）、Instagram、电子邮件或 Telegram。包括收件箱名称以及应有权访问的坐席标识符。请查阅官方文档，了解字段和可接受值的准确格式。
- 创建后，收件箱会立即在面板中可用，并在渠道连接完成后开始接收消息（对于需要配对的渠道，如 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。那里有收件箱和其他资源的身份验证、参数、响应和代码示例的详细信息。
另请阅读
创建免费账户，无需打开面板即可通过 API 集成渠道。