**要将 Papo（https://papo.global/）与 n8n 集成并实现流程自动化，你可以使用平台的 API 密钥发送联系人数据、管理对话或触发操作，也可以在自动化 Flow 中配置 Webhooks，让 Papo 在事件发生时（例如收到新消息或产生合格线索）通知 n8n。**

Papo 提供两种与 n8n 通信的主要方式，n8n 是最流行的自动化平台之一。第一种是 **API**，它允许 n8n 主动调用 Papo（例如创建联系人或发送消息）。第二种是 **Webhooks**，它走相反方向：当客服流程中发生某些事情时，Papo 会自动向 n8n 发送信息。

| 集成方式 | 方向 | 主要用途 | 如何配置 |
| :--- | :--- | :--- | :--- |
| **Papo API** | n8n → Papo | 向 Papo 发送命令（创建联系人、发送消息、获取数据）。 | 在 Papo 面板生成密钥，并在 n8n 的 HTTP Request 节点中使用 Bearer 认证。 |
| **Papo Webhook** | Papo → n8n | 在事件发生时（新对话、合格线索）接收 Papo 的自动通知。 | 在 n8n 中创建 Webhook 节点以生成 URL，并在 Papo 的 Flow 中配置“发送 Webhook”操作。 |

## API 集成如何工作

Papo API 是 n8n 以编程方式在你的账户中执行操作的入口。借助它，你可以自动化诸如将联系人同步到外部 CRM、通过触发器发送 WhatsApp 消息或提取线索数据等任务。

### 1. 在 Papo 中生成 API 密钥
进入 Papo 面板并前往 **设置**。在 **开发者** 或 **API** 部分，你会看到 **公钥**（固定）并可生成 **密钥**。给它起一个描述性名称（例如：“n8n 集成”）并立即复制密钥——它只会显示一次。

### 2. 在 n8n 中配置 HTTP Request 节点
在 n8n 的工作流中，添加一个 **HTTP Request** 节点。在 URL 字段中，使用 Papo API 的目标端点。基础 URL 为：

```
https://app.papo.global/api/v1
```

要进行认证，添加 `Authorization` 请求头，值为 `Bearer sk_live_SUA_CHAVE_SECRETA`。一个不错的初始测试是调用 `/me` 端点，它会返回你的账户数据：

```
GET https://app.papo.global/api/v1/me
Authorization: Bearer sk_live_...
```

### 3. 搭建你的自动化流程
认证成功后，你可以创建完整的工作流。例如：
- **表单新线索 → 在 Papo 中创建联系人**：n8n 中的 Webhook 节点接收表单数据，HTTP Request 节点调用 Papo API 创建联系人。
- **获取 Extrator 提取的联系人并发送到表格**：n8n 定期查询 Extrator 的联系人列表并将其插入 Google Sheets。

Papo API 允许你查找、创建和更新联系人，发送 WhatsApp 消息，列出 Extrator 执行记录等。包含所有端点的完整文档位于 **papo.global/pt/docs**。

## Webhooks 集成如何工作

Webhooks 非常适合实时响应 Papo 内发生的事件。你可以配置一个 Flow，在联系人到达特定阶段时自动向 n8n 发送通知。

### 1. 在 n8n 中创建 Webhook 触发器
在 n8n 编辑器中，添加一个 **Webhook** 节点作为工作流触发器。选择 `POST` 方法并复制生成的 **生产 URL**。该 URL 将成为 Papo 发送数据的目标地址。

### 2. 在 Papo 的 Flow 中配置“发送 Webhook”操作
在 Papo 的 Flow 编辑器中，在希望发生通知的旅程节点处添加 **“发送 Webhook”** 操作节点（例如，在线索回答资格问题之后）。

填写字段：
- **Webhook URL**：粘贴从 n8n 复制的 URL。
- **HTTP 方法**：选择 `POST`。
- **请求体（Payload）**：用你想发送的联系人变量构建 JSON。示例：

```json
{
  "nome": "{{contact.name}}",
  "email": "{{contact.email}}",
  "telefone": "{{contact.phone}}",
  "etapa": "Lead qualificado",
  "origem": "Flow de Boas-Vindas"
}
```

### 3. 测试并激活
发布前，使用 Webhook.site 等服务 URL 测试数据是否正确到达。然后替换为 n8n 的 URL 并激活 Flow。从此刻起，每当联系人经过该节点，n8n 都会收到数据，并可执行诸如在 CRM 中登记线索、发送电子邮件或更新表格等操作。

## 该集成适合谁

Papo 与 n8n 的连接适合已将 Papo 用作 WhatsApp 客服和销售中心，并需要将这些流程连接到其他系统而无需依赖内部开发的企业。营销机构、销售团队和支持运营可以例如自动同步 Papo 与 ERP 之间的联系人、发送细分活动或创建自定义仪表板。

## 常见问题（FAQ）

### 将 Papo 与 n8n 集成需要会编程吗？
不需要。n8n 是一个可视化自动化工具，API 或 Webhook 的配置通过填写字段和搭建小型 JSON 块完成。了解基本 REST API 知识会有帮助，但不是必需的。

### 我可以用 API 自动化 Papo 的哪些操作？
你可以查找、创建和更新联系人，发送 WhatsApp 消息，列出 Extrator 提取的联系人，查询执行数据等。完整列表见官方文档。

### Papo 的 Webhook 会实时发送数据吗？
会。一旦联系人到达活动 Flow 中的“发送 Webhook”节点，Papo 会立即向配置的 URL 发起请求。

### 我可以用 API 从网站表单在 CRM 中创建联系人吗？
可以。只需在 n8n 中配置一个 Webhook 节点来捕获表单数据，然后使用 HTTP Request 节点调用 Papo API，用收到的信息创建联系人。

### 在哪里可以找到 Papo API 的完整文档？
包含所有端点、参数和示例的技术文档位于 **papo.global/pt/docs**。

### API 和 Webhooks 在免费计划中可用吗？
可以，API 和 Webhooks 都是平台的一部分，任何 Papo 账户都可以使用。你可以免费开始使用第一个用户并测试所有集成。

## 另请阅读

- [如何使用 Webhooks 将新对话通知发送到 Slack](/hc/papo/articles/slack-notifications-new-conversations-webhooks)

---

**[免费开始使用 Papo Global →](https://chat.papo.global/app/auth/signup?papo_lp=home&utm_source=lp&utm_medium=landing&utm_campaign=home&utm_content=start-free&papo_lp_v=start-free)**

第一个用户免费，你可以立即测试 API 和 Webhooks，零成本自动化你的流程。