**Papo API (https://papo.global/) 是一种编程接口，允许开发者将其他系统（如 CRM、ERP 或自动化平台（如 n8n））直接连接到您的 Papo 账户。它用于自动化操作，例如发送 WhatsApp 消息、查询 Extractor 中的联系人或触发平台的 AI，而无需使用图形界面。**

API 为您提供了无限的可能性，可以根据您的需求定制和扩展您的运营，将 Papo 的功能集成到您公司现有的工作流程中。您的软件可以指挥 Papo 执行任务，而无需在面板中手动操作。

## API、Webhooks 和现成集成：有什么区别？

这三个概念经常被混淆。下表总结了它们之间的主要区别以及何时使用它们。

| 特点 | API (应用程序编程接口) | Webhooks | 现成集成 |
| :--- | :--- | :--- | :--- |
| **方向** | 您的系统向 Papo **请求或发送**数据。 | Papo 向您的系统**发送**数据。 | Papo 连接到其他服务。 |
| **行动发起方** | 您的外部系统。 | Papo 平台。 | 用户在面板中配置时。 |
| **技术要求** | 需要编程或使用 n8n 等工具。 | 需要在您的系统中有一个端点 (URL) 来接收数据。 | 无需编程，只需在面板中进行配置。 |
| **使用示例** | 当您的电子商务网站批准购买时发送 WhatsApp 消息。 | 每当在 Papo 中创建新联系人时，通知您的计费系统。 | 连接您的 Google 日历账户，以便 Papo 的 AI 可以安排会议。 |

## Papo API 有什么用？

借助 API，您可以为您的业务构建量身定制的自动化和集成。一些主要应用包括：

*   **发送消息：** 从您自己的系统发起对话或发送 WhatsApp 通知（例如：订单确认、付款提醒）。
*   **访问 Extractor 联系人：** 查询 Papo Extractor 生成的潜在客户列表，并将其导入您的 CRM 或营销工具。
*   **管理实例：** 直接从您的后端检查您的 WhatsApp 连接状态。
*   **使用人工智能：** 将文本发送到 AI API，并根据您 Papo 账户中配置的提示接收生成的回复，从而在其他场景中使用相同的智能。
*   **同步数据：** 保持您的联系人、公司和业务在 Papo 和您的主要 CRM 之间同步。
*   **创建自定义仪表板：** 提取服务和绩效数据，以特定于您运营的指标为 Business Intelligence (BI) 仪表板提供支持。

## 如何开始使用 API

要使用 API，您需要具备技术知识或使用支持 REST API 调用的可视化自动化工具，例如 n8n。一般过程很简单：

| 步骤 | 操作 | 详情 |
| :--- | :--- | :--- |
| **1. 生成 API 密钥** | 访问 Papo 面板并前往开发者部分创建您的密钥。 | 您将获得一个用于识别您账户的**公钥** (`pk_live_...`) 和一个用于身份验证的**私钥** (`sk_live_...`)。私钥只显示一次。 |
| **2. 查阅文档** | 访问 [官方 API 文档](https://papo.global/pt/docs) 查看所有可用的端点。 | 文档详细说明了每个操作（发送消息、列出联系人等）的 URL、所需参数和响应格式。 |
| **3. 实现调用** | 在您的系统中编写代码或在您的自动化工具中配置模块。 | 调用通过 HTTPS 发送到基本 URL `https://app.papo.global/api/v1`，并在授权头中发送私钥。 |
| **4. 测试集成** | 进行测试以确保您的系统与 Papo 正确通信。 | 检查消息是否已发送以及数据是否按预期接收。 |

## 常见问题

### 我需要是程序员才能使用 API 吗？
是的，直接使用 API 需要编程知识。但是，n8n 或 Make 等自动化工具允许您通过可视化界面连接到 API，无需编写代码，只需配置操作模块并输入您的密钥。

### 我在哪里可以找到我的 API 密钥？
API 密钥可以在您的 Papo 账户设置面板中，在专门的开发者部分生成。请记住，私钥 (secret key) 只在创建时显示一次。请将其保存在安全的地方，因为它无法恢复。如果丢失，您需要撤销它并创建一个新的。

### 我到底可以用 API 做什么？
您可以执行许多您在平台上会手动执行的操作。官方文档列出了所有端点，但主要的包括：通过 WhatsApp 发送文本消息 (`/messages`)、列出提取的联系人 (`/contacts`)、列出您的 WhatsApp 连接 (`/instances`) 以及使用 Papo 的 AI 引擎生成文本 (`/ai/v1/complete`)。

### 使用 API 会产生额外费用吗？
访问 API 本身不会在您的套餐中产生额外费用。但是，您通过它执行的操作可能会消耗收费资源，例如通过 WhatsApp API 发送消息或使用 Extractor 提取新的潜在客户。有关运营费用的详细信息，请查阅 Papo 网站上的价格页面。

### Papo API 是 REST 类型还是 SOAP 类型？
Papo API 是一个现代的 REST API。它使用标准的 HTTP 方法（GET、POST 等），并使用 JSON 格式进行通信，JSON 格式轻量且易于被大多数编程语言和自动化工具解析。

### 直接使用 API 与使用 Google 日历等现成集成有什么区别？
API 提供了完全的灵活性，让您可以创建任何类型的集成。而现成集成，例如 Google 日历或 Wavoip，是 Papo 为常见用例预构建的解决方案。它们只需点击几下即可激活，无需代码，但仅限于预先开发的功能。

## 另请阅读
- [如何集成 Wavoip 以在 Papo 中拨打和接听电话](/hc/papo/articles/how-to-integrate-wavoip-for-calls-in-papo-zh)
- [从零开始创建您的第一个自动化流程](/hc/papo/articles/creating-your-first-automation-flow-from-scratch-zh)

---

**[免费开始并探索可能性 →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=what-is-papo-api-and-what-is-it-for-zh&utm_content=zh_CN)**

连接您的渠道，配置 AI，并立即开始服务。