要将 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（触发器）
- 在 Zapier 中，创建一个 Zap，并选择 Webhooks by Zapier 作为触发器，选项为 Catch Hook。Zapier 会生成一个专属 URL。
- 在 Papo 中，创建一个原生 webhook、一个 Kanban webhook，或一个带 webhook 操作的 Flow。
- 将 Zapier URL 粘贴到 webhook 或操作的目标字段中。
- 配置应触发发送的事件。对于新对话，使用触发器为 新对话 的 Flow。对于漏斗事件，使用 Kanban webhooks。
- 在 Zapier 中，添加所需操作：发送电子邮件、在表格中创建行、在其他 CRM 中登记线索、通知 Slack 频道等。
从 Zapier 到 Papo（操作）
- 在 Zapier 中，使用 Webhooks by Zapier 作为操作，通常使用自定义请求。
- 指向基础地址
https://app.papo.global/api/v1。 - 包含 header
Authorization: Bearer sk_live_...或X-Papo-Secret-Key，如果需要，还可包含X-Papo-Public-Key。 - 根据操作选择端点：
POST /api/v1/messages用于发送 WhatsApp 消息，GET /api/v1/contacts用于列出 Extrator 联系人，GET /api/v1/instances用于查询 WhatsApp 连接等。 - 将来自 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 账户，将客户服务、CRM 和自动化集中在一个面板中。