Passa al contenuto principale

Migrare ad Agon

Questa guida spiega come trasferire i dati esistenti dei tuoi clienti, gli abbonamenti e il calendario delle lezioni dalla tua piattaforma attuale ad Agon. L'assistente di migrazione ti guida in ogni passaggio.

Come funziona la migrazione​

L'assistente di migrazione di Agon non si collega direttamente alla tua vecchia piattaforma e non chiede le tue credenziali di accesso. Ti guida invece nell'ottenere i tuoi dati dalla piattaforma attuale e nell'importarli.

Questo approccio ti tutela legalmente (la maggior parte delle piattaforme vieta l'accesso automatizzato basato su credenziali) e mantiene le tue credenziali al sicuro.

La migrazione avviene in quattro fasi:

  1. Ottieni i tuoi dati — esportali dalla tua vecchia piattaforma
  2. Carica e mappa le colonne — l'assistente analizza i tuoi file e li mappa al formato di Agon
  3. Anteprima e importazione — verifica cosa verrà importato e conferma
  4. Invita i clienti — invia email di invito così i clienti possono configurare i loro account Agon

Formati file supportati​

L'assistente di migrazione accetta qualsiasi file CSV. Sono supportati anche i file Excel (.xlsx). Sono accettati anche export JSON da alcune piattaforme.

Agon fornisce anche modelli CSV standard se preferisci preparare i tuoi dati manualmente. Vedi Modelli CSV standard più sotto.

Passo 1 — Scarica il modello CSV (facoltativo)​

Se vuoi preparare i tuoi dati manualmente, o se l'export della tua piattaforma non corrisponde al formato di Agon:

  1. Vai su Impostazioni → Migrazione nell'app desktop.
  2. Clicca Scarica modello e scegli il tipo di entità:
    • Modello clienti — full_name, email, phone, date_of_birth
    • Modello abbonamenti — client_email, membership_type_name, starts_at, expires_at, credits_remaining
    • Modello lezioni — class_name, starts_at, ends_at, capacity, instructor_name
  3. Apri il modello in Excel o Google Sheets, inserisci i tuoi dati e salva come CSV.

Passo 2 — Esporta i dati dalla tua piattaforma attuale​

La maggior parte delle piattaforme offre un'opzione di esportazione dati. L'assistente di migrazione ti guiderà in base alla piattaforma da cui stai migrando.

Approccio generale:

  • Controlla l'area Impostazioni o Amministrazione della tua piattaforma attuale per un'opzione di esportazione o download dati
  • Cerca opzioni di esportazione nella sezione Clienti, Membri o Contatti
  • Se non è disponibile un'esportazione self-service, contatta il team di supporto della piattaforma e richiedi un'esportazione per portabilità dei dati GDPR — ai sensi dell'Articolo 20 del GDPR, sono legalmente tenuti a fornirla

Priorità di importazione — segui quest'ordine:

  1. Clienti (nome, email, telefono) — necessari per primi; tutto il resto dipende da questo
  2. Abbonamenti attivi (tipo, scadenza, crediti) — determina chi può prenotare dal primo giorno
  3. Lezioni future — evita disagi nelle prime settimane dopo il passaggio
  4. Cronologia presenze e pagamenti — utile ma non urgente; puoi tenerla come archivio nel tuo vecchio sistema

Passo 3 — Carica il tuo file​

  1. Vai su Impostazioni → Migrazione nell'app desktop Agon.
  2. Clicca Carica file.
  3. Seleziona il file CSV o Excel dal tuo computer.
  4. L'assistente analizza il file e mostra un'anteprima della mappatura colonne.

L'assistente usa l'IA per abbinare automaticamente i nomi delle tue colonne ai campi di Agon. Ad esempio, una colonna chiamata "Nome cliente" viene mappata automaticamente a full_name, e "Indirizzo email" viene mappata a email.

Vedi Guida alla mappatura colonne per i dettagli su come funziona e come correggere le mappature manualmente.

Passo 4 — Rivedi la mappatura delle colonne​

Dopo il caricamento, l'assistente mostra una tabella delle tue colonne e di come ciascuna è stata mappata a un campo Agon.

  • Verde — mappata con sicurezza
  • Giallo — mappata con bassa sicurezza — rivedi e conferma
  • Rosso — non è stato possibile mapparla — mappala manualmente oppure lasciala non mappata (quei dati non verranno importati)

Per cambiare una mappatura:

  1. Clicca sul menu a tendina accanto al nome della colonna.
  2. Seleziona il campo Agon corretto dall'elenco.
  3. Clicca Salva mappatura.

Quando sei soddisfatto della mappatura, clicca Anteprima importazione.

Passo 5 — Anteprima e conferma dell'importazione​

L'anteprima mostra un campione dei record che verranno importati, insieme a un riepilogo:

  • Numero di record pronti per l'importazione
  • Numero di record che verranno saltati (con i motivi)

Motivi comuni di esclusione:

  • Email duplicata — un cliente con questa email esiste già in Agon; il record viene saltato per evitare di sovrascrivere dati esistenti
  • Campo obbligatorio mancante — al record manca un valore richiesto (es. l'indirizzo email è vuoto)
  • Tipo di abbonamento non corrispondente — il nome del tipo di abbonamento non corrisponde a nessun tipo di abbonamento esistente in Agon; crea prima il tipo di abbonamento, poi reimporta
  • Lezione passata — vengono importate solo le lezioni future; le lezioni passate vengono saltate

Rivedi i record esclusi. Per ciascuno puoi:

  • Escludi definitivamente — escluderlo da questa importazione
  • Modifica nel file di origine — correggi i dati, ricarica e riprova

Quando sei pronto, clicca Conferma importazione per eseguire l'importazione.

Passo 6 — Invia email di invito ai clienti importati​

Le password dei clienti non vengono mai esportate dalle piattaforme (sono cifrate e irreversibili). Dopo aver importato i clienti, devi invitarli a creare i loro account Agon.

Al termine dell'importazione, vedrai un pulsante Invita clienti.

Opzione A — Invia inviti direttamente da Agon Clicca Invia inviti. Ogni cliente importato riceve un'email con un link personale per configurare il proprio account Agon. Il suo abbonamento e la cronologia prenotazioni saranno già caricati quando accede.

I link di invito scadono dopo 7 giorni. Puoi reinviarli in qualsiasi momento.

Opzione B — Scarica l'elenco inviti come CSV Se preferisci inviare gli inviti tramite un tuo strumento email (es. Mailchimp, la tua email personale):

  1. Clicca Scarica elenco inviti.
  2. Il CSV contiene il nome, l'indirizzo email e il link di invito personale di ciascun cliente.
  3. Usa il tuo strumento email per inviare gli inviti.

Riepilogo dell'importazione​

Al termine dell'importazione, vedrai un riepilogo:

  • Clienti importati
  • Abbonamenti importati
  • Lezioni importate
  • Record esclusi (con i motivi)

Conserva questo riepilogo per i tuoi archivi.

Modelli CSV standard​

Scarica questi modelli da Impostazioni → Migrazione → Scarica modello:

Clienti Colonne obbligatorie: full_name, email Colonne facoltative: phone, date_of_birth

Abbonamenti Colonne obbligatorie: client_email, membership_type_name, starts_at Colonne facoltative: expires_at, credits_remaining Nota: client_email deve corrispondere a un'email già importata in Agon.

Lezioni Colonne obbligatorie: class_name, starts_at, ends_at Colonne facoltative: capacity, instructor_name Nota: vengono importate solo le lezioni con data di inizio futura.

Cosa fare se qualcosa va storto?​

La mia vecchia piattaforma non mi fornisce un'esportazione dati Ai sensi dell'Articolo 20 del GDPR (Diritto alla portabilità dei dati), qualsiasi piattaforma che conserva dati personali dei tuoi clienti è legalmente tenuta a fornirteli in un formato strutturato e leggibile da dispositivo automatico su richiesta. Invia una richiesta scritta formale al loro team di supporto. Se rifiutano o non rispondono entro 30 giorni, puoi rivolgerti alla tua autorità nazionale per la protezione dei dati (DPA).

La mappatura delle colonne ha sbagliato tutto Correggi le mappature manualmente nel passaggio di revisione — usa il menu a tendina per ciascuna colonna per selezionare il campo Agon corretto. Puoi anche modificare il tuo CSV per rinominare le colonne secondo i nomi attesi da Agon (vedi i nomi dei modelli sopra) e ricaricare.

Un cliente dice di non aver ricevuto il proprio invito Vai su Impostazioni → Migrazione → Cronologia inviti, trova il cliente e clicca Reinvia invito. Chiedi anche al cliente di controllare la cartella spam.

Pagine correlate​