**要通过 Webhook 实时接收 Papo（https://papo.global/）的事件，你需要在 Papo 面板中使用原生 Webhooks 模块或 Flows 模块配置回调 URL。每当发生新对话、创建业务、更新漏斗阶段或新增联系人等事件时，Papo 都会向该 URL 发送 HTTP POST 通知，让你无需手动导出即可将 CRM 与外部系统集成。**

借助出站 Webhook，你的运营可以自动响应 CRM 中的变化。新线索可以在 Slack 中触发提醒，未回复的对话可以在你的管理系统中生成任务，已成交的业务可以更新销售仪表盘——一切实时完成，无需轮询或电子表格。

## 配置概览

| 步骤 | 要做什么 | 说明 |
| :--- | :--- | :--- |
| **1. 准备端点** | 创建一个能够接收带 JSON 负载的 HTTP POST 请求的公开 URL。 | 可以是 Zapier、Make 的 webhook、服务器脚本或无服务器函数。 |
| **2. 访问 Papo 中的 Webhooks** | 在 Papo 面板中找到 Webhooks 部分（原生或通过 Flows）。 | 具体菜单可能有所不同；该功能在你的账户中可用。 |
| **3. 创建 Webhook** | 填写目标 URL，选择应触发发送的事件，然后保存。 | 可以为多个事件创建一个 Webhook，也可以为每种类型分别创建。 |
| **4. 测试集成** | 生成测试事件（例如：创建联系人），并检查端点是否收到通知。 | Papo 会在事件发生后立即发送负载。 |
| **5. 处理数据** | 在你的系统中解析收到的 JSON，并执行所需操作（写入数据库、发送提醒等）。 | 负载格式遵循所选事件的结构。 |

## Papo 出站 Webhook 如何工作

Papo 提供两种向外部系统发送事件的方式：

- **原生 Webhooks：** 可直接在账户的 Webhooks 部分使用。你为 CRM 事件（如新对话、创建业务、更新联系人）创建订阅，Papo 会向配置的 URL 发送包含相关数据的 POST。
- **通过 Flows 的 Webhooks：** Flows 模块允许创建带有事件触发器和 Webhook 操作的可视化自动化。当你需要条件逻辑或在发送前转换数据时，它非常理想。

无论哪种情况，流程都一样：Papo 中发生事件 → 平台组装 JSON 负载 → 向回调 URL 发送 HTTP POST 请求 → 你的系统接收并处理通知。

## 配置原生 Webhook

1. **准备端点：** 确保 URL 接受 POST 并可公开访问。端点应返回 HTTP 2xx 状态以确认接收。
2. **在 Papo 面板中，进入 Webhooks 区域：** 找到创建新原生 Webhook 的选项。
3. **填写字段：**
   - **回调 URL：** 粘贴你的端点地址。
   - **事件：** 选择要监控的事件——例如“对话已创建”、“业务已更新”、“联系人已创建”。
   - **格式：** 负载以 JSON 发送，包含受影响对象的字段。
4. **保存并激活：** 从此刻起，所选事件每次发生都会触发通知。

## 通过 Flows 配置 Webhook

如果你需要更多控制（按条件过滤、仅发送部分字段或串联操作），请使用 Flows 模块：

1. 创建一个新 Flow，并用所需事件定义**触发器**（例如“业务已创建”）。
2. 添加一个 **Webhook 操作**。
3. 填写 **URL**，并将方法保持为 `POST`。
4. 在消息正文中，用事件变量组装 JSON（例如 `{{deal.name}}`、`{{deal.value}}`）。
5. 保存并激活 Flow。

这种方法与 Google Sheets 和 Power BI 集成中使用的相同，可以准确发送你的外部系统所需的数据。

## 可用于通知的事件

可触发 Webhook 的事件取决于你账户中启用的模块。最常见的事件包括：

- **对话：** 新对话开始、收到消息、对话分配给坐席。
- **CRM / Kanban：** 创建业务、业务移动到其他阶段、业务赢单或输单。
- **联系人：** 新增联系人、自定义字段更新。
- **坐席：** 状态变更、登录。

确切的事件列表可以在 Webhook 创建界面中查看，该界面会显示你的账户可用的选项。

## 这种集成对谁有用

- **运营团队**，需要将 Papo CRM 与 ERP、计费系统或 BI 工具同步。
- **开发者**，希望用自定义逻辑扩展平台，例如在 Slack 中触发通知或在帮助台中创建工单。
- **白标经销商**，需要实时监控客户活动以提供主动支持。
- **数据分析师**，无需依赖手动导出即可为实时仪表盘提供数据。

## 常见问题

### 配置 Webhook 需要技术知识吗？
是的，需要理解 HTTP 和 JSON 的概念，以便准备端点并解析负载。不过，Zapier 或 Make 等平台可以让你无需代码创建接收器。

### 我可以用 Webhook 监控哪些事件？
可用事件因账户模块而异。在 Webhook 创建页面，你可以看到完整列表。最常用的是创建对话、更新业务和新增联系人。

### Papo 提供测试 URL 吗？
不提供。回调 URL 必须是你控制的端点。你可以使用 webhook.site 等服务生成临时 URL 并验证发送。

### 我可以对多个事件使用同一个 Webhook 吗？
可以。在原生 Webhook 配置中，你可以选择多个事件。在 Flows 中，你可以创建多个触发器，或使用条件在同一流程中处理不同事件。

### 数据是实时发送的吗？
是的。Papo 中事件一发生，Webhook 就会立即触发。延迟仅取决于网络和你的端点处理速度。

### 如果我的端点没有收到通知怎么办？
检查 URL 是否可公开访问、是否接受 POST、防火墙是否阻止请求，以及 Webhook 是否在 Papo 中处于激活状态。你也可以使用 webhook.site 等调试端点进行测试。

## 另请阅读

- [如何将 Papo Webhook 与 Power BI 集成以创建实时仪表盘](/hc/papo/articles/integrate-papo-webhooks-power-bi-real-time-dashboards)
- [如何使用 Papo API 批量创建和更新联系人](/hc/papo/articles/how-to-use-papo-api-create-update-contacts-bulk-zh)

---

**[免费开始并配置你的 Webhook →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=receive-real-time-events-papo-webhook-outbound-zh&utm_content=zh_CN)**

首位用户免费，你可以测试实时事件发送，并零初始成本将 Papo 集成到你的系统中。