Migrer vers Agon
Après avoir lu cette page, vous saurez transférer vos clients, abonnements et cours dans Agon depuis un tableur ou un fichier d'export, vérifier comment chaque colonne a été associée, lancer l'import et inviter les clients importés à configurer leur compte.
Les outils se trouvent dans l'application de bureau, sous Paramètres → Migration. Cet onglet n'est visible que par les Managers. Il n'y a pas d'assistant d'intégration distinct : tout se passe dans ce seul onglet.
Comment fonctionne la migration
Agon ne se connecte pas à votre ancienne plateforme et ne vous demande pas vos identifiants de connexion. Vous exportez vous-même vos données depuis votre plateforme actuelle et vous importez le fichier dans Agon. Vos identifiants restent ainsi protégés et l'on reste dans les limites de ce que la plupart des plateformes autorisent.
Dans l'application, la migration comporte quatre étapes :
- Télécharger un modèle (facultatif) — un fichier prêt à l'emploi avec les bons noms de colonnes.
- Choisir ce que vous importez — Clients, Abonnements ou Cours.
- Importer un fichier — Agon le lit et associe vos colonnes aux champs du type choisi.
- Vérifier la correspondance des colonnes et importer — contrôlez les associations, corrigez celles qui sont fausses et confirmez.
Une fois un import de clients terminé, vous pouvez envoyer des e-mails d'invitation à toutes les personnes importées.
Ce que vous pouvez importer pour l'instant
Vous pouvez importer des Clients, des Abonnements et des Cours. Chacun s'importe séparément : choisissez-en un sous Que voulez-vous importer ?, importez un fichier pour celui-ci, puis répétez pour les autres.
Les produits en vente ne sont pas pris en charge par la migration et ne peuvent pas être import és.
Comme les abonnements et les cours dépendent tous deux de l'existence préalable des clients dans Agon, importez d'abord votre liste de clients :
- Clients — faites-le toujours en premier. Rien d'autre ne peut être associé sans cela.
- Abonnements — nécessite que l'e-mail du client soit déjà dans Agon, et que le nom du type d'abonnement existe déjà comme type d'abonnement dans Agon.
- Cours — indépendant des clients, mais à faire en dernier : les listes de participants/réservations des cours continuent d'arriver séparément depuis votre ancienne plateforme.
Fichiers pris en charge
L'étape d'import accepte :
- CSV (
.csv) - Excel (
.xlsx) - JSON
La taille maximale du fichier est de 10 Mo. Si votre export est plus volumineux, divisez-le en plusieurs fichiers et importez-les un par un.
Étape 1 — Télécharger un modèle (facultatif)
Si vous préférez construire votre fichier à la main, ou si l'export de votre plateforme utilise des noms de colonnes très différents, partez d'un modèle Agon.
- Ouvrez Paramètres → Migration.
- Dans la section Télécharger les modèles, cliquez sur l'une de ces options :
- Télécharger le modèle clients
- Télécharger le modèle abonnements
- Télécharger le modèle cours
- Ouvrez le CSV téléchargé dans Excel ou Google Sheets, saisissez vos lignes et enregistrez-le au format CSV.
Vous n'êtes pas obligé d'utiliser un modèle. N'importe quel fichier CSV, Excel ou JSON convient : l'étape d'association de l'Étape 3 vous permet d'aligner vos colonnes sur les champs d'Agon.
Colonnes du modèle clients
| Colonne | Obligatoire ? | Remarques |
|---|---|---|
full_name | Recommandée | Si une ligne n'a pas de nom, l'e-mail du client est utilisé comme nom. |
email | Obligatoire | Une ligne sans e-mail est ignorée. |
phone | Facultative | |
date_of_birth | Facultative | Utilisez YYYY-MM-DD (par exemple 1990-01-15). |
notes | Facultative | Notes libres sur le client. |
billing_name | Facultative | Utilisé sur les futures factures de ce client, si différent de son nom complet (par exemple le nom d'une société). Ce n'est pas un historique : Agon n'importe pas les factures de votre ancienne plateforme. |
billing_address | Facultative | Utilisée sur les futures factures de ce client. |
tax_id | Facultative | Le numéro fiscal ou de TVA du client, utilisé sur ses futures factures. |
Colonnes du modèle abonnements
| Colonne | Obligatoire ? | Remarques |
|---|---|---|
client_email | Obligatoire | Doit déjà appartenir à un client dans Agon — importez d'abord vos clients. |
membership_type_name | Obligatoire | Associé par nom à un type d'abonnement déjà existant dans Agon. |
starts_at | Obligatoire | Utilisez YYYY-MM-DD. |
expires_at | Facultative | Utilisez YYYY-MM-DD. Une date déjà passée est quand même importée, comme abonnement expiré. |
credits_remaining | Facultative | Un nombre entier. |
Colonnes du modèle cours
| Colonne | Obligatoire ? | Remarques |
|---|---|---|
class_name | Obligatoire | Associé par nom à un type de cours déjà existant dans Agon, ou un nouveau est créé si aucun ne correspond. |
starts_at | Obligatoire | Utilisez YYYY-MM-DD HH:MM:SS. Une heure de début déjà passée est ignorée. |
ends_at | Obligatoire | Utilisez YYYY-MM-DD HH:MM:SS. |
capacity | Facultative | Un nombre entier. Par défaut 1 si laissé vide. |
instructor_name | Facultative | Associé par nom à un instructeur déjà existant dans Agon. Sans correspondance, le cours est tout de même importé, signalé pour une affectation manuelle de l'instructeur. |
Consultez Correspondance des colonnes pour le comportement complet de chaque champ, y compris ce qui se passe avec un type d'abonnement ou un instructeur non associé.
Étape 2 — Exporter vos données depuis votre plateforme actuelle
La plupart des plateformes proposent un export en libre-service.
- Cherchez une option d'export ou de téléchargement dans la zone Paramètres, Admin ou Données de votre plateforme actuelle.
- Les données clients se trouvent généralement sous Clients, Membres ou Contacts.
- S'il n'existe pas d'export en libre-service, contactez l'équipe d'assistance de la plateforme et demandez un export de portabilité des données au titre de l'article 20 du RGPD. En vertu de l'article 20 du RGPD, toute plateforme détenant des données personnelles sur vos clients doit vous les fournir sur demande dans un format structuré et lisible par machine.
Consultez le guide RGPD pour savoir comment formuler cette demande et que faire si la plateforme ne coopère pas.
Étape 3 — Choisir ce que vous importez, importer le fichier et vérifier la correspondance des colonnes
- Ouvrez Paramètres → Migration.
- Sous Que voulez-vous importer ?, cliquez sur Clients, Abonnements ou Cours. Ce choix détermine quels champs Agon sont proposés dans l'étape d'association ci-dessous — choisissez l'entité qui correspond au fichier que vous allez importer.
- Sous Importer un fichier, choisissez votre fichier CSV, Excel ou JSON (jusqu'à 10 Mo).
- Cliquez sur Analyser le fichier.
- Agon affiche le tableau Vérifier la correspondance des colonnes. Il a associé pour vous chaque colonne de votre fichier à un champ Agon (« Nous avons associé chaque colonne de votre fichier à un champ Agon »).
- Vérifiez chaque ligne :
- Colonne de votre fichier — l'en-tête issu de votre fichier.
- Champ Agon — un menu déroulant. Les choix dépendent de l'entité choisie ci-dessus (Clients, Abonnements ou Cours) — consultez Correspondance des colonnes pour la liste complète des champs par entité — plus — ne pas importer —.
- Une colonne qu'Agon n'a pas pu associer affiche un badge non associée. Elle est ignorée sauf si vous choisissez un champ pour elle.
- Corrigez toute association erronée en choisissant le bon champ dans le menu déroulant. Réglez une colonne sur — ne pas importer — pour l'ignorer volontairement.
- Lorsque le tableau est correct, cliquez sur Confirmer l'import.
Il n'y a pas d'indice de confiance en couleur ni d'aperçu ligne par ligne : Agon lance l'import dès que vous confirmez.
Importez une entité à la fois. Pour importer clients, abonnements et cours, répétez cette étape entière trois fois — une fois par entité — en commençant par les Clients.
Pour plus de détails sur le fonctionnement de l'association et sur la façon de la corriger, consultez Correspondance des colonnes.
Étape 4 — Import terminé
Une fois l'import terminé, l'onglet affiche :
- N importés — enregistrements ajoutés à Agon.
- N ignorés — lignes qui n'ont pas été importées.
- Une liste Lignes ignorées avec un motif pour chaque ligne ignorée.
Les motifs dépendent de ce que vous avez importé :
Clients
- Row missing email — la ligne n'avait aucune valeur dans la colonne associée à E-mail ; elle n'a donc pas pu être importée.
- Duplicate email skipped — un client avec cette adresse e-mail existe déjà dans Agon. Le client existant n'est pas modifié.
Abonnements
- Row missing client email — aucune valeur dans la colonne associée à E-mail client.
- Client email not found — aucun client avec cet e-mail n'existe encore dans Agon. Importez d'abord vos clients, puis réimportez ce fichier.
- Row missing membership type name — aucune valeur dans la colonne associée à Type d'abonnement.
- Membership type not found — aucun type d'abonnement portant ce nom n'existe dans Agon. Créez le type d'abonnement dans Agon (Abonnements dans le menu latéral gauche), puis réimportez.
- Row has invalid or missing starts_at — la date de début est manquante ou dans un format qu'Agon ne peut pas lire.
Un abonnement dont la date d'expiration est passée n'est pas ignoré — il est importé avec le statut expiré, pour préserver votre historique.
Cours
- Row missing class name — aucune valeur dans la colonne associée à Nom du cours.
- Row has invalid or missing start/end time — l'une des deux heures est manquante ou dans un format de date/heure qu'Agon ne peut pas lire.
- Class start time is in the past — seuls les cours commençant dans le futur sont importés.
Un cours sans nom d'instructeur correspondant n'est pas ignoré — il est importé sans instructeur. La liste Lignes ignorées et les compteurs importés/ignorés ne le signalent pas ligne par ligne (c'est seulement enregistré dans les journaux du serveur, pas affiché dans cet onglet), donc après avoir importé des cours, vérifiez votre liste de cours pour ceux qui ont encore besoin d'un instructeur et affectez-en un depuis l'écran de modification du cours lui-même. Un nom de cours sans type de cours correspondant dans Agon n'est pas non plus ignoré — Agon crée automatiquement le type de cours, en utilisant l'heure de début/fin et la capacité de cette ligne comme valeurs par défaut.
Pour récupérer une ligne ignorée, corrigez-la dans votre fichier source et relancez l'import avec le fichier corrigé.
Étape 5 — Inviter les clients importés
Cette étape ne s'applique qu'après un import de Clients — les abonnements et les cours n'ont pas d'étape d'invitation. Les mots de passe des clients ne quittent jamais votre ancienne plateforme — ils y sont stockés sous forme de hachages irréversibles — les clients importés ont donc besoin d'une invitation pour définir leur propre mot de passe Agon.
Après l'import, deux actions sont disponibles :
- Envoyer les invitations par e-mail — envoie à chaque client importé lors de ce traitement un lien d'inscription personnel.
- Télécharger la liste des invitations (CSV) — un fichier contenant l'adresse e-mail et le lien d'invitation personnel de chaque client, pour que vous puissiez envoyer les invitations avec votre propre outil d'e-mailing.
Les liens d'invitation expirent 7 jours après leur création. Si un lien expire avant que le client ne l'utilise, relancez l'import pour ce client (ou utilisez une nouvelle liste d'invitations) pour en générer un nouveau.
Il n'y a pas d'écran d'historique des invitations ni de bouton de renvoi par client.
La section Inviter les clients importés s'affiche après chaque import terminé, y compris un import d'abonnements ou de cours. Y envoyer des invitations après un import d'abonnements ou de cours n'a aucun effet, puisqu'aucun nouveau client n'a été créé lors de ce traitement — les invitations ne sont envoyées qu'aux clients créés par un import Clients.
Reprendre une migration
L'onglet Migration retient où vous en étiez :
- Si vous avez analysé un fichier sans l'importer, réimportez le même fichier pour revenir au tableau Vérifier la correspondance des colonnes et terminer.
- Si un import est déjà terminé, l'onglet s'ouvre sur l'étape Import terminé afin que vous puissiez envoyer les invitations.
Que faire si quelque chose ne fonctionne pas ?
Mon ancienne plateforme refuse de me fournir un export de données En vertu de l'article 20 du RGPD (droit à la portabilité des données), toute plateforme détenant des données personnelles sur vos clients doit fournir ces données sur demande dans un format structuré et lisible par machine. Envoyez une demande écrite à leur équipe d'assistance. En cas de refus ou d'absence de réponse dans un délai de 30 jours, vous pouvez saisir votre autorité nationale de protection des données. Consultez le guide RGPD.
Les associations de colonnes sont fausses Corrigez-les dans le tableau Vérifier la correspondance des colonnes à l'aide du menu déroulant de la colonne Champ Agon. Vous pouvez aussi renommer les en-têtes de votre fichier pour qu'ils correspondent aux noms des champs d'Agon puis le réimporter. Consultez Correspondance des colonnes.
Certaines lignes ont été ignorées Ouvrez la liste Lignes ignorées et lisez le motif. Consultez Correspondance des colonnes pour savoir ce que chaque motif signifie et comment le corriger — les motifs diffèrent pour les clients, les abonnements et les cours. Corrigez le fichier source et réimportez-le.
Toutes (ou presque toutes) mes lignes d'abonnements ont été ignorées
La cause la plus fréquente est d'importer les abonnements avant les clients — une ligne d'abonnement est ignorée si l'e-mail de son client n'est pas déjà dans Agon. Importez d'abord votre fichier Clients, puis réimportez le fichier des abonnements. La deuxième cause la plus fréquente est un membership_type_name qui ne correspond à aucun type d'abonnement déjà configuré dans Agon (Abonnements dans le menu latéral gauche) — le nom doit correspondre exactement (la casse ne compte pas, l'orthographe si).
Un client n'a pas reçu son invitation, ou son lien a expiré Demandez au client de vérifier son dossier de courrier indésirable. Les liens d'invitation durent 7 jours ; pour en émettre un nouveau, relancez l'import pour ce client ou envoyez une nouvelle liste d'invitations. Il n'y a pas de bouton de renvoi. Cela ne s'applique qu'à un import de Clients — les abonnements et les cours n'envoient pas d'invitations.
Je ne vois pas l'onglet Migration Il n'est affiché qu'aux Managers. Demandez à un Manager de votre studio de lancer la migration, ou de changer votre rôle.
Un cours a été importé sans instructeur
Cela se produit lorsque l'instructor_name de votre fichier ne correspond pas exactement au nom d'un instructeur dans Agon. Le cours est quand même importé — ouvrez-le depuis la liste des cours et affectez l'instructeur manuellement.