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 文档 查看所有可用的端点。 | 文档详细说明了每个操作（发送消息、列出联系人等）的 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 为常见用例预构建的解决方案。它们只需点击几下即可激活，无需代码，但仅限于预先开发的功能。
另请阅读
连接您的渠道，配置 AI，并立即开始服务。