# Migrar desde otra plataforma

> Cómo traer a Memberfy los miembros de otra plataforma de comunidad o de cursos, con los grupos, las etiquetas, los campos del perfil, las insignias que cada persona ya tenía y los puntos iniciales, sin disparar avisos, con una planilla de ejemplo.

Si vienes de otra plataforma, no hace falta empezar de cero: una planilla trae a cada persona con lo que ya tenía allí, incluidas las **insignias** y los **puntos**, para que nadie pierda lo que consiguió. Las publicaciones antiguas llegan por otra planilla, con la fecha y el autor originales.

*Rol: propietario o administrador.*

## Qué se puede traer

| Qué | Cómo |
|---|---|
| Personas (correo, nombre, teléfono, cargo, biografía) | [Importar miembros desde una planilla](/membros/importar-membros) |
| Grupos, etiquetas y campos del perfil | En la misma planilla, una columna para cada uno. Un grupo que no existe se crea; un campo nuevo también |
| Insignias que cada persona ya tenía | En la misma planilla, la columna **Badges**, con los nombres del catálogo de la comunidad |
| Puntos que cada persona ya tenía | En la misma planilla, la columna **Puntos iniciales** |
| Publicaciones y artículos, con la fecha y el autor originales | [Importar contenido desde una planilla](/espacos/importar-conteudo) |

## Antes de importar

1. **Monta la estructura**: secciones, espacios y grupos. Ver [Monta la estructura](/primeiros-passos/monte-a-estrutura).
2. **Crea las insignias** en **Administración › Participación**, vista **Insignias**, **Nueva insignia**, con los **mismos nombres** de la plataforma antigua. Solo entran insignias que están en el catálogo: un nombre que no existe bloquea la importación hasta que lo crees o lo marques para ignorar. Ver [El catálogo](/membros/engajamento#el-catalogo).
3. **Activa la [gamificación](/membros/gamificacao)** y, si quieres, monta los niveles. Desactivada, los puntos de la planilla se ignoran.
4. **Exporta la planilla** de la plataforma antigua, en .xlsx o .csv, con una fila por persona.

## La planilla de ejemplo

Descarga la [planilla de ejemplo (.csv)](/exemplos/migrar-membros-es.csv) y cámbiala por tus datos:

| Correo | Nombre | Apellido | Cargo | Grupo | Insignias | Puntos | Acepto participar |
|---|---|---|---|---|---|---|---|
| maria@memberfy.net | María | Souza | Product Manager | Fundadores | Fundadora; Mentora | 1.500 | Sí |
| joao@memberfy.net | João | Lima | Ingeniero de datos | Fundadores | Mentor | 820 | Sí |
| ana@memberfy.net | Ana | Costa | Diseñadora | | Primera publicación | 250 | Sí |
| pedro@memberfy.net | Pedro | Alves | Analista | | | | Sí |

- **Insignias:** varias en la misma celda, separadas por `;`. La coma puede formar parte del nombre. Mayúsculas y acentos no importan.
- **Puntos:** un número entero de 1 a 100.000. Valen `1.500`, `1,500` y `250.0`; vacío o 0 no da puntos. Un valor con decimales (`12,5`) o que no es número no es válido: la persona entra sin los puntos, con aviso en la fila.

## Importar

1. **Administración › Miembros**, **Invitar Miembros**, pestaña **Importar planilla**.
2. Escribe el **Origen de la lista** (*Miembros de la plataforma antigua*), elige el archivo y sigue a **Columnas**.
3. Envía cada columna a su destino: *Correo* a **Correo**, *Nombre* y *Apellido*, *Cargo*, *Grupo* a **Grupos**, *Insignias* a **Badges**, *Puntos* a **Puntos iniciales** y *Acepto participar* a **Consentimiento**, con *Sí* contando como sí.
4. En el **Resumen**, revisa las insignias que no están en el catálogo (créalas o ignóralas), los puntos no válidos, quién ya recibió puntos de otra importación y **en qué nivel** quedarán las personas.
5. **Importar**.

## Qué pasa

- **Las personas nuevas** reciben la invitación por correo con **Definir mi contraseña**, como en toda importación; quien ya es miembro no recibe nada.
- **Las insignias y los puntos llegan en silencio:** ni correo ni aviso en la campana, y no se dispara ningún workflow (**Recibió una insignia**, **Subió de nivel**, **Alcanzó N puntos**). El [webhook](/api/eventos-de-webhook) de insignia recibida sí sale, con el origen importación.
- **Puntos una sola vez por persona**, sumando todas las importaciones: si importas de nuevo, quien ya los recibió no los gana otra vez.
- **Quien ya tiene la insignia** la conserva.
- El nivel de cada persona sale de los puntos. Quien llega por la importación aún no tiene actividad de la semana, así que un nivel que pide actividad llega cuando participe.

## Ejemplo

Una comunidad de 1.200 personas deja otra plataforma. Antes, crea en el catálogo las insignias *Fundadora*, *Mentora* y *Primera publicación* y activa la gamificación. La planilla trae una insignia *Beta tester* que ya no existe: en el resumen, la marca para ignorar. El resumen muestra 900 personas en el nivel 1, 280 en el nivel 3 y 20 en el nivel 5. Importa: las invitaciones salen, las insignias y los puntos aparecen en el perfil de cada uno, y nadie recibe aviso de insignia.

## Errores frecuentes y cómo resolverlos

| Situación | Qué hacer |
|---|---|
| *Estos badges no están en el catálogo: …* | Crea cada insignia con ese nombre en el catálogo o márcala para ignorar |
| La persona entró sin los puntos | El valor tenía decimales o no era número; corrígelo y ajústalo a mano en **Ajustar puntos**. Importar de nuevo no da los puntos a quien ya los recibió de una importación |
| Nadie recibió puntos | La gamificación estaba desactivada |
| La insignia no llegó | El nombre no coincide con el catálogo, o estaba marcado para ignorar |

## Relacionados

- [Importar miembros desde una planilla](/membros/importar-membros)
- [Importar contenido desde una planilla](/espacos/importar-conteudo)
- [Participación e insignias](/membros/engajamento#insignias)
- [Gamificación](/membros/gamificacao)