**要通过编程方式批量创建和更新联系人，请使用[Papo](https://papo.global/)的REST API。通过密钥（Bearer token）和账户公钥进行认证，您可以发送请求来插入新记录或修改CRM中的现有数据——非常适合同步外部数据库、迁移列表或无需手动干预即可保持联系人信息始终最新。**

Papo API提供了写入端点，允许创建联系人（包含姓名、电子邮件和/或电话）并更新现有联系人。结合简单的认证和JSON格式，这些端点通过脚本、自动化工具（如n8n）或自定义集成按顺序执行时，可实现批量操作。

## 集成流程摘要

| 步骤 | 操作 | 重要细节 |
| :--- | :--- | :--- |
| 1. 获取密钥 | 在Papo面板中生成密钥（sk_live_…）并复制公钥（pk_live_…）。 | 密钥只显示一次；请将其保存在安全的地方。 |
| 2. 认证调用 | 在所有写入请求中包含请求头 `Authorization: Bearer sk_live_…`。 | 公钥可以通过请求头 `X-Papo-Public-Key` 发送（可选）。 |
| 3. 准备负载 | 构建包含联系人字段（姓名、电子邮件、电话等）的JSON对象。 | 必填字段和确切格式在API文档中。 |
| 4. 发送请求 | 向创建端点发送POST请求，或向更新端点发送PUT/PATCH请求。 | 每个请求处理一个联系人；对于大量记录，请自动化循环发送。 |
| 5. 验证响应 | API返回 `success: true` 以及创建/更新的联系人数据。 | 如果出错，响应体包含错误代码和消息以供修正。 |

## 认证和端点如何工作

所有修改数据的调用（创建、更新）都需要账户的**密钥**。它应作为Bearer token在 `Authorization` 请求头中发送，或者也可以在 `X-Papo-Secret-Key` 请求头中发送。**公钥**（每个账户固定）可以通过 `X-Papo-Public-Key` 请求头随请求发送——其使用是可选的，但如果发送，必须与密钥属于同一账户。

API的基础URL是 `https://app.papo.global/api/v1`。在此基础上，联系人端点接受适当的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` 对象。然后，只需根据所需的联系人操作替换端点和HTTP方法即可。

## 批量创建和更新联系人

尽管API每个请求处理一个联系人，但通过按顺序执行多个调用可以实现批量操作。Python、Node.js脚本或n8n中的自动化可以：

1. 从CSV文件、数据库或ERP中读取联系人列表。
2. 对于每条记录，使用必要字段构建JSON负载。
3. 向创建端点发送请求（如果联系人不存在）或向更新端点发送请求（使用联系人标识符）。
4. 收集响应并处理可能的错误（重复电子邮件、无效字段等）。

由于API是REST并使用JSON，任何支持HTTP的语言都可以使用。Papo还在文档页面提供了JavaScript和Python示例，可以适配到联系人端点。

### 创建后的自动触发

每当通过API创建新联系人时，CRM的相同内部事件会被触发。如果您配置了带有“联系人已创建”触发器的**Flow**，自动化将自动执行——例如，通过WhatsApp发送欢迎消息或通知销售团队。这意味着通过API集成不仅填充数据库，还会激活账户中已有的通信流。

## 此集成适用于谁

- **从其他CRM或电子表格迁移的公司**，需要一次性导入数千个联系人，保持Papo数据库同步。
- **在外部系统（着陆页、ERP、电子商务）中捕获线索的运营**，希望它们自动进入Papo CRM，准备好接受服务或活动。
- **构建Papo与内部工具之间自定义集成的IT团队**，使用API作为桥梁保持客户数据始终最新。
- **管理多个账户并希望为其客户大规模自动化创建联系人的白标经销商**。

## 常见问题

### 创建或更新联系人需要密钥吗？
是的。所有写入操作（创建、更新）都需要使用账户密钥进行认证。仅公钥不能授权修改。

### 我可以一次发送数千个联系人吗？
API每个请求处理一个联系人。对于大量数据，您应自动化顺序发送，并遵守官方文档中描述的速率限制。

### 通过API创建的联系人会触发“联系人已创建”Flow吗？
是的。创建事件是相同的，无论来源如何。如果有使用该触发器的活动Flow，则对于通过API插入的每个联系人都会执行。

### 如何知道联系人是否已存在以避免重复？
您可以在创建之前使用搜索端点（按电子邮件或电话过滤）。API文档详细说明了可用的查询参数。

### API允许仅更新联系人的某些字段吗？
是的。在更新请求体中，仅发送您要修改的字段。其他字段保持不变。

### 在哪里可以找到完整的端点和参数列表？
完整参考可在[API文档页面](https://papo.global/pt/docs)中找到。您可以在那里找到路径、方法、负载和更新的示例。

## 另请参阅

- [如何在CRM中创建新联系人时自动触发Flow](/hc/papo/articles/trigger-flow-when-new-contact-created-in-crm)
- [如何将Extrator中提取的联系人导出为CSV并导入Papo CRM](/hc/papo/articles/export-contacts-extractor-csv-import-papo-crm-zh)

---

**[免费开始并通过API将您的CRM集成到Papo →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=how-to-use-papo-api-create-update-contacts-bulk-zh&utm_content=zh_CN)**

使用第一个免费用户，您已经可以生成API密钥并免费测试批量创建联系人。