**要通过编程方式在Kanban中创建和更新商机，请使用[Papo](https://papo.global/)的REST API。通过密钥（Bearer token）认证和账户公钥，您可以发送请求来创建卡片、在阶段之间移动商机并标记结果，将销售漏斗与外部系统集成，无需手动干预。**

Papo API公开了Kanban的写入操作，允许处理漏斗、阶段和CRM卡片。这使您能够将ERP、着陆页或支付工具与销售漏斗同步，保持商机始终最新。

## Kanban集成摘要

| 步骤 | 操作 | 重要细节 |
| :--- | :--- | :--- |
| 1. 获取密钥 | 在Papo面板中生成密钥（`sk_live_…`）并复制公钥（`pk_live_…`）。 | 密钥仅显示一次；请将其保存在安全的地方。 |
| 2. 认证调用 | 在所有写入请求中包含`Authorization: Bearer sk_live_…`标头。 | 公钥可通过`X-Papo-Public-Key`标头发送（可选）。 |
| 3. 了解漏斗和阶段 | 列出Kanban漏斗及其阶段以获取必要的标识符。 | API响应包含后续调用使用的标识符。 |
| 4. 创建或移动卡片 | 发送操作以在阶段中创建卡片、将联系人的卡片移动到另一阶段或标记结果。 | 每个操作处理一个动作；对于多条记录，请自动化循环发送。 |
| 5. 验证响应 | API返回`success: true`以及卡片或列表数据。 | 如果出错，响应正文包含代码和消息以供更正。 |

## API在Kanban中允许执行的操作

通过Kanban端点，您可以编程方式：

- 列出可用的漏斗及其阶段，包括名称和位置。
- 列出CRM卡片。
- 列出所有赢单卡片，用于已成交销售报告。
- 在阶段中创建卡片，可选关联到现有联系人。
- 将联系人的卡片移动到漏斗的另一阶段。
- 将卡片标记为赢单或输单。
- 创建具有默认或自定义阶段的Kanban漏斗。

这些操作使漏斗能够自动反映Papo之外发生的情况，例如确认购买、安排会议或来自网站的注册。

## 认证和调用如何工作

所有修改数据的调用都需要账户的**密钥**。它应作为Bearer token在`Authorization`标头中发送，或者也可以在`X-Papo-Secret-Key`标头中发送。**公钥**可以随请求在`X-Papo-Public-Key`标头中发送；其使用是可选的，但如果发送，必须与密钥属于同一账户。

API的基础URL是`https://app.papo.global/api/v1`。在此基础上，Kanban端点接受适当的HTTP动词来创建、移动、更新和列出。由于完整文档详细说明了路径、参数和接受的字段，我们建议在编码前查阅[官方API参考](https://papo.global/pt/docs)。

要验证您的密钥是否有效，您可以调用`GET /api/v1/me`端点，它返回账户数据。认证模式与其他端点相同：

```
curl https://app.papo.global/api/v1/me \
  -H "Authorization: Bearer sk_live_…" \
  -H "X-Papo-Public-Key: pk_live_…"
```

成功的响应包括`success: true`和包含账户信息的`data`对象。

## 与外部系统集成的典型流程

Python、Node.js脚本或n8n等工具中的自动化可以执行完整的漏斗周期：

1. 列出漏斗和阶段以获取每列的标识符。
2. 在初始阶段创建卡片，必要时关联到联系人。
3. 当外部事件发生时将卡片移动到新阶段——例如，确认付款或安排会议。
4. 当商机完成时将卡片标记为赢单或输单。
5. 列出赢单卡片以供给报告、仪表板或BI系统。

由于API是REST并使用JSON，任何支持HTTP的语言都可以使用。每个操作的payload和字段细节在官方文档中。

## 此集成适用于谁

- **在外部系统中获取商机的公司**，如着陆页、ERP或电子商务，并希望它们自动进入Papo漏斗。
- **需要根据支付事件移动卡片的运营**，如支付网关或计费平台，无需手动打开CRM。
- **BI和数据团队**，希望将赢单卡片和金额拉取到实时仪表板。
- **构建自定义集成的IT团队**，在Papo和内部工具之间，使用API作为销售漏斗与其余运营之间的桥梁。

## 常见问题

### 我需要在所有调用中使用公钥吗？
不需要。公钥是可选的，但如果通过`X-Papo-Public-Key`标头发送，必须与密钥属于同一账户。

### 我如何知道我的漏斗中有哪些阶段？
通过API列出Kanban漏斗。响应返回每个漏斗的阶段及其标识符，用于创建或移动卡片。

### 我可以创建已关联到联系人的卡片吗？
可以。创建卡片时可选关联到现有联系人，保持客户历史和数据与商机关联。

### API允许更新卡片金额吗？
API公开了Kanban卡片的写入操作。可以更新的确切字段，包括金额，在官方API文档中详细说明。

### 可以通过API将卡片标记为赢单或输单吗？
可以。API允许将卡片标记为赢单和输单，并列出所有赢单卡片用于报告和仪表板。

### 我需要编程还是可以使用自动化工具？
您可以使用任何支持HTTP的语言或n8n等自动化工具，按照所需流程按顺序执行调用。

## 另请参阅

- [如何使用Papo API批量创建和更新联系人](/hc/papo/articles/how-to-use-papo-api-create-update-contacts-bulk-zh)
- [如何通过Webhook（出站）实时接收Papo事件](/hc/papo/articles/receive-real-time-events-papo-webhook-outbound-zh)

---

**[免费开始 →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=papo-api-kanban-create-update-deals&utm_content=zh_CN)**

首位用户免费，无需信用卡。