Migrare ad Agon
Dopo aver letto questa pagina saprai spostare in Agon clienti, abbonamenti e lezioni da un foglio di calcolo o da un file di esportazione, verificare come è stata abbinata ogni colonna, eseguire l'importazione e invitare i clienti importati a configurare i propri account.
Gli strumenti si trovano nell'app desktop, in Impostazioni → Migrazione. Questa scheda è visibile solo ai Manager. Non esiste una procedura guidata di onboarding separata: tutto avviene in quell'unica scheda.
Come funziona la migrazione
Agon non si collega alla tua vecchia piattaforma e non ti chiede le credenziali di accesso. Esporti tu stesso i tuoi dati dalla piattaforma attuale e carichi il file su Agon. In questo modo le tue credenziali restano al sicuro e si rimane entro ciò che la maggior parte delle piattaforme consente.
Nell'app la migrazione avviene in quattro passaggi:
- Scarica un modello (facoltativo) — un file già pronto con i nomi di colonna giusti.
- Scegli cosa stai importando — Clienti, Abbonamenti o Lezioni.
- Carica un file — Agon lo legge e abbina le tue colonne ai campi del tipo che hai scelto.
- Rivedi l'abbinamento delle colonne e importa — controlla gli abbinamenti, correggi quelli sbagliati e conferma.
Al termine di un'importazione clienti puoi inviare email di invito a tutte le persone importate.
Cosa puoi importare adesso
Puoi importare Clienti, Abbonamenti e Lezioni. Ognuno si importa separatamente: scegline uno sotto Cosa stai importando?, carica un file per quello e ripeti per gli altri.
I prodotti al dettaglio non sono supportati dalla migrazione e non possono essere importati.
Poiché abbonamenti e lezioni dipendono entrambi dall'esistenza dei clienti già in Agon, importa prima il tuo elenco clienti:
- Clienti — fallo sempre per primo. Senza, nulla può essere abbinato.
- Abbonamenti — richiede che l'email del cliente sia già in Agon e che il nome del tipo di abbonamento esista già come tipo di abbonamento in Agon.
- Lezioni — indipendente dai clienti, ma fallo per ultimo: le liste partecipanti/prenotazioni delle lezioni continuano ad arrivare separatamente dalla tua vecchia piattaforma.
File supportati
Il passaggio di caricamento accetta:
- CSV (
.csv) - Excel (
.xlsx) - JSON
La dimensione massima del file è 10 MB. Se la tua esportazione è più grande, dividila in più file e importali uno alla volta.
Passo 1 — Scarica un modello (facoltativo)
Se preferisci costruire il file a mano, o se l'esportazione della tua piattaforma usa nomi di colonna molto diversi, parti da un modello di Agon.
- Apri Impostazioni → Migrazione.
- Nella sezione Scarica i modelli, clicca una di queste voci:
- Scarica modello clienti
- Scarica modello abbonamenti
- Scarica modello lezioni
- Apri il CSV scaricato in Excel o Google Sheets, inserisci le tue righe e salvalo come CSV.
Non sei obbligato a usare un modello. Va bene qualsiasi file CSV, Excel o JSON: il passaggio di abbinamento nel Passo 3 ti permette di allineare le tue colonne ai campi di Agon.
Colonne del modello clienti
| Colonna | Obbligatoria? | Note |
|---|---|---|
full_name | Consigliata | Se una riga non ha nome, come nome del cliente viene usata la sua email. |
email | Obbligatoria | Una riga senza email viene saltata. |
phone | Facoltativa | |
date_of_birth | Facoltativa | Usa YYYY-MM-DD (per esempio 1990-01-15). |
notes | Facoltativa | Note libere sul cliente. |
billing_name | Facoltativa | Usata sulle fatture future di questo cliente, se diversa dal nome completo (per esempio la ragione sociale di un'azienda). Non è uno storico: Agon non importa le fatture dalla tua vecchia piattaforma. |
billing_address | Facoltativa | Usata sulle fatture future di questo cliente. |
tax_id | Facoltativa | Il codice fiscale o la partita IVA del cliente, usato sulle sue fatture future. |
Colonne del modello abbonamenti
| Colonna | Obbligatoria? | Note |
|---|---|---|
client_email | Obbligatoria | Deve già appartenere a un cliente in Agon — importa prima i clienti. |
membership_type_name | Obbligatoria | Abbinato per nome a un tipo di abbonamento già esistente in Agon. |
starts_at | Obbligatoria | Usa YYYY-MM-DD. |
expires_at | Facoltativa | Usa YYYY-MM-DD. Una data nel passato viene importata comunque, come abbonamento scaduto. |
credits_remaining | Facoltativa | Un numero intero. |
Colonne del modello lezioni
| Colonna | Obbligatoria? | Note |
|---|---|---|
class_name | Obbligatoria | Abbinato per nome a un tipo di lezione già esistente in Agon, oppure ne viene creato uno nuovo se nessuno corrisponde. |
starts_at | Obbligatoria | Usa YYYY-MM-DD HH:MM:SS. Un orario di inizio nel passato viene saltato. |
ends_at | Obbligatoria | Usa YYYY-MM-DD HH:MM:SS. |
capacity | Facoltativa | Un numero intero. Il valore predefinito è 1 se lasciato vuoto. |
instructor_name | Facoltativa | Abbinato per nome a un istruttore già esistente in Agon. Se non c'è corrispondenza, la lezione viene importata comunque, segnalata per l'assegnazione manuale dell'istruttore. |
Consulta Mappatura colonne per il comportamento completo di ogni campo, incluso cosa succede con un tipo di abbonamento o un istruttore non abbinati.
Passo 2 — Esporta i dati dalla tua piattaforma attuale
La maggior parte delle piattaforme offre un'esportazione self-service.
- Cerca un'opzione di esportazione o download nell'area Impostazioni, Amministrazione o Dati della tua piattaforma attuale.
- I dati dei clienti di solito si trovano sotto 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 ai sensi dell'Articolo 20 del GDPR. Ai sensi dell'Articolo 20 del GDPR, qualsiasi piattaforma che detiene dati personali dei tuoi clienti deve fornirteli su richiesta in un formato strutturato e leggibile da dispositivo automatico.
Consulta la guida GDPR per come formulare quella richiesta e cosa fare se la piattaforma non collabora.
Passo 3 — Scegli cosa stai importando, carica il file e rivedi l'abbinamento delle colonne
- Apri Impostazioni → Migrazione.
- Sotto Cosa stai importando?, clicca Clienti, Abbonamenti o Lezioni. Questa scelta decide quali campi Agon vengono proposti nel passaggio di abbinamento qui sotto — scegli l'entità che corrisponde al file che stai per caricare.
- Sotto Carica un file, scegli il tuo file CSV, Excel o JSON (fino a 10 MB).
- Clicca Analizza file.
- Agon mostra la tabella Rivedi l'abbinamento delle colonne. Ha già abbinato per te ogni colonna del tuo file a un campo di Agon ("Abbiamo abbinato ogni colonna del tuo file a un campo di Agon").
- Controlla ogni riga:
- Colonna nel tuo file — l'intestazione presa dal tuo file.
- Campo Agon — un menu a tendina. Le scelte dipendono dall'entità scelta sopra (Clienti, Abbonamenti o Lezioni) — consulta Mappatura colonne per l'elenco completo dei campi per ogni entità — plus — non importare —.
- Una colonna che Agon non è riuscito ad abbinare mostra un badge non mappata. Viene saltata a meno che tu non scelga un campo per essa.
- Correggi ogni abbinamento sbagliato scegliendo il campo corretto dal menu a tendina. Imposta una colonna su — non importare — per saltarla di proposito.
- Quando la tabella è corretta, clicca Conferma importazione.
Non c'è un indicatore di sicurezza a colori né un'anteprima riga per riga: Agon esegue l'importazione non appena confermi.
Importa un'entità alla volta. Per importare clienti, abbonamenti e lezioni, ripeti questo intero passaggio tre volte — una per entità — iniziando dai Clienti.
Per maggiori dettagli su come funziona l'abbinamento e come correggerlo, consulta Mappatura colonne.
Passo 4 — Importazione completata
Al termine dell'importazione, la scheda mostra:
- N importati — record aggiunti ad Agon.
- N ignorati — righe che non sono state importate.
- Un elenco Righe ignorate con un motivo per ciascuna riga saltata.
I motivi dipendono da cosa hai importato:
Clienti
- Row missing email — la riga non aveva alcun valore nella colonna abbinata a Email, quindi non è stato possibile importarla.
- Duplicate email skipped — in Agon esiste già un cliente con quell'indirizzo email. Il cliente esistente non viene toccato.
Abbonamenti
- Row missing client email — nessun valore nella colonna abbinata a Email cliente.
- Client email not found — in Agon non esiste ancora nessun cliente con quell'email. Importa prima i clienti, poi ri-importa questo file.
- Row missing membership type name — nessun valore nella colonna abbinata a Tipo di abbonamento.
- Membership type not found — in Agon non esiste nessun tipo di abbonamento con quel nome. Crea il tipo di abbonamento in Agon (Abbonamenti nella barra laterale sinistra), poi ri-importa.
- Row has invalid or missing starts_at — la data di inizio è assente o non in un formato che Agon può leggere.
Un abbonamento con data di scadenza nel passato non viene saltato — viene importato con stato scaduto, così il tuo storico resta intatto.
Lezioni
- Row missing class name — nessun valore nella colonna abbinata a Nome lezione.
- Row has invalid or missing start/end time — uno dei due orari è assente o non in un formato data/ora che Agon può leggere.
- Class start time is in the past — vengono importate solo le lezioni che iniziano nel futuro.
Una lezione senza un nome istruttore corrispondente non viene saltata — viene importata senza istruttore. L'elenco Righe ignorate e i conteggi importati/ignorati non lo segnalano riga per riga (è registrato solo nei log del backend, non mostrato in questa scheda), quindi dopo aver importato le lezioni controlla il tuo elenco lezioni per quelle che hanno ancora bisogno di un istruttore e assegnalo dalla schermata di modifica della lezione stessa. Anche un nome di lezione senza un tipo di lezione corrispondente in Agon non viene saltato — Agon crea automaticamente il tipo di lezione, usando l'orario di inizio/fine e la capacità di questa riga come valori predefiniti.
Per recuperare una riga saltata, correggila nel file di origine ed esegui di nuovo l'importazione con il file corretto.
Passo 5 — Invita i clienti importati
Questo passaggio si applica solo dopo l'importazione dei Clienti — abbonamenti e lezioni non hanno un passaggio di invito. Le password dei clienti non escono mai dalla tua vecchia piattaforma — sono memorizzate come hash irreversibili — quindi i clienti importati hanno bisogno di un invito per impostare la propria password di Agon.
Dopo l'importazione sono disponibili due azioni:
- Invia inviti via email — invia a ogni cliente importato in questo processo un link personale di iscrizione.
- Scarica elenco inviti (CSV) — un file con l'indirizzo email e il link di invito personale di ciascun cliente, così puoi inviare gli inviti con il tuo strumento email.
I link di invito scadono 7 giorni dopo la loro creazione. Se un link scade prima che il cliente lo usi, esegui di nuovo l'importazione per quel cliente (o usa un nuovo elenco inviti) per generarne uno nuovo.
Non esiste una schermata di cronologia degli inviti né un pulsante di reinvio per singolo cliente.
La sezione Invita i clienti importati viene mostrata dopo ogni importazione completata, anche dopo un'importazione di abbonamenti o lezioni. Inviare inviti in quel caso non ha alcun effetto, perché in quel processo non sono stati creati nuovi clienti — gli inviti vanno sempre e solo ai clienti creati da un'importazione Clienti.
Riprendere una migrazione
La scheda Migrazione ricorda a che punto eri:
- Se hai analizzato un file ma non l'hai importato, ricarica lo stesso file per tornare alla tabella Rivedi l'abbinamento delle colonne e completare.
- Se un'importazione è già stata completata, la scheda si apre sul passaggio Importazione completata così puoi inviare gli inviti.
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 detiene dati personali dei tuoi clienti deve fornire tali dati su richiesta in un formato strutturato e leggibile da dispositivo automatico. Invia una richiesta scritta al loro team di supporto. Se rifiutano o non rispondono entro 30 giorni, puoi rivolgerti alla tua autorità nazionale per la protezione dei dati. Consulta la guida GDPR.
Gli abbinamenti delle colonne sono sbagliati Correggili nella tabella Rivedi l'abbinamento delle colonne usando il menu a tendina nella colonna Campo Agon. Puoi anche rinominare le intestazioni nel tuo file per farle corrispondere ai nomi dei campi di Agon e caricarlo di nuovo. Consulta Mappatura colonne.
Alcune righe sono state saltate Apri l'elenco Righe ignorate e leggi il motivo. Consulta Mappatura colonne per cosa significa ogni motivo e come correggerlo — i motivi sono diversi per clienti, abbonamenti e lezioni. Correggi il file di origine e importalo di nuovo.
Tutte (o quasi tutte) le righe dei miei abbonamenti sono state saltate
La causa più comune è importare gli abbonamenti prima dei clienti — una riga di abbonamento viene saltata se l'email del cliente non è già in Agon. Importa prima il tuo file Clienti, poi ri-importa il file abbonamenti. La seconda causa più comune è un membership_type_name che non corrisponde a nessun tipo di abbonamento già configurato in Agon (Abbonamenti nella barra laterale sinistra) — il nome deve corrispondere esattamente (maiuscole/minuscole non contano, l'ortografia sì).
Un cliente non ha ricevuto l'invito, o il suo link è scaduto Chiedi al cliente di controllare la cartella spam. I link di invito durano 7 giorni; per emetterne uno nuovo, esegui di nuovo l'importazione per quel cliente o invia un nuovo elenco inviti. Non esiste un pulsante di reinvio. Questo vale solo per un'importazione Clienti — abbonamenti e lezioni non inviano inviti.
Non vedo la scheda Migrazione È mostrata solo ai Manager. Chiedi a un Manager del tuo studio di eseguire la migrazione, o di cambiare il tuo ruolo.
Una lezione è stata importata senza istruttore
Questo succede quando l'instructor_name nel tuo file non corrisponde esattamente al nome di un istruttore in Agon. La lezione viene importata comunque — aprila dall'elenco lezioni e assegna manualmente l'istruttore.