如何通过 Webhooks 将对话数据发送到 BI 系统

要将 Papo 中发生的对话元数据——例如客户姓名、渠道、消息文本和负责坐席——转发到商业智能工具，请使用 Papo Flows 中的“发送 Webhook”操作（https://papo.global/）。每当有新对话或收到新消息时，数据都会自动发送到配置的端点，用实时更新的信息为你的 BI 提供数据，无需手动导出。

通过这种集成，你可以将 WhatsApp、Instagram、电子邮件或其他渠道中的每次互动转化为仪表板、服务量报表、按渠道转化分析等的数据点。只需配置一个带有合适触发器的 Flow，并将 Webhook 指向你的 BI 平台或 Zapier、Make、n8n 等中间工具提供的 URL，或你自己的端点。

工作原理 – 分步说明

1. 在 BI 系统中准备端点

Papo 不会生成目标 URL——你需要一个能够接收并存储数据的服务。主要方式：

• 自动化平台（推荐）：Zapier、Make（Integromat）或 n8n 可以创建“Catch Webhook”，生成专属 URL，然后将收到的数据连接到 BI（Google Data Studio、Power BI、Tableau）或数据库。
• BI 直接 Webhook：某些环境（如 Power BI）支持通过 API 流式传输数据。在这种情况下，你需要按照平台说明公开一个端点。
• 自建后端：如果你有自己的 API，可以构建一个端点来处理数据并将其插入数据仓库。

2. 在 Papo 中创建带合适触发器的 Flow

进入 Flows 模块并创建新流程。用于向 BI 供数的最常见触发器是“新对话”——这样每个到达收件箱的新联系人都会在你的分析系统中生成一条记录。

你也可以使用 收到消息 触发器并配置筛选条件：

• 所有消息：任何互动都会触发 Webhook。
• 特定消息：仅当消息包含某个关键词、来自特定渠道等时才触发。

选择所需的收件箱（例如 WhatsApp、Instagram、电子邮件），以便只发送该渠道的对话。

3. 配置“发送 Webhook”操作

添加一个 Webhook 类型的操作节点并填写：

• URL：粘贴第 1 步获取的端点。

• HTTP 方法：保持 POST。

• 请求体（Payload）：定义要发送哪些对话数据。使用 Flow 中可用的变量，例如：

  {
    "nome_contato": "{{contact.name}}",
    "email_contato": "{{contact.email}}",
    "canal_origem": "{{inbox.name}}",
    "texto_mensagem": "{{message.text}}",
    "data_evento": "{{timestamp}}",
    "agente_atual": "{{agent.name}}"
  }
  

你可以包含对话上下文中的任何变量——请查阅 Flows 文档以查看所有选项。

如有必要，添加目标系统要求的请求头（headers），例如 Content-Type: application/json 或身份验证令牌。

4. 测试并激活 Flow

在投入生产前，先进行测试：

1. 使用测试 URL（例如 Webhook.site）代替最终 URL，并在配置的收件箱中触发一次对话。
2. 检查负载是否正确到达，包含所有预期字段和值。
3. 将 URL 替换为最终 URL 并激活 Flow。

从此刻起，每次对话（或消息，取决于触发器）都会自动触发 Webhook。

这种集成适合谁

• 数据分析师和 BI 人员，他们需要汇总服务指标，而不依赖手动 CSV 导出。
• 运营经理，他们希望获得按渠道显示对话量、高峰时段和坐席负载的仪表板。
• 营销和销售团队，他们希望将对话数据与 CRM 中的活动和漏斗进行交叉分析。
• 已经使用 Power BI、Tableau 或 Looker Studio 等工具的公司，他们希望用 WhatsApp 及其他渠道的真实数据为仪表板供数。

常见问题（FAQ）

我可以将哪些对话元数据发送到 BI？

你可以发送 Flow 上下文中可用的任何变量，例如联系人姓名、消息内容、来源渠道、电子邮件、电话、指定坐席和日期/时间。组合这些字段可以创建服务量、响应时间和线索来源报表。

我的 BI 没有原生 Webhook。如何集成？

最简单的方法是使用自动化平台（Zapier、Make、n8n）。这些工具会生成 Webhook URL，接收来自 Papo 的数据，然后通过现成连接器或 API 将其转发到 BI。这样你无需自行编写端点。

我能筛选哪些对话会触发数据发送吗？

可以。在 Flow 触发器中，可以选择特定收件箱并配置“特定消息”选项，定义关键词或其他条件。这样，只有符合筛选条件的互动才会触发 Webhook。

数据是实时发送的吗？

是的。配置的事件（新对话或收到消息）一发生，Webhook 就会触发，让你的 BI 几乎即时更新。

如果 Webhook 请求失败会怎样？

Papo 的 Flow 会记录错误。你可以查看 Flow 执行日志来识别失败，并且如果需要，可以配置回退操作（例如发送警报电子邮件），以确保不会丢失任何关键信息。

Webhooks 有使用限制吗？

Flows 和 Webhook 发送功能已包含在平台中。关于请求限制和数据量的具体信息（如有），会根据所购套餐在 Papo 网站或面板中展示。

另请参阅

• 如何通过 Webhook 将新联系人数据发送到 Google Sheets
• 如何将报表指标导出到外部电子表格

免费开始 →

在 WhatsApp 中集中管理客户服务，并用对话的真实数据为自定义仪表板供数，无需手动导出。