**如需以编程方式批量归档对话和联系人，请使用 [Papo](https://papo.global/) 的 REST API。通过联系人更新端点和对话标签应用端点，你可以将记录标记为已归档，无需手动干预即可保持数据库始终整洁——非常适合数据量大的运营，或管理多个客户的 white label 经销商。**

Papo 并不要求使用专用的“归档”端点。相反，你可以使用 API 中已有的操作来更改记录状态：更新联系人（添加归档标签或自定义属性），以及为对话应用标签。这样，脚本或自动化就能批量处理数千个项目，并根据你的业务规则整理数据库。

## 通过 API 批量归档流程概览

| 步骤 | 操作 | 重要细节 |
| :--- | :--- | :--- |
| 1. 获取密钥 | 在 Papo 面板中生成密钥（sk_live_…）并复制公钥（pk_live_…）。 | 密钥只显示一次；请将其保存在安全位置。 |
| 2. 确定要归档的内容 | 列出应归档的联系人或对话（按日期、状态、无互动等）。 | 使用带筛选条件的列表端点，或导出 CSV 来为脚本提供数据。 |
| 3. 归档联系人 | 对每个联系人发送更新请求，包含“已归档”标签或自定义属性。 | 联系人更新端点接受你要修改的字段。 |
| 4. 归档对话 | 对每个对话，使用标签端点应用如“已归档”的标签。 | 如果账户中尚不存在该标签，会自动创建。 |
| 5. 验证结果 | 检查记录是否显示归档标记，以及平台筛选器是否反映新的组织方式。 | 在联系人模块或对话模块中调整筛选器，以隐藏已归档项目。 |

## 工作原理——分步说明

### 1. 身份验证和密钥

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

在 Papo 面板的开发者区域生成密钥。API 基础 URL 是 `https://app.papo.global/api/v1`。请查阅[官方文档](https://papo.global/pt/docs)以了解确切的端点、参数和 payload 示例。

### 2. 确定要归档的记录

在触发更新之前，你需要知道哪些联系人或对话应被归档。API 提供列表端点，可返回所需数据。例如，你可以：

- 列出联系人（按姓名、电子邮件、电话搜索，或按日期筛选），以选择 X 天没有互动的联系人。
- 列出对话，并结合状态或最后一条消息日期等条件进行筛选。

拿到列表后，Python、Node.js 脚本或 n8n 中的自动化可以遍历每条记录并执行归档操作。

### 3. 批量归档联系人

Papo API 允许**更新现有联系人**。要归档联系人，你可以：

- 为联系人添加一个**标签**（例如“已归档”）。更新端点接受添加 tags。
- 或者更新一个**自定义属性**（如果你创建了“status”或“已归档”之类的字段），将其设为所需值。

重要的是，更新后联系人会带有一个标记，使其与活跃联系人区分开来。由于 API 每次请求处理一个联系人，批量操作是通过依次执行多次调用来完成的。API 文档中提供了 JavaScript 和 Python 代码示例，可将其适配到更新端点。

### 4. 批量归档对话

对于对话，API 提供一个端点，**如果账户中不存在该标签，则创建标签，并将其应用到联系人和打开的对话**。这样，你可以创建“已归档”标签，并将其应用到所有你想从主视图中移除的对话。

流程与联系人类似：列出对话，筛选出应归档的对话，然后为每个对话发送应用标签的请求。如果标签尚不存在，将在第一次调用时自动创建。

### 5. 检查归档结果

脚本完成后，在 Papo 面板中访问**联系人**和**对话**模块。使用按标签筛选，仅查看标记为“已归档”的项目——或者反过来，将其隐藏，以专注于活跃记录。如果操作未达到预期效果，请检查 payload 和身份验证请求头。

## 此自动化适用于谁

- **拥有大量联系人的运营团队**，需要定期清理数据库，将冷线索或已结束的对话从主视图中移除。
- **white label 经销商**，管理数十个客户账户，并希望通过 API 提供自动化整理服务。
- **IT 团队和开发者**，构建自定义集成，让 CRM 始终保持精简，而不依赖手动操作。
- **从其他系统迁移数据的公司**，现在想归档不再日常使用的旧记录。

## 常见问题

### Papo API 有专门用于归档的端点吗？
不需要专用端点。你可以使用联系人更新端点和对话标签应用端点，将记录标记为已归档。官方文档详细说明了接受的参数。

### 我可以删除联系人或对话，而不是归档吗？
当前 API 不提供删除端点。建议通过标签或自定义属性进行归档，这样可以保留数据，但将其移出主视图。

### 如何对请求进行身份验证？
在所有写入调用中包含 `Authorization: Bearer {你的密钥}` 请求头。密钥在 Papo 面板的开发者部分生成。

### 可以一次归档数千条记录吗？
可以。只需创建一个脚本，循环遍历联系人或对话列表，并为每个项目发送请求。n8n 等工具也可以编排此过程。

### 已归档的对话会从收件箱中消失吗？
它们仍然存在，但应用“已归档”之类的标签后，你可以将它们筛选出默认视图。显示方式取决于对话模块中配置的筛选器。

### 在哪里可以找到 API 密钥？
在 Papo 面板中，访问开发者区域或 API 设置。密钥仅在创建时显示；如果丢失，需要生成新的。

## 另请阅读

- [如何使用 Papo API 列出对话并发送程序化消息](/hc/papo/articles/papo-api-list-conversations-send-messages)
- 如何使用 Papo API 管理联系人的自定义属性

---

**[免费开始，并使用 API 整理你的数据库 →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=bulk-archive-conversations-contacts-via-api&utm_content=zh_CN)**

使用 Papo 的免费计划，你可以测试集成，并免费批量归档联系人和对话，无需初始费用。