Migrer vers Agon
Après avoir lu cette page, vous saurez transférer votre liste de clients existante 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 trois étapes :
- Télécharger un modèle (facultatif) — un fichier prêt à l'emploi avec les bons noms de colonnes.
- Importer un fichier — Agon le lit et associe vos colonnes à ses propres champs.
- Vérifier la correspondance des colonnes et importer — contrôlez les associations, corrigez celles qui sont fausses et confirmez.
Une fois l'import terminé, vous pouvez envoyer des e-mails d'invitation à toutes les personnes importées.
Ce que vous pouvez importer pour l'instant
Import des clients uniquement. L'onglet Migration indique : « Seul l'import des clients est disponible pour le moment. L'import des abonnements et des cours viendra plus tard. »
Vous pouvez tout de même télécharger dès aujourd'hui les modèles d'abonnements et de cours pour préparer ces fichiers à l'avance, mais l'application ne peut pas encore les importer.
Comme tout dans Agon dépend de l'existence préalable des clients, importer votre liste de clients est de toute façon la bonne première étape. Lorsque l'import des abonnements et des cours sera disponible, faites-les ensuite.
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). |
Pour référence, les autres modèles contiennent ces colonnes (import pas encore disponible) :
- Abonnements :
client_email,membership_type_name,starts_at,expires_at,credits_remaining - Cours :
class_name,starts_at,ends_at,capacity,instructor_name
É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 — Importer le fichier et vérifier la correspondance des colonnes
- Ouvrez Paramètres → Migration.
- 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 sont Nom complet, E-mail, Téléphone, Date de naissance et — 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.
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 — clients 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 deux motifs que vous verrez pour l'import des clients sont :
- 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é.
Pour récupérer une ligne ignorée, corrigez-la dans votre fichier source (ajoutez l'e-mail manquant ou supprimez le doublon) et relancez l'import avec le fichier corrigé.
Étape 5 — Inviter les clients importés
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.
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 en full_name, email, phone et date_of_birth puis le réimporter. Consultez Correspondance des colonnes.
Certaines lignes ont été ignorées Ouvrez la liste Lignes ignorées et lisez le motif. « Row missing email » signifie que la ligne n'avait pas d'e-mail ; « Duplicate email skipped » signifie que ce client existe déjà dans Agon. Corrigez le fichier source et réimportez-le.
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.
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.
Je dois importer des abonnements ou des cours Seul l'import des clients est disponible pour l'instant. Importez vos clients dès aujourd'hui ; les abonnements et les cours pourront être importés dans une version ultérieure.