**要将 Papo (https://papo.global/) 的语音通话统计数据导出用于外部分析——无论是导出到 Excel、Google Sheets 等电子表格，还是导出到 BI 仪表板——你都应使用该平台的公共 API。“通话报告”模块提供详细的可视化和筛选器，但自动化、可编程的导出依赖 API 集成，该集成以 JSON 格式返回通话数据。**

Papo 将所有语音指标集中在一个原生面板中，包含总通话数、方向（呼入或呼出）、状态（已接听、未接听、忙线）、方式（PapoCall、WhatsApp 通话等）以及录音（如有）等信息。要将这些数据与其他来源结合、计算自有 KPI 或供给外部工具，推荐使用 API。

## 获取语音数据的方式概览

| 方法 | 适合场景 | 在 Papo 中如何运作 |
| :--- | :--- | :--- |
| **Papo API** | 定时查询、自定义仪表板和与电子表格/BI 集成 | REST 端点以 JSON 提供通话指标。你可以通过脚本、ETL 工具或连接器消费数据。 |
| **在通话报告中查看** | 临时分析、手动筛选和审计特定交互 | 原生模块显示历史记录、按方向/状态/方式的汇总，并允许收听录音，但没有直接下载 CSV 的按钮。 |

## 如何通过 API 导出通话统计

该平台提供有文档的 API，除其他资源外，还暴露语音数据。要将这些指标带入电子表格或仪表板：

1. **生成 API 凭据**  
   在 Papo 面板中，进入 API 设置并创建一对密钥（公钥和私钥）。将这些凭据保存在安全位置。

2. **查阅 API 文档**  
   登录后，官方文档会列出可用端点，包括返回通话统计的端点。在那里你会找到确切的 URL 格式、接受的参数（如 Unix 时间戳格式的 `since` 和 `until`）以及响应示例。

3. **构建请求**  
   概念示例：向语音统计端点发出一个使用你的密钥进行身份验证的 `GET` 请求，可能返回类似以下内容：

   ```json
   {
     "total_calls": 1250,
     "inbound": 800,
     "outbound": 450,
     "answered": 1100,
     "missed":  120,
     "busy":     30,
     "avg_duration_s": 145,
     "calls_by_method": {
       "papocall": 900,
       "wavoip":  300,
       "whatsapp": 50
     }
   }
   ```

   确切字段和结构取决于已记录 API 的版本。

4. **将数据导入你的工具**  
   拿到 JSON 后，你可以：
   - 在 **Google Sheets** 中，使用 Apps Script 脚本发起请求并自动填充单元格。
   - 在 **Excel** 中，使用 Power Query 导入 JSON 并构建可刷新表格。
   - 在 **BI 工具**（Looker Studio、Power BI、Tableau）中，通过 API/Web 连接器直接连接到端点。

5. **自动化更新**  
   为了让数据始终保持最新，可以安排脚本执行（例如 Apps Script 中的时间触发器），或在 BI 工具中配置更新例程。

## 这种导出对谁有用

- **数据分析师和 BI 人员**，需要将语音指标与 CRM、销售或营销数据交叉分析。
- **运营主管**，希望在外部仪表板中监控通话效率，比较团队和渠道。
- **财务管理者**，使用通话数据计算成本、佣金或活动 ROI。
- **白标经销商**，希望在自己的原生面板之外为客户提供个性化的语音报告。

## 常见问题

### “通话报告”模块能直接导出 CSV 吗？

不能。原生报告提供完整的历史记录和统计可视化，但不包含直接下载按钮。要将数据带到电子表格或仪表板，推荐使用 API。

### 我可以从 API 提取哪些语音指标？

API 返回与“通话报告”模块中显示的相同指标，例如总通话数、按方向（呼入/呼出）的分布、状态（已接听、未接听、忙线）、所用方式/提供商以及平均时长。确切字段见官方文档。

### 使用 API 需要会编程吗？

需要基本的 HTTP 请求知识（GET、身份验证、JSON 处理）。不过，许多工具（如 Google Sheets 通过 Apps Script，或 Zapier、Make 等自动化平台）可以让非技术用户简化这一过程。

### 我可以自动安排导出吗？

可以。完成集成后，你可以使用时间触发器（如 Apps Script 中的基于时间的触发器）或 ETL 工具的调度器，按每天、每周或自定义间隔更新数据。

### 提取的数据包含通话录音吗？

API 提供通话元数据（日期、时长、状态、坐席等），并且如果你使用的电话服务商启用了录音，端点可能包含音频 URL。录音本身是否可用取决于语音渠道的配置。

### 有没有办法实时接收数据？

API 查询是按需进行的（拉取）。对于需要实时通知的场景（如新通话事件），需要使用 webhook；不过，语音事件特定触发器的可用性应在平台的最新文档中确认。

## 另请参阅

- [如何使用 Papo API 列出会话并以编程方式发送消息](/hc/papo/articles/papo-api-list-conversations-send-messages)
- [如何导出漏斗摘要报告用于外部分析](/hc/papo/articles/how-to-export-funnel-summary-report-for-external-analysis-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)**

将 WhatsApp、Instagram、电子邮件和短信集中到一个收件箱，并用 AI 自动化你的客户服务。