要基于外部事件——例如商机在 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 等工具中的逻辑流程如下：
- Cron 节点：每 15 分钟触发一次。
- HTTP Request 节点（Papo API）：GET 请求 Kanban 卡片列表端点，按
lead_status=won和最近成交日期筛选。 - IF 节点：检查是否有新卡片（尚未处理）。
- HTTP Request 节点（Papo API）：POST 请求任务创建端点，使用卡片数据。
- 更新节点（可选）：用标签或自定义字段标记原始卡片，以避免重复。
同样的思路也适用于 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 密钥并测试 Kanban 与 Projetos 之间的任务自动化。