要将 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。示例：
{
"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 账户都可以使用。你可以免费开始使用第一个用户并测试所有集成。
另请阅读
第一个用户免费，你可以立即测试 API 和 Webhooks，零成本自动化你的流程。