**要基于外部事件——例如商机在 Kanban 漏斗中推进——在 Papo (https://papo.global/) 的 Projetos 模块中自动创建任务，你可以将平台 API 与 n8n 或 Zapier 等自动化工具结合使用。该 API 允许以编程方式查询 CRM 卡片并在项目中生成任务，从而消除销售与运营之间手动交接的需要。**

将销售管道与交付执行集成是 B2B 运营的主要瓶颈之一。当商机卡片被移动到“赢单”或达到特定阶段时，需要触发一系列操作：入职、配置、发送材料。借助 Papo API，你可以在无需人工干预的情况下编排这一过渡，确保每笔成交销售都会自动在正确的项目中生成任务，并带有明确的负责人和截止日期。

## 通过 API 实现自动化的流程概览

| 阶段 | 操作 | 说明 |
| :--- | :--- | :--- |
| **1. 身份验证** | 在 Papo 面板中生成 API 密钥 | 用于授权外部调用的凭据。 |
| **2. 监控漏斗** | 查询 Kanban 卡片端点 | 识别状态发生变化的商机（例如：lead_status=won）。 |
| **3. 创建任务** | 调用 Projetos 中的任务创建端点 | 在项目的 Kanban 看板中生成卡片，并关联联系人和销售数据。 |
| **4. 执行** | 运营团队在 Projetos 模块中查看任务 | 交付按正常流程进行，具备完整可追溯性。 |

## 通过 API 创建任务如何运作

Papo API 为 Kanban 和 Projetos 模块提供端点。通过组合这些调用，你可以在 CRM 与交付管理之间构建自动化桥梁。

### 1. 获取你的 API 密钥

在进行任何集成之前，请访问 Papo 面板，进入 **开发者**（或 **API**）部分，并生成一个密钥（`sk_live_...`）。该密钥将用于所有请求的 `Authorization: Bearer sk_live_...` 请求头中。公钥（`pk_live_...`）用于标识你的账户，但身份验证依赖密钥。请将其保存在安全的地方——它不会再次显示。

### 2. 监控 Kanban 卡片

自动化的第一步是检测商机何时在漏斗中推进。Kanban API 允许按状态筛选列出卡片。例如，你可以：

- 定期查询所有 `lead_status=won`（赢单商机）且尚未生成任务的卡片。
- 或者，如果你的自动化工具支持，对卡片更新 webhook 做出反应（请查看官方文档是否有可用事件）。

通过脚本或 n8n/Zapier 中的工作流，你可以安排对卡片列表端点的查询，筛选结果，并仅为符合条件的卡片触发任务创建。

### 3. 在 Projetos 中创建任务

获取卡片数据（联系人、商机标题、金额等）后，你调用 Projetos 中的任务创建端点。典型参数包括：

- **project_id**：目标项目的标识符（例如：“Onboarding”或“售后交付”）。
- **title**：任务标题，可由联系人姓名和商机名称组合而成。
- **description**：从卡片中提取的上下文摘要。
- **priority**：紧急、高、中或低。
- **due_date**：计算出的截止日期，例如成交后 5 天。
- **assignee**：执行负责人（可以是固定值或按规则定义）。

API 响应会确认创建并返回任务 ID。此后，它会出现在所选项目的 Kanban 看板中，供运营团队使用。

### 4. 跟踪执行

任务创建后，会遵循 Projetos 模块的正常周期：团队在列之间移动卡片、添加评论并标记完成。销售或经理无需离开 CRM 即可查看进度，因为 Papo 会保持原始商机与交付之间的可追溯性。

## 使用 n8n 的实践示例（概念性）

尽管实现细节取决于官方 API 文档（可在 **papo.global/pt/docs** 获取），但在 n8n 等工具中的逻辑流程如下：

1. **Cron 节点**：每 15 分钟触发一次。
2. **HTTP Request 节点（Papo API）**：GET 请求 Kanban 卡片列表端点，按 `lead_status=won` 和最近成交日期筛选。
3. **IF 节点**：检查是否有新卡片（尚未处理）。
4. **HTTP Request 节点（Papo API）**：POST 请求任务创建端点，使用卡片数据。
5. **更新节点**（可选）：用标签或自定义字段标记原始卡片，以避免重复。

同样的思路也适用于 Zapier、Make 或 Python/JavaScript 脚本。

## 这种集成适合谁

- **采用顾问式销售周期的 B2B 运营**，其中成交必然触发技术交付或入职。
- **已经使用 Papo 的 Kanban 和 Projetos 的公司**，希望消除团队之间的手动信息传递。
- **每周接收数十个新客户并需要标准化流程的 CS 和实施团队**。
- **希望为客户提供高级自动化、将 CRM 与外部项目管理系统集成的白标经销商**。

## 常见问题

### 我需要 webhook 来检测 Kanban 变化吗？

Papo API 提供用于查询卡片的端点。如果官方文档包含 webhook，你可以使用它们接收实时通知。否则，定期查询（轮询）是一种可行且广泛使用的替代方案。

### 我可以通过 API 在任何项目中创建任务吗？

可以。只要你拥有活跃项目的 ID，任务创建端点就允许指定目标项目。你可以为不同类型的交付维护单独的项目（例如：“Onboarding”、“技术支持”、“定制化”）。

### 通过 API 创建的任务会继承商机的联系人吗？

会。在构建请求时，你可以关联 Kanban 卡片所关联的联系人。这样，运营团队可以直接在任务中访问对话历史和客户数据。

### 可以自动定义负责人吗？

可以。任务创建端点接受负责人字段（assignee）。你可以设置固定值、使用轮询逻辑，或基于卡片属性（如负责销售）来确定。

### 如何避免创建重复任务？

建议维护外部控制（数据库、电子表格或卡片中的自定义字段）来记录哪些商机已经生成过任务。在创建新任务之前，流程会检查该卡片是否已被处理。

### 在哪里可以找到完整的端点列表？

包含所有端点、参数和代码示例的详细技术文档可在 **papo.global/pt/docs** 公开获取。

## 另请阅读

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

---

**[免费开始 →](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)**

使用 Papo 免费计划，你已经可以生成 API 密钥并测试 Kanban 与 Projetos 之间的任务自动化。