**要将其他平台的会话和联系人迁移到 Papo (https://papo.global/)，你可以导出旧系统中的数据，通过 CSV 文件批量导入联系人，并使用 Papo API 重建会话历史记录，确保过渡过程中不丢失任何信息。**

从之前的服务渠道平台迁移到 Papo 涉及三个主要步骤：从源系统提取数据、将联系人加载到 Papo CRM，以及在需要时使用 API 导入互动历史记录。Papo 提供的工具可简化此过程，避免手动输入，并保留客户关系的上下文。

## 迁移概览

| 阶段 | 操作 | Papo 中的位置 |
| :--- | :--- | :--- |
| 1. 从旧系统导出 | 生成包含联系人的 CSV 文件，如有可能，也包含会话历史记录。 | — |
| 2. 准备 CSV | 整理列（姓名、电子邮箱、电话、标签）并标准化数据。 | — |
| 3. 批量导入联系人 | 上传 CSV 并映射字段。 | 联系人模块 > 导入 |
| 4. 迁移历史记录（可选） | 使用 API 以编程方式创建联系人和消息。 | API（公钥和密钥） |
| 5. 验证迁移 | 检查联系人和会话是否正确显示。 | 联系人和会话模块 |

## 工作原理 – 分步指南

### 1. 导出当前系统中的数据

大多数 CRM 和服务平台都允许将联系人和会话导出为 CSV，或提供用于提取数据的 API。请查阅旧系统的文档来生成这些文件。理想情况下，应获取：

- 包含姓名、电子邮箱、电话和标签（tags）的联系人列表。
- 如有可能，一个包含消息历史记录的文件（日期、发件人、文本）。

如果系统不提供会话导出，你仍然可以迁移联系人，并利用 CRM 中已有的全部上下文在 Papo 中开始新的互动。

### 2. 准备用于联系人导入的 CSV 文件

导入质量取决于文件整理情况。上传列表之前，请检查：

- **格式**：保存为 `.csv`（逗号分隔值）。
- **表头**：第一行应包含列名，例如 `姓名`、`电子邮箱`、`电话`、`标签`。
- **数据整洁**：移除合并单元格、空行和特殊格式。将电话号码标准化为国家代码加区号（例如：55119XXXXXXXX）。

结构示例：

| 姓名 | 电子邮箱 | 电话 | 标签 |
| :--- | :--- | :--- | :--- |
| Maria Silva | maria.silva@email.com | 5511987654321 | 热门线索, 圣保罗活动 |
| João Costa | joao.costa@email.com | 5521912345678 | 活跃客户 |

使用 `标签` 列在导入时即可细分联系人，多个标签用逗号分隔。

### 3. 在 Papo 中批量导入联系人

CSV 准备好后，在 Papo 中上传：

1. 在 CRM 中进入 **联系人** 模块。
2. 找到 **导入联系人** 选项（通常位于创建新联系人按钮附近）。
3. 上传你的 CSV 文件。
4. 在映射步骤中，将文件中的每一列关联到 Papo 中的对应字段（例如：列 `姓名` → 字段 姓名）。如果存在自定义字段，也包括在内。
5. 检查映射并开始导入。

平台会在后台处理文件。完成后，联系人会出现在你的数据库中，可随时加入活动、漏斗或服务流程。

### 4. 使用 Papo API 导入会话历史记录（可选）

如果你需要保留完整的互动历史记录，Papo API 允许以编程方式创建联系人并记录消息。当旧系统提供详细的会话记录时，此方法非常有用。

使用 API 时：

- 按照指南 [如何生成 Papo API 的公钥和密钥](/hc/papo/articles/how-to-generate-papo-api-public-and-secret-keys) 生成访问密钥（公钥和密钥）。
- 开发一个脚本，读取从前系统导出的数据，并调用相应端点来创建联系人（如果尚未导入）和发送历史消息。
- 查阅官方 API 文档：[https://papo.global/docs](https://papo.global/docs)，了解确切的端点、参数和限制。

这种方法可确保之前的服务上下文在 Papo CRM 中可用，让你的团队无需丢失信息即可继续过去的会话。

### 5. 验证迁移

在导入以及（如适用）通过 API 加载之后，进入 **联系人** 和 **会话** 模块，确认：

- 所有联系人都能显示，且字段填写正确。
- 标签已按 CSV 应用。
- 消息历史记录（如果已迁移）在联系人的时间线上可见。

如果某些内容不符，你可以手动更正，或在做出必要调整后重新导入。

## 这种迁移适合谁

- 正在更换服务平台并希望将所有内容集中到 Papo 的公司。
- 曾使用多个工具（CRM、聊天、电子邮件）并希望将联系人和历史记录统一到一个地方的团队。
- 在采用新系统时不能丢失旧会话上下文的运营团队。
- 需要快速过渡、不想逐个输入联系人的企业。

## 常见问题

### 我需要以特定格式导出联系人吗？
是的，接受的格式是带表头的 CSV。大多数电子表格（Excel、Google Sheets）都可以保存为该格式。

### 除了姓名、电子邮箱和电话，我可以导入自定义字段吗？
可以。在映射过程中，你可以将 CSV 的列关联到 Papo 账户中已存在的自定义字段。

### 批量导入联系人有数量限制吗？
限制可能因套餐而异。要获取最新信息，请查阅 Papo 帮助中心或网站。

### 如果没有开发人员，如何迁移会话？
你可以只导入联系人，并从迁移开始在 Papo 中提供服务。如有需要，旧历史记录仍可在原系统中访问。

### API 可以重建任何渠道的会话吗？
Papo API 的文档位于 [https://papo.global/docs](https://papo.global/docs)。在那里你可以找到支持的渠道以及可用于记录消息的操作。

### 如果我的 CSV 有错误会怎样？
平台可能会拒绝包含无效数据的行。我们建议在导入前验证电子表格，删除重复项并标准化电话号码。

## 另请参阅

- [如何生成 Papo API 的公钥和密钥](/hc/papo/articles/how-to-generate-papo-api-public-and-secret-keys)
- [如何通过 5 个步骤配置 Papo，开始在 WhatsApp 上提供服务](/hc/papo/articles/configure-papo-whatsapp-in-5-steps)

---

**[免费开始迁移 →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=migrate-conversations-contacts-to-papo-zh&utm_content=zh_CN)**

免费创建 Papo 账户，在一个平台中集中管理联系人和会话。