**要使用 Papo API（https://papo.global/）为白标转售客户生成消费与结算报告，您可以将账户列表、模块检查和收件箱端点与“报告”模块的定期导出以及计费门户的交易历史结合起来——无需逐账户手动核对，即可构建仪表板和结算表格。**

尽管当前 API 没有专门端点直接返回已消费消息数量或账单金额，但通过程序化交叉比对结构化数据（谁是客户、启用了哪些模块、有哪些收件箱）与对话和模板的 CSV 文件，可以构建详细且自动化的结算报告。

## 用于生成结算报告的资源摘要

| 资源 | 提供内容 | 如何帮助结算 |
| :--- | :--- | :--- |
| API – 列出账户 | 所有白标客户的 ID 和状态 | 识别每个应收到报告的客户 |
| API – 检查模块 | 每个账户的模块状态（WhatsApp 等） | 筛选出真正消耗积分的客户 |
| API – 列出收件箱 | 每个账户的收件箱标识符和名称 | 将每个收件箱关联到客户，并隔离消费数据 |
| 报告模块 – CSV 导出 | 该期间每个收件箱发起的对话量和发送的模板量 | 提供计算积分消耗的基础指标 |
| 计费门户（Stripe） | 客户购买积分和充值的记录 | 用产生的收入和已购余额补充结算 |

## API 与导出如何生成报告

在白标转售中，每个客户都是一个独立账户，通常拥有自己的收件箱（例如“WhatsApp – X 诊所”）。Papo API 通过超级管理员端点，可以列出所有账户、检查哪些模块已启用，并获取每个账户的收件箱。这些数据构成了消费的“谁”和“哪里”。而消费数字（消息、模板）来自“报告”模块，可按收件箱导出为 CSV。收费历史可在计费门户中查看，该门户是白标的，并保留您的品牌。

通过脚本、电子表格或 BI 工具将这三个支柱结合起来，您可以以程序化方式为每个客户构建结算明细，包括：
- 账户和收件箱标识；
- 该期间的对话和模板总数；
- 已消耗积分（根据 Meta 的价格表计算）；
- 订阅和已充值摘要。

## 自动化结算报告的分步指南

1. **获取超级管理员 API 令牌**  
   在您的白标转售面板中，生成可访问账户管理端点的凭据。

2. **列出所有客户账户**  
   调用返回您转售下账户的端点。这样您就能维护包含每个客户 ID 的最新目录。

3. **对每个账户检查已启用模块**  
   使用模块状态端点，确认 WhatsApp（或其他产生消费的渠道）是否已启用。这可以避免处理不活跃客户。

4. **列出每个账户的收件箱**  
   使用返回收件箱（id、名称和渠道）的端点，映射每个客户的消息来源。存储账户 ID 与收件箱 ID 之间的关系。

5. **导出对话报告**  
   在“报告”模块中，针对每个已识别的收件箱，选择所需期间并导出对话 CSV（其中包含发起的对话量和发送的模板量）。如果可以自动下载文件，此步骤可通过脚本定时执行。

6. **计算积分消耗**  
   将 CSV 与活跃客户列表结合，并应用 WhatsApp 积分定价。按客户和期间汇总，生成按账户划分的消费表。

7. **获取发票历史**  
   访问计费门户（Stripe，使用您的品牌）以获取每个客户的交易历史：积分购买、金额和日期。这些信息用实际收入补全结算报告。

8. **合并并分发**  
   在电子表格、PDF 或仪表板中生成最终报告——标明消费、已购积分、充值和应结算金额。该汇总可定期交付给客户。

## 这种自动化适合谁

- **白标转售商**，拥有数十或数百个客户，需要生成每月消费结算，而无需操作每个账户的界面。
- **代理机构和软件公司**，将 Papo 集成到自有计费系统，并希望用准确的使用数据为其提供数据。
- **已使用 BI 工具的运营方**，希望将消费数据与转售的其他指标（如平均客单价和复购率）交叉分析。

## 常见问题

### Papo API 会直接返回已消费的 WhatsApp 消息数量吗？
目前 API 没有专门端点返回余额或已消费消息数量。对话和模板量通过“报告”模块获取，该模块支持 CSV 导出。

### 我需要手动核对每个客户才能生成报告吗？
不需要。通过账户、模块和收件箱列表端点，您可以以程序化方式获得所有必要结构。CSV 导出流程可以定时或通过脚本执行，从而最大限度减少人工干预。

### 我可以自动化定期生成结算报告吗？
可以。使用调用 API 并访问导出文件的脚本，可以构建每月或按所需间隔生成结算的例程。限制在于您获取 CSV 的方式；“报告”模块允许定期导出数据。

### 如何将收件箱关联到特定客户？
使用收件箱列表端点，它会返回每个收件箱的 ID、名称和渠道。由于每个收件箱属于一个账户，只需将账户列表返回的账户 ID 与收到的收件箱进行交叉比对。您可以在脚本中创建固定映射。

### 计费数据呢，如何在没有界面的情况下访问？
计费门户（Stripe）显示每个客户使用您品牌的交易历史。对于程序化访问，可以从面板提取这些数据，或者如果可用，使用 Stripe 自身的报告。Papo 的账户管理 API 不返回发票。

### 这些端点需要特殊令牌吗？
需要。账户管理和收件箱列表端点需要超级管理员权限认证，白标转售商可在设置面板中生成。

## 另请参阅

- [如何使用 Papo API 监控白标转售的积分消费与账单](/hc/papo/articles/how-to-use-papo-api-monitor-white-label-reseller-credits-invoices)
- [如何通过 webhook 集成在 Power BI 中创建转售收入仪表板](/hc/papo/articles/how-to-create-white-label-reseller-revenue-dashboard-power-bi-webhook)

---

**[立即开始自动化您的结算报告 →](https://chat.papo.global/app/auth/signup?papo_lp=home&utm_source=helpcenter&utm_medium=article&utm_campaign=api-gerar-relatorios-consumo-repasse-clientes-white-label&utm_content=pt_BR)**

创建免费账户，无需信用卡，并访问 Papo API 来集成您的白标转售流程。