如需以编程方式批量归档对话和联系人，请使用 Papo 的 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。请查阅官方文档以了解确切的端点、参数和 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 列出对话并发送程序化消息
- 如何使用 Papo API 管理联系人的自定义属性
使用 Papo 的免费计划，你可以测试集成，并免费批量归档联系人和对话，无需初始费用。