如何使用Papo API在Kanban中创建和更新商机

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

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

Kanban集成摘要

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参考。

要验证您的密钥是否有效，您可以调用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批量创建和更新联系人
• 如何通过Webhook（出站）实时接收Papo事件

免费开始 →

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