Saltar al contenido principal

Migrar a Agon

Después de leer esta página podrás pasar a Agon tus clientes, membresías y clases desde una hoja de cálculo o un archivo de exportación, comprobar cómo se asignó cada columna, ejecutar la importación e invitar a los clientes importados a configurar sus cuentas.

Las herramientas están en la app de escritorio, en Configuración → Migración. Esta pestaña solo la ven los Managers. No hay un asistente de incorporación aparte: todo ocurre en esa única pestaña.


Cómo funciona la migración​

Agon no se conecta a tu plataforma anterior y no te pide tus datos de acceso. Tú exportas tus propios datos desde tu plataforma actual y subes el archivo a Agon. Así tus credenciales quedan protegidas y todo se mantiene dentro de lo que la mayoría de plataformas permite.

En la app, la migración tiene cuatro pasos:

  1. Descarga una plantilla (opcional): un archivo ya preparado con los nombres de columna correctos.
  2. Elige qué estás importando: Clientes, Membresías o Clases.
  3. Sube un archivo: Agon lo lee y asocia tus columnas con los campos del tipo elegido.
  4. Revisa la asignación de columnas e importa: comprueba las asociaciones, corrige las que estén mal y confirma.

Cuando termine una importación de clientes podrás enviar correos de invitación a todas las personas importadas.


Qué puedes importar ahora mismo​

Puedes importar Clientes, Membresías y Clases. Cada uno se importa por separado: elige uno en ¿Qué estás importando?, sube un archivo para él y repite para los demás.

Los productos de venta no están admitidos por la migración y no se pueden importar.

Como las membresías y las clases dependen de que los clientes ya existan en Agon, importa primero tu lista de clientes:

  1. Clientes: hazlo siempre primero. Sin esto, nada más se puede asociar.
  2. Membresías: necesita que el correo del cliente ya esté en Agon, y que el nombre del tipo de membresía ya exista como tipo de membresía en Agon.
  3. Clases: independiente de los clientes, pero hazlo al final, ya que las listas de participantes/reservas de las clases siguen llegando por separado desde tu plataforma anterior.

Archivos admitidos​

El paso de subida acepta:

  • CSV (.csv)
  • Excel (.xlsx)
  • JSON

El tamaño máximo de archivo es 10 MB. Si tu exportación es mayor, divídela en varios archivos e impórtalos de uno en uno.


Paso 1 — Descarga una plantilla (opcional)​

Si prefieres crear tu archivo a mano, o si la exportación de tu plataforma usa nombres de columna muy distintos, empieza a partir de una plantilla de Agon.

  1. Abre Configuración → Migración.
  2. En la sección Descargar plantillas, haz clic en una de estas opciones:
    • Descargar plantilla de clientes
    • Descargar plantilla de membresías
    • Descargar plantilla de clases
  3. Abre el CSV descargado en Excel o Google Sheets, rellena tus filas y guárdalo como CSV.

No tienes que usar una plantilla. Sirve cualquier archivo CSV, Excel o JSON: el paso de asignación del Paso 3 te permite alinear tus columnas con los campos de Agon.

Columnas de la plantilla de clientes​

Columna¿Obligatoria?Notas
full_nameRecomendadaSi una fila no tiene nombre, se usa el correo del cliente como nombre.
emailObligatoriaUna fila sin correo se omite.
phoneOpcional
date_of_birthOpcionalUsa YYYY-MM-DD (por ejemplo 1990-01-15).
notesOpcionalNotas libres sobre el cliente.
billing_nameOpcionalSe usa en las futuras facturas de este cliente, si es distinto de su nombre completo (por ejemplo, el nombre de una empresa). No es un historial: Agon no importa facturas de tu plataforma anterior.
billing_addressOpcionalSe usa en las futuras facturas de este cliente.
tax_idOpcionalEl NIF/CIF o número de IVA del cliente, usado en sus futuras facturas.

Columnas de la plantilla de membresías​

Columna¿Obligatoria?Notas
client_emailObligatoriaDebe pertenecer ya a un cliente en Agon: importa primero tus clientes.
membership_type_nameObligatoriaSe asocia por nombre a un tipo de membresía ya existente en Agon.
starts_atObligatoriaUsa YYYY-MM-DD.
expires_atOpcionalUsa YYYY-MM-DD. Una fecha ya pasada se importa igualmente, como membresía caducada.
credits_remainingOpcionalUn número entero.

Columnas de la plantilla de clases​

Columna¿Obligatoria?Notas
class_nameObligatoriaSe asocia por nombre a un tipo de clase ya existente en Agon, o se crea uno nuevo si ninguno coincide.
starts_atObligatoriaUsa YYYY-MM-DD HH:MM:SS. Una hora de inicio ya pasada se omite.
ends_atObligatoriaUsa YYYY-MM-DD HH:MM:SS.
capacityOpcionalUn número entero. Por defecto es 1 si se deja en blanco.
instructor_nameOpcionalSe asocia por nombre a un instructor ya existente en Agon. Sin coincidencia, la clase se importa igualmente, marcada para asignación manual de instructor.

Consulta Mapeo de columnas para el comportamiento completo de cada campo, incluido lo que ocurre con un tipo de membresía o un instructor sin asignar.


Paso 2 — Exporta tus datos desde tu plataforma actual​

La mayoría de plataformas tienen una exportación de autoservicio.

  • Busca una opción de exportación o descarga en el área de Configuración, Administración o Datos de tu plataforma actual.
  • Los datos de clientes suelen estar en Clientes, Miembros o Contactos.
  • Si no hay una exportación de autoservicio, contacta con el equipo de soporte de la plataforma y pide una exportación de portabilidad de datos según el Artículo 20 del RGPD. Según el Artículo 20 del RGPD, cualquier plataforma que tenga datos personales de tus clientes debe entregártelos, si lo solicitas, en un formato estructurado y legible por máquina.

Consulta la guía del RGPD para saber cómo redactar esa solicitud y qué hacer si la plataforma no coopera.


Paso 3 — Elige qué estás importando, sube el archivo y revisa la asignación de columnas​

  1. Abre Configuración → Migración.
  2. En ¿Qué estás importando?, haz clic en Clientes, Membresías o Clases. Esta elección decide qué campos de Agon se ofrecen en el paso de asignación de abajo: elige la entidad que corresponde al archivo que vas a subir.
  3. En Subir un archivo, elige tu archivo CSV, Excel o JSON (hasta 10 MB).
  4. Haz clic en Analizar archivo.
  5. Agon muestra la tabla Revisar la asignación de columnas. Ha asociado por ti cada columna de tu archivo con un campo de Agon ("Hemos asociado cada columna de tu archivo con un campo de Agon").
  6. Revisa cada fila:
    • Columna de tu archivo: el encabezado tomado de tu archivo.
    • Campo de Agon: un menú desplegable. Las opciones dependen de la entidad elegida arriba (Clientes, Membresías o Clases) — consulta Mapeo de columnas para la lista completa de campos por entidad — más — no importar —.
    • Una columna que Agon no ha podido asociar muestra una etiqueta sin asignar. Se omite a menos que elijas un campo para ella.
  7. Corrige cualquier asociación incorrecta eligiendo el campo correcto en el menú desplegable. Pon una columna en — no importar — para omitirla a propósito.
  8. Cuando la tabla esté bien, haz clic en Confirmar importación.

No hay un indicador de confianza con colores ni una vista previa fila por fila: Agon ejecuta la importación en cuanto confirmas.

Importa una entidad a la vez. Para importar clientes, membresías y clases, repite este paso completo tres veces, una por entidad, empezando por Clientes.

Para más detalle sobre cómo funciona la asociación y cómo corregirla, consulta Mapeo de columnas.


Paso 4 — Importación completada​

Cuando termina la importación, la pestaña muestra:

  • N importados: registros añadidos a Agon.
  • N omitidos: filas que no se importaron.
  • Una lista de Filas omitidas con un motivo para cada fila omitida.

Los motivos dependen de lo que hayas importado:

Clientes

  • Row missing email: la fila no tenía ningún valor en la columna asignada a Correo electrónico, por lo que no se pudo importar.
  • Duplicate email skipped: ya existe en Agon un cliente con esa dirección de correo. El cliente existente no se modifica.

Membresías

  • Row missing client email: sin valor en la columna asignada a Correo del cliente.
  • Client email not found: todavía no existe ningún cliente con ese correo en Agon. Importa primero tus clientes y vuelve a importar este archivo.
  • Row missing membership type name: sin valor en la columna asignada a Tipo de membresía.
  • Membership type not found: no existe en Agon ningún tipo de membresía con ese nombre. Crea el tipo de membresía en Agon (Membresías en el menú lateral izquierdo) y vuelve a importar.
  • Row has invalid or missing starts_at: falta la fecha de inicio o no tiene un formato que Agon pueda leer.

Una membresía cuya fecha de caducidad ya pasó no se omite: se importa con estado caducada, para conservar tu historial.

Clases

  • Row missing class name: sin valor en la columna asignada a Nombre de la clase.
  • Row has invalid or missing start/end time: falta una de las dos horas o no tiene un formato de fecha/hora que Agon pueda leer.
  • Class start time is in the past: solo se importan las clases que empiezan en el futuro.

Una clase sin nombre de instructor coincidente no se omite: se importa sin instructor. La lista Filas omitidas y los contadores de importados/omitidos no lo indican fila por fila (solo queda registrado en los registros internos del servidor, no se muestra en esta pestaña), así que después de importar clases revisa tu lista de clases por si alguna necesita que le asignes un instructor, y añádelo desde la propia pantalla de edición de la clase. Un nombre de clase sin un tipo de clase coincidente en Agon tampoco se omite: Agon crea automáticamente el tipo de clase, usando la hora de inicio/fin y la capacidad de esa fila como valores por defecto.

Para recuperar una fila omitida, corrígela en tu archivo de origen y vuelve a ejecutar la importación con el archivo corregido.


Paso 5 — Invita a los clientes importados​

Este paso solo se aplica después de importar Clientes: las membresías y las clases no tienen paso de invitación. Las contraseñas de los clientes nunca salen de tu plataforma anterior —se guardan como hashes irreversibles—, así que los clientes importados necesitan una invitación para definir su propia contraseña de Agon.

Después de la importación hay dos acciones disponibles:

  • Enviar invitaciones por correo: envía a cada cliente importado en este proceso un enlace personal de registro.
  • Descargar lista de invitaciones (CSV): un archivo con la dirección de correo y el enlace de invitación personal de cada cliente, para que envíes las invitaciones con tu propia herramienta de correo.

Los enlaces de invitación caducan 7 días después de crearse. Si un enlace caduca antes de que el cliente lo use, vuelve a ejecutar la importación para ese cliente (o usa una lista de invitaciones nueva) para generar uno nuevo.

No hay una pantalla de historial de invitaciones ni un botón de reenvío por cliente.

La sección Invitar a los clientes importados se muestra después de cada importación completada, incluida una importación de membresías o clases. Enviar invitaciones ahí en ese caso no tiene ningún efecto, ya que en ese proceso no se creó ningún cliente nuevo: las invitaciones solo se envían a los clientes creados por una importación de Clientes.


Retomar una migración​

La pestaña Migración recuerda por dónde ibas:

  • Si analizaste un archivo pero no lo importaste, vuelve a subir el mismo archivo para regresar a la tabla Revisar la asignación de columnas y terminar.
  • Si una importación ya se completó, la pestaña se abre en el paso Importación completada para que puedas enviar las invitaciones.

¿Qué hacer si algo va mal?​

Mi plataforma anterior no me da una exportación de datos Según el Artículo 20 del RGPD (derecho a la portabilidad de los datos), cualquier plataforma que tenga datos personales de tus clientes debe facilitar esos datos, si lo solicitas, en un formato estructurado y legible por máquina. Envía una solicitud por escrito a su equipo de soporte. Si se niegan o no responden en 30 días, puedes escalar a tu autoridad nacional de protección de datos. Consulta la guía del RGPD.

Las asociaciones de columnas están mal Corrígelas en la tabla Revisar la asignación de columnas usando el menú desplegable de la columna Campo de Agon. También puedes renombrar los encabezados de tu archivo para que coincidan con los nombres de los campos de Agon y volver a subirlo. Consulta Mapeo de columnas.

Se omitieron algunas filas Abre la lista Filas omitidas y lee el motivo. Consulta Mapeo de columnas para saber qué significa cada motivo y cómo solucionarlo: los motivos son distintos para clientes, membresías y clases. Corrige el archivo de origen e impórtalo de nuevo.

Se omitieron todas (o casi todas) mis filas de membresías La causa más habitual es importar las membresías antes que los clientes: una fila de membresía se omite si el correo de su cliente no está ya en Agon. Importa primero tu archivo de Clientes y luego vuelve a importar el archivo de membresías. La segunda causa más habitual es un membership_type_name que no coincide con ningún tipo de membresía ya configurado en Agon (Membresías en el menú lateral izquierdo): el nombre tiene que coincidir exactamente (las mayúsculas/minúsculas no importan, la ortografía sí).

Un cliente no recibió su invitación, o su enlace caducó Pide al cliente que revise su carpeta de spam. Los enlaces de invitación duran 7 días; para emitir uno nuevo, vuelve a ejecutar la importación para ese cliente o envía una lista de invitaciones nueva. No hay botón de reenvío. Esto solo se aplica a una importación de Clientes: las membresías y las clases no envían invitaciones.

No veo la pestaña Migración Solo se muestra a los Managers. Pide a un Manager de tu estudio que ejecute la migración, o que cambie tu rol.

Una clase se importó sin instructor Esto ocurre cuando el instructor_name de tu archivo no coincide exactamente con el nombre de un instructor en Agon. La clase se importa igualmente: ábrela desde la lista de clases y asigna el instructor manualmente.

Páginas relacionadas​