**Para migrar tus conversaciones y contactos de otra plataforma a Papo (https://papo.global/), puedes exportar los datos del sistema anterior, importar los contactos en masa mediante un archivo CSV y utilizar la API de Papo para recrear el historial de conversaciones, garantizando que no se pierda ninguna información en la transición.**

La migración de una plataforma de atención anterior a Papo implica tres etapas principales: extraer los datos del sistema de origen, cargar los contactos en el CRM de Papo y, si es necesario, traer el historial de interacciones usando la API. Papo ofrece herramientas que simplifican este proceso, evitando la digitación manual y preservando el contexto de las relaciones con los clientes.

## Resumen de la migración

| Etapa | Acción | Dónde en Papo |
| :--- | :--- | :--- |
| 1. Exportar del sistema anterior | Generar archivo CSV con contactos y, si es posible, historial de conversaciones. | — |
| 2. Preparar el CSV | Organizar columnas (nombre, email, teléfono, etiquetas) y estandarizar datos. | — |
| 3. Importar contactos en masa | Subir el CSV y mapear los campos. | Módulo Contactos > Importar |
| 4. Migrar historial (opcional) | Usar la API para crear contactos y mensajes programáticamente. | API (clave pública y secreta) |
| 5. Verificar la migración | Comprobar que los contactos y las conversaciones aparezcan correctamente. | Módulos Contactos y Conversaciones |

## Cómo funciona – paso a paso

### 1. Exporta los datos de tu sistema actual

La mayoría de las plataformas de CRM y atención permite exportar contactos y conversaciones a CSV o pone a disposición una API para extracción. Consulta la documentación de tu sistema anterior para generar esos archivos. Lo ideal es obtener:

- Lista de contactos con nombre, email, teléfono y etiquetas (tags).
- Si es posible, un archivo con el historial de mensajes (fecha, remitente, texto).

Si el sistema no ofrece exportación de conversaciones, aún puedes migrar los contactos e iniciar las nuevas interacciones en Papo con todo el contexto disponible en el CRM.

### 2. Prepara el archivo CSV para importación de contactos

La calidad de la importación depende de la organización del archivo. Antes de subir la lista, verifica:

- **Formato**: guarda como `.csv` (valores separados por comas).
- **Encabezados**: la primera fila debe contener los nombres de las columnas, como `nombre`, `email`, `teléfono`, `etiquetas`.
- **Datos limpios**: elimina celdas combinadas, filas en blanco y formatos especiales. Estandariza los números de teléfono con código de país y código de área (ej.: 55119XXXXXXXX).

Ejemplo de estructura:

| nombre | email | teléfono | etiquetas |
| :--- | :--- | :--- | :--- |
| María Silva | maria.silva@email.com | 5511987654321 | lead-caliente, evento-sp |
| João Costa | joao.costa@email.com | 5521912345678 | cliente-activo |

Usa la columna `etiquetas` para segmentar los contactos ya en la importación, separando múltiples etiquetas por comas.

### 3. Importa los contactos en masa en Papo

Con el CSV listo, sube el archivo a Papo:

1. Accede al módulo **Contactos** en el CRM.
2. Localiza la opción **Importar contactos** (normalmente cerca del botón para crear un nuevo contacto).
3. Sube tu archivo CSV.
4. En la etapa de mapeo, asocia cada columna de tu archivo al campo correspondiente en Papo (ej.: columna `nombre` → campo Nombre). Esto incluye campos personalizados, si los hay.
5. Revisa el mapeo e inicia la importación.

La plataforma procesa el archivo en segundo plano. Al final, los contactos aparecen en tu base, listos para ser incluidos en campañas, embudos o atenciones.

### 4. Trae el historial de conversaciones con la API de Papo (opcional)

Si necesitas preservar el historial completo de interacciones, la API de Papo permite crear contactos y registrar mensajes de forma programática. Este método es útil cuando el sistema anterior proporciona un extracto detallado de las conversaciones.

Para usar la API:

- Genera tus claves de acceso (pública y secreta) siguiendo la guía [Cómo generar una clave pública y una clave secreta de la API Papo](/hc/papo/articles/como-generar-clave-publica-y-secreta-api-papo).
- Desarrolla un script que lea los datos exportados del sistema anterior y llame a los endpoints apropiados para crear contactos (si aún no se han importado) y enviar los mensajes históricos.
- Consulta la documentación oficial de la API en [https://papo.global/docs](https://papo.global/docs) para conocer los endpoints, parámetros y límites exactos.

Este enfoque garantiza que el contexto de atención anterior esté disponible en el CRM de Papo, lo que permite que tu equipo retome conversaciones pasadas sin perder información.

### 5. Verifica la migración

Después de la importación y, si corresponde, la carga vía API, accede a los módulos **Contactos** y **Conversaciones** para confirmar que:

- Todos los contactos aparecen con los campos completados correctamente.
- Las etiquetas se aplicaron según el CSV.
- El historial de mensajes (si se migró) es visible en la línea de tiempo del contacto.

Si algo no coincide, puedes corregirlo manualmente o repetir la importación con los ajustes necesarios.

## Para quién es útil esta migración

- Empresas que están cambiando de plataforma de atención y desean centralizar todo en Papo.
- Equipos que usaban múltiples herramientas (CRM, chat, email) y quieren unificar contactos e historial en un solo lugar.
- Operaciones que no pueden perder el contexto de conversaciones antiguas al adoptar un nuevo sistema.
- Negocios que necesitan una transición rápida, sin escribir contactos uno por uno.

## Preguntas frecuentes

### ¿Necesito exportar los contactos en un formato específico?
Sí, el formato aceptado es CSV con encabezados. La mayoría de las hojas de cálculo (Excel, Google Sheets) puede guardar en ese formato.

### ¿Puedo importar campos personalizados además de nombre, email y teléfono?
Sí. Durante el mapeo, puedes asociar columnas del CSV a campos personalizados que ya existan en tu cuenta de Papo.

### ¿La importación masiva tiene límite de contactos?
Los límites pueden variar según el plan. Para obtener información actualizada, consulta el centro de ayuda o el sitio web de Papo.

### ¿Cómo hago para migrar las conversaciones si no tengo desarrollador?
Puedes importar solo los contactos y comenzar a atender en Papo a partir de la migración. El historial anterior permanece accesible en el sistema anterior, si es necesario.

### ¿La API permite recrear conversaciones de cualquier canal?
La API de Papo está documentada en [https://papo.global/docs](https://papo.global/docs). Allí encontrarás los canales admitidos y las operaciones disponibles para registrar mensajes.

### ¿Qué sucede si mi CSV tiene errores?
La plataforma puede rechazar filas con datos inválidos. Recomendamos validar la hoja de cálculo antes de la importación, eliminando duplicados y estandarizando los teléfonos.

## Lee también

- [Cómo generar una clave pública y una clave secreta de la API Papo](/hc/papo/articles/como-generar-clave-publica-y-secreta-api-papo)
- [Cómo configurar Papo en 5 pasos para empezar a atender en WhatsApp](/hc/papo/articles/como-configurar-papo-en-5-pasos-para-empezar-a-atender-en-whatsapp)

---

**[Comienza tu migración gratis →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=como-migrar-conversaciones-y-contactos-de-otra-plataforma-a-papo&utm_content=es)**

Crea tu cuenta en Papo sin costo y centraliza contactos y conversaciones en una única plataforma.