**要将 Papo (https://papo.global/) 集成到 Zapier，你可以使用 Papo REST API 执行操作，并使用原生 webhooks 或 Flows 将 Papo 事件发送到 Zapier。这样，诸如新对话或 Kanban 中赢单等事件，就可以自动触发 Zapier 中连接的数百个应用中的操作。**

Papo 不依赖专用连接器来与 Zapier 配合：该平台提供 REST 端点，并允许创建 webhooks，而这些正是 Zapier 用来接收和发送数据的机制。本指南展示两个方向的连接：将 Papo 事件作为 Zapier 中的触发器，以及将 Papo API 调用作为操作。

## 集成概览

| 资源 | 作用 | 配置位置 |
| :--- | :--- | :--- |
| Papo REST API | 通过密钥认证；可列出账户、实例、联系人，发送消息并使用 AI | `https://app.papo.global/api/v1`，密钥在 `https://app.papo.global/developers` 面板中生成 |
| 原生 webhook | 将账户事件发送到配置的 URL | 自动化模块 |
| Kanban webhook | 将销售漏斗事件发送到配置的 URL | Kanban 模块 |
| Flows | 创建可视化自动化；例如新对话这样的触发器可以调用 webhook 操作 | Flows 模块 |
| Webhooks by Zapier | 接收 Papo 的 webhook，并触发数百个应用中的操作 | Zapier |

## 开始前你需要准备什么

- 一个可访问面板的 Papo 账户。
- 一个 Zapier 账户。
- 在 `https://app.papo.global/developers` 创建的 Papo API 密钥。
- 一个用于接收事件的 Zapier webhook URL。

密钥格式为 `sk_live_...`，并且仅在创建时显示一次。请将其保存在安全位置，因为它用于验证 API 调用。

## 双向集成如何工作

### 从 Papo 到 Zapier（触发器）

1. 在 Zapier 中，创建一个 Zap，并选择 **Webhooks by Zapier** 作为触发器，选项为 **Catch Hook**。Zapier 会生成一个专属 URL。
2. 在 Papo 中，创建一个原生 webhook、一个 Kanban webhook，或一个带 webhook 操作的 Flow。
3. 将 Zapier URL 粘贴到 webhook 或操作的目标字段中。
4. 配置应触发发送的事件。对于新对话，使用触发器为 **新对话** 的 Flow。对于漏斗事件，使用 Kanban webhooks。
5. 在 Zapier 中，添加所需操作：发送电子邮件、在表格中创建行、在其他 CRM 中登记线索、通知 Slack 频道等。

### 从 Zapier 到 Papo（操作）

1. 在 Zapier 中，使用 **Webhooks by Zapier** 作为操作，通常使用自定义请求。
2. 指向基础地址 `https://app.papo.global/api/v1`。
3. 包含 header `Authorization: Bearer sk_live_...` 或 `X-Papo-Secret-Key`，如果需要，还可包含 `X-Papo-Public-Key`。
4. 根据操作选择端点：`POST /api/v1/messages` 用于发送 WhatsApp 消息，`GET /api/v1/contacts` 用于列出 Extrator 联系人，`GET /api/v1/instances` 用于查询 WhatsApp 连接等。
5. 将来自 Zap 前序步骤的数据映射到请求正文中。

## 自动化实用示例

- **WhatsApp 新对话在其他系统中生成线索：** 每当新对话进入某个收件箱时，Flow 会向 Zapier 发送 webhook。Zapier 格式化数据，并在公司 CRM 中创建线索。
- **Kanban 中赢单更新表格：** Kanban webhook 将事件发送到 Zapier，Zapier 将赢单卡片记录到表格或财务系统中。
- **程序化消息：** Zapier 调用 `POST /api/v1/messages`，在客户于其他应用中填写表单后发送提醒。
- **AI 回复：** Zapier 可以调用 `POST /api/ai/v1/complete`，使用 Papo 账户的 prompt 生成回复，并在另一个流程中使用结果。

## 这种集成适合谁

- **销售团队**，需要将赢单同步到表格、CRM 或计费工具。
- **支持团队**，使用多个渠道，并希望将对话记录到 help desk 系统。
- **营销运营**，根据 CRM 事件（例如新提取的联系人）触发活动。
- **拥有多样化技术栈的公司**，希望减少 WhatsApp、CRM、电子邮件和表格之间的手动工作。

## 常见问题

### 我需要 Papo 在 Zapier 中的官方连接器吗？

不需要。该集成使用 Papo REST API 和 webhooks，它们可与 Webhooks by Zapier 应用配合使用。可用端点的详细信息见 API 文档。

### 哪些 Papo 事件可以启动 Zap？

你可以使用 Flows 处理新对话等事件，并使用原生 webhooks 或 Kanban webhooks 处理自动化和销售漏斗事件。可用 webhooks 的完整列表显示在 Papo 面板中。

### 如何在 Zapier 中验证 Papo API？

在 header `Authorization: Bearer sk_live_...` 或 header `X-Papo-Secret-Key` 中使用密钥。公钥（`pk_live_...`）在与密钥一起发送时是可选的。

### 我可以通过 Zapier 发送 WhatsApp 消息吗？

可以。你可以向 `POST /api/v1/messages` 发起请求，提供目标号码和文本。消息会通过连接到你的 Papo 账户的 WhatsApp 发出。

### Zapier 可以更新 Kanban 卡片吗？

可以，通过 API。Papo 允许列出卡片、在某个阶段创建卡片、移动卡片，并将其标记为赢单或丢失，这些都可以由 Zapier 触发。

### 如果 webhook 没有到达 Zapier 怎么办？

确认 webhook 或 Flow 已启用，Zapier URL 已正确粘贴，并且调用中使用的密钥有效。Flows 的执行日志有助于识别错误。

## 另请阅读

- [Papo 中的自动化：规则、宏、Flows 和 Webhooks——该用哪个？](/hc/papo/articles/papo-automations-rules-macros-flows-webhooks-which-to-use-zh)
- [如何使用 Papo API 列出对话并发送程序化消息](/hc/papo/articles/papo-api-list-conversations-send-messages)

---

**[免费开始并连接你的渠道 →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=integrate-papo-with-zapier-using-api-and-webhooks-zh&utm_content=zh_CN)**

创建你的免费 Papo 账户，将客户服务、CRM 和自动化集中在一个面板中。