要通过 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
- 准备端点： 确保 URL 接受 POST 并可公开访问。端点应返回 HTTP 2xx 状态以确认接收。
- 在 Papo 面板中，进入 Webhooks 区域： 找到创建新原生 Webhook 的选项。
- 填写字段：
- 回调 URL： 粘贴你的端点地址。
- 事件： 选择要监控的事件——例如“对话已创建”、“业务已更新”、“联系人已创建”。
- 格式： 负载以 JSON 发送，包含受影响对象的字段。
- 保存并激活： 从此刻起，所选事件每次发生都会触发通知。
通过 Flows 配置 Webhook
如果你需要更多控制（按条件过滤、仅发送部分字段或串联操作），请使用 Flows 模块：
- 创建一个新 Flow，并用所需事件定义触发器（例如“业务已创建”）。
- 添加一个 Webhook 操作。
- 填写 URL，并将方法保持为
POST。 - 在消息正文中，用事件变量组装 JSON（例如
{{deal.name}}、{{deal.value}}）。 - 保存并激活 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 集成到你的系统中。