要将 Papo (https://papo.global/) 报告中的指标导出到 Excel 或 Google Sheets 等电子表格，你可以使用平台的公共 API，或配置 webhooks 将数据实时发送到自动化工具。此集成可让你创建自定义仪表板，并在原生面板之外进行分析，结合对话信息、坐席表现和销售漏斗结果。
Papo 已提供完整的报告中心，包含服务量、SLA、转化率和坐席排名等视图。然而，有些场景需要将这些数据与内部电子表格交叉分析、计算专有指标，或整合多个来源的信息。与其手动导出，API 和 webhooks 可以自动化这一流程。
导出方式概览
| 方法 | 适用场景 | 在 Papo 中如何运作 |
|---|---|---|
| 报告 API | 定时查询和自定义仪表板 | REST 端点以 JSON 格式返回坐席指标和 CSAT；可由脚本或 ETL 工具消费。 |
| Webhooks | 实时接收事件（例如：新成交商机） | 每当发生特定事件时，Papo 会向配置的 URL 发送 HTTP 通知，例如 Kanban 中的商机被移动到“Ganho”。 |
| 手动导出（通过界面） | 快速的一次性分析 | 在 Reports 模块中，你可以查看和复制数据，但没有直接下载 CSV 的按钮。要导出更大数据量，推荐使用 API。 |
如何使用 Papo API 导出指标
Papo API 允许你以编程方式访问与报告中相同的数据。目前，可使用端点查询按坐席划分的绩效摘要和满意度指标（CSAT）。要在电子表格中消费这些数据：
-
生成 API 凭据
进入 Papo 账户的 API 设置，创建一对公钥/私钥。该过程详见文章 如何生成 Papo API 公钥和密钥。 -
选择消费工具
你可以使用带 Apps Script 的 Google Sheets、N8N 或 Zapier 等自动化平台，甚至使用 Excel 通过 Power Query 查询。关键是该工具能够发起经过身份验证的 HTTP 请求。 -
构建请求
概念示例：要获取按坐席划分的绩效，请对相应端点发起 GET 调用（确切文档可在 Papo API 门户中查看）。传入身份验证密钥，如需还可传入时间段参数（since和until，Unix 时间戳）。 -
将数据转换为表格
响应将是 JSON，包含resolved_count、sla_percentage和avg_first_response_time等字段。在电子表格中，将这些数据整理为列，如有必要，可用定时触发器自动更新。
包含端点、参数和示例代码的完整说明位于 Papo 官方 API 文档中，登录后即可访问。
如何使用 webhooks 实时填充电子表格
如果你需要立即捕获销售事件或对话更新，webhooks 是最佳选择。在 Papo 中，你可以配置目标 URL，当发生相关操作时，平台会向该地址发送通知，例如 Kanban 中的商机被移动到“Ganho”列。
要将其与电子表格集成：
-
通过自动化工具中转
由于 webhook 会将数据发送到某个 URL，你需要一个接收器来解释数据并将其插入电子表格。通过 webhook 将新联系人数据发送到 Google Sheets 的指南 解释了基本原理，可将其适配到销售事件。 -
在 Papo 中配置 webhook
在账户设置中，填写由中间工具（N8N、Zapier 等）生成的 URL。在那里你可以映射应触发发送的事件（例如“商机成交”）。 -
自动构建电子表格
每个新事件都会在电子表格中新增一行，包含商机金额、联系人、负责坐席和日期等数据。这样，你就能构建增量历史记录，用于漏斗和佣金分析。
这种导出适合谁
- 数据分析师和 BI 人员： 需要使用 Power BI 或 Google Data Studio 等工具，将服务指标与其他来源（ERP、外部 CRM）的数据交叉分析。
- 财务管理者： 希望基于 Kanban 的成交结果自动计算佣金。
- 已有外部仪表板的运营团队： 希望在不离开当前流程的情况下，用对话数据填充这些面板。
- 需要自定义报告的团队： 这些报告超出 Papo Reports 模块的标准模板。
Papo 是否提供 CSV 或 Excel 格式的报告下载按钮？
目前，Papo 的 Reports 模块没有直接导出为 CSV 或 Excel 的原生功能。将数据带到外部电子表格的推荐方式是通过 API，它以结构化且可更新的形式提供相同数据。
API 中提供哪些指标？
Papo 公共 API 提供端点，用于查询按坐席划分的绩效摘要（已解决对话、SLA 等）和 CSAT 调查回答（1 到 5 分）。官方文档列出了所有可用字段。
我可以导出销售漏斗（Kanban）数据吗？
可以。虽然所提供的参考材料中没有详细说明 Kanban 的特定端点，但你可以使用 webhooks 在商机被移动到“Ganho”时捕获事件，从而用金额和联系人填充电子表格。请查阅 API 文档以了解其他端点。
使用 API 需要会编程吗？
取决于你想要的自动化程度。Zapier 和 N8N 等工具允许以很少或无需编码的方式创建集成。对于更复杂的脚本，具备基本的 HTTP 请求和 JSON 处理知识就足够了。
在哪里可以找到完整的 API 文档？
包含端点、参数和示例的完整文档可在 Papo API 门户 (https://papo.global/docs) 中访问，登录平台后即可查看。
我可以使用 webhooks 填充 Google Sheets 吗？
可以。在 Papo 中配置一个 webhook，指向中间 URL（通过 N8N、Zapier 或 Apps Script），再由它将数据插入 Google Sheets。请参阅基础指南：如何通过 webhook 将新联系人数据发送到 Google Sheets。
另请阅读
- 如何生成 Papo API 公钥和密钥
- 如何通过 webhook 将新联系人数据发送到 Google Sheets
- 如何生成按坐席划分的月度生产力报告
- 报告概览：在 Papo 中哪里找到每项指标
将指标集中到电子表格中，进行高级分析，并基于数据做决策，无需依赖手动导出。