Zum Hauptinhalt springen

Umzug zu Agon

Nach dem Lesen dieser Seite kannst du Kunden, Mitgliedschaften und Kurse aus einer Tabelle oder Exportdatei nach Agon übertragen, prüfen, wie jede Spalte zugeordnet wurde, den Import ausführen und die importierten Kunden einladen, ihre Konten einzurichten.

Die Werkzeuge befinden sich in der Desktop-App unter Einstellungen → Migration. Dieser Tab ist nur für Manager sichtbar. Es gibt keinen separaten Onboarding-Assistenten – alles passiert in diesem einen Tab.


So funktioniert die Migration​

Agon verbindet sich nicht mit deiner alten Plattform und fragt nicht nach deinen Anmeldedaten dafür. Du exportierst deine Daten selbst aus deiner aktuellen Plattform und lädst die Datei in Agon hoch. So bleiben deine Anmeldedaten sicher, und alles bleibt innerhalb dessen, was die meisten Plattformen erlauben.

In der App erfolgt die Migration in vier Schritten:

  1. Eine Vorlage herunterladen (optional) – eine fertige Datei mit den richtigen Spaltennamen.
  2. Auswählen, was du importierst – Kunden, Mitgliedschaften oder Kurse.
  3. Eine Datei hochladen – Agon liest sie und ordnet deine Spalten den Feldern des gewählten Typs zu.
  4. Die Spaltenzuordnung prüfen und importieren – kontrolliere die Zuordnungen, korrigiere falsche und bestätige.

Nach Abschluss eines Kundenimports kannst du Einladungs-E-Mails an alle importierten Personen senden.


Was du derzeit importieren kannst​

Du kannst Kunden, Mitgliedschaften und Kurse importieren. Jeder wird separat importiert – wähle einen unter Was importierst du?, lade eine Datei dafür hoch und wiederhole das für die anderen.

Einzelhandelsprodukte werden von der Migration nicht unterstützt und können nicht importiert werden.

Da Mitgliedschaften und Kurse beide davon abhängen, dass Kunden bereits in Agon existieren, importiere zuerst deine Kundenliste:

  1. Kunden – mach das immer zuerst. Ohne das kann nichts anderes zugeordnet werden.
  2. Mitgliedschaften – erfordert, dass die E-Mail des Kunden schon in Agon vorhanden ist und der Name des Mitgliedschaftstyps schon als Mitgliedschaftstyp in Agon existiert.
  3. Kurse – unabhängig von Kunden, aber mach das zuletzt, da Kurslisten/Buchungen weiterhin separat aus deiner alten Plattform kommen.

Unterstützte Dateien​

Der Upload-Schritt akzeptiert:

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

Die maximale Dateigröße beträgt 10 MB. Wenn dein Export größer ist, teile ihn in mehrere Dateien auf und importiere sie einzeln.


Schritt 1 — Eine Vorlage herunterladen (optional)​

Wenn du deine Datei lieber von Hand erstellst oder der Export deiner Plattform sehr abweichende Spaltennamen verwendet, gehe von einer Agon-Vorlage aus.

  1. Öffne Einstellungen → Migration.
  2. Klicke im Bereich Vorlagen herunterladen auf eine dieser Optionen:
    • Vorlage für Kunden herunterladen
    • Vorlage für Mitgliedschaften herunterladen
    • Vorlage für Kurse herunterladen
  3. Öffne die heruntergeladene CSV in Excel oder Google Sheets, trage deine Zeilen ein und speichere sie als CSV.

Du musst keine Vorlage verwenden. Jede CSV-, Excel- oder JSON-Datei funktioniert – im Zuordnungsschritt in Schritt 3 kannst du deine Spalten an den Feldern von Agon ausrichten.

Spalten der Kundenvorlage​

SpalteErforderlich?Hinweise
full_nameEmpfohlenWenn eine Zeile keinen Namen hat, wird die E-Mail des Kunden als Name verwendet.
emailErforderlichEine Zeile ohne E-Mail wird übersprungen.
phoneOptional
date_of_birthOptionalVerwende YYYY-MM-DD (zum Beispiel 1990-01-15).
notesOptionalFreitextnotizen zum Kunden.
billing_nameOptionalWird künftig auf den Rechnungen dieses Kunden verwendet, falls abweichend vom vollständigen Namen (zum Beispiel ein Firmenname). Kein historischer Datensatz – Agon importiert keine Rechnungen aus deiner alten Plattform.
billing_addressOptionalWird künftig auf den Rechnungen dieses Kunden verwendet.
tax_idOptionalDie Steuernummer bzw. USt-IdNr. des Kunden, verwendet auf seinen künftigen Rechnungen.

Spalten der Mitgliedschaftsvorlage​

SpalteErforderlich?Hinweise
client_emailErforderlichMuss bereits zu einem Kunden in Agon gehören – importiere zuerst deine Kunden.
membership_type_nameErforderlichWird über den Namen einem bereits existierenden Mitgliedschaftstyp in Agon zugeordnet.
starts_atErforderlichVerwende YYYY-MM-DD.
expires_atOptionalVerwende YYYY-MM-DD. Ein Datum in der Vergangenheit wird trotzdem importiert, als abgelaufene Mitgliedschaft.
credits_remainingOptionalEine ganze Zahl.

Spalten der Kursvorlage​

SpalteErforderlich?Hinweise
class_nameErforderlichWird über den Namen einem bereits existierenden Kurstyp in Agon zugeordnet, oder es wird ein neuer erstellt, wenn keiner passt.
starts_atErforderlichVerwende YYYY-MM-DD HH:MM:SS. Eine Startzeit in der Vergangenheit wird übersprungen.
ends_atErforderlichVerwende YYYY-MM-DD HH:MM:SS.
capacityOptionalEine ganze Zahl. Standardmäßig 1, wenn leer gelassen.
instructor_nameOptionalWird über den Namen einem bereits existierenden Kursleiter in Agon zugeordnet. Ohne Übereinstimmung wird der Kurs trotzdem importiert, markiert zur manuellen Zuweisung eines Kursleiters.

Siehe Spaltenzuordnung für das vollständige Verhalten jedes Felds, einschließlich dem, was bei einem nicht zugeordneten Mitgliedschaftstyp oder Kursleiter passiert.


Schritt 2 — Deine Daten aus deiner aktuellen Plattform exportieren​

Die meisten Plattformen bieten einen Self-Service-Export.

  • Suche im Bereich Einstellungen, Admin oder Daten deiner aktuellen Plattform nach einer Export- oder Download-Option.
  • Kundendaten stehen meist unter Kunden, Mitglieder oder Kontakte.
  • Wenn es keinen Self-Service-Export gibt, wende dich an das Support-Team der Plattform und fordere einen Export zur Datenübertragbarkeit nach Art. 20 DSGVO an. Nach Art. 20 DSGVO muss jede Plattform, die personenbezogene Daten über deine Kunden hält, sie dir auf Anfrage in einem strukturierten, maschinenlesbaren Format bereitstellen.

Im DSGVO-Leitfaden erfährst du, wie du diese Anfrage formulierst und was zu tun ist, wenn die Plattform nicht kooperiert.


Schritt 3 — Auswählen, was du importierst, die Datei hochladen und die Spaltenzuordnung prüfen​

  1. Öffne Einstellungen → Migration.
  2. Klicke unter Was importierst du? auf Kunden, Mitgliedschaften oder Kurse. Diese Auswahl entscheidet, welche Agon-Felder im Zuordnungsschritt unten angeboten werden – wähle die Entität, die zur Datei passt, die du gleich hochlädst.
  3. Wähle unter Datei hochladen deine CSV-, Excel- oder JSON-Datei (bis zu 10 MB).
  4. Klicke auf Datei analysieren.
  5. Agon zeigt die Tabelle Spaltenzuordnung prüfen an. Es hat jede Spalte deiner Datei bereits für dich einem Agon-Feld zugeordnet („Wir haben jede Spalte deiner Datei einem Agon-Feld zugeordnet").
  6. Prüfe jede Zeile:
    • Spalte in deiner Datei – die Überschrift aus deiner Datei.
    • Agon-Feld – ein Dropdown. Die Auswahl hängt von der oben gewählten Entität ab (Kunden, Mitgliedschaften oder Kurse) – siehe Spaltenzuordnung für die vollständige Feldliste je Entität – plus — nicht importieren —.
    • Eine Spalte, die Agon nicht zuordnen konnte, zeigt ein Badge nicht zugeordnet. Sie wird übersprungen, sofern du kein Feld für sie auswählst.
  7. Korrigiere jede falsche Zuordnung, indem du das richtige Feld aus dem Dropdown wählst. Stelle eine Spalte auf — nicht importieren —, um sie bewusst zu überspringen.
  8. Wenn die Tabelle stimmt, klicke auf Import bestätigen.

Es gibt keine farbcodierte Sicherheitsbewertung und keine zeilenweise Vorschau – Agon führt den Import aus, sobald du bestätigst.

Importiere eine Entität nach der anderen. Um Kunden, Mitgliedschaften und Kurse zu importieren, wiederhole diesen gesamten Schritt dreimal – einmal je Entität – beginnend mit Kunden.

Mehr Details dazu, wie die Zuordnung funktioniert und wie du sie korrigierst, findest du unter Spaltenzuordnung.


Schritt 4 — Import abgeschlossen​

Nach Abschluss des Imports zeigt der Tab:

  • N importiert – zu Agon hinzugefügte Datensätze.
  • N übersprungen – Zeilen, die nicht importiert wurden.
  • Eine Liste Übersprungene Zeilen mit einem Grund für jede übersprungene Zeile.

Die Gründe hängen davon ab, was du importiert hast:

Kunden

  • Row missing email – die Zeile hatte keinen Wert in der Spalte, die E-Mail zugeordnet ist, sodass sie nicht importiert werden konnte.
  • Duplicate email skipped – in Agon existiert bereits ein Kunde mit dieser E-Mail-Adresse. Der vorhandene Kunde bleibt unberührt.

Mitgliedschaften

  • Row missing client email – kein Wert in der Spalte, die Kunden-E-Mail zugeordnet ist.
  • Client email not found – es existiert noch kein Kunde mit dieser E-Mail in Agon. Importiere zuerst deine Kunden und dann diese Datei erneut.
  • Row missing membership type name – kein Wert in der Spalte, die Mitgliedschaftstyp zugeordnet ist.
  • Membership type not found – in Agon existiert kein Mitgliedschaftstyp mit diesem Namen. Erstelle den Mitgliedschaftstyp in Agon (Mitgliedschaften in der linken Seitenleiste) und importiere dann erneut.
  • Row has invalid or missing starts_at – das Startdatum fehlt oder liegt in einem Format vor, das Agon nicht lesen kann.

Eine Mitgliedschaft, deren Ablaufdatum in der Vergangenheit liegt, wird nicht übersprungen – sie wird mit dem Status abgelaufen importiert, sodass dein historischer Datensatz erhalten bleibt.

Kurse

  • Row missing class name – kein Wert in der Spalte, die Kursname zugeordnet ist.
  • Row has invalid or missing start/end time – eine der beiden Zeiten fehlt oder liegt in einem Datums-/Zeitformat vor, das Agon nicht lesen kann.
  • Class start time is in the past – es werden nur Kurse importiert, die in der Zukunft beginnen.

Ein Kurs ohne passenden Kursleiternamen wird nicht übersprungen – er wird ohne Kursleiter importiert. Die Liste Übersprungene Zeilen und die Zähler für importiert/übersprungen weisen nicht zeilenweise darauf hin (das wird nur in den Server-Logs vermerkt, nicht in diesem Tab angezeigt). Prüfe daher nach dem Import von Kursen deine Kursliste auf solche, die noch einen Kursleiter brauchen, und weise einen über den eigenen Bearbeitungsbildschirm des Kurses zu. Ein Kursname ohne passenden Kurstyp in Agon wird ebenfalls nicht übersprungen – Agon erstellt den Kurstyp automatisch und verwendet dafür die Start-/Endzeit und die Kapazität dieser Zeile als Standardwerte.

Um eine übersprungene Zeile aufzunehmen, korrigiere sie in deiner Quelldatei und führe den Import mit der korrigierten Datei erneut aus.


Schritt 5 — Die importierten Kunden einladen​

Dieser Schritt gilt nur nach einem Import von Kunden – Mitgliedschaften und Kurse haben keinen Einladungsschritt. Kundenpasswörter verlassen deine alte Plattform nie – sie werden dort als nicht umkehrbare Hashes gespeichert – daher brauchen importierte Kunden eine Einladung, um ihr eigenes Agon-Passwort zu setzen.

Nach dem Import sind zwei Aktionen verfügbar:

  • Einladungs-E-Mails senden – sendet jedem in diesem Vorgang importierten Kunden einen persönlichen Anmeldelink.
  • Einladungsliste herunterladen (CSV) – eine Datei mit der E-Mail-Adresse und dem persönlichen Einladungslink jedes Kunden, damit du die Einladungen mit deinem eigenen E-Mail-Tool versenden kannst.

Einladungslinks laufen 7 Tage nach ihrer Erstellung ab. Wenn ein Link abläuft, bevor der Kunde ihn nutzt, führe den Import für diesen Kunden erneut aus (oder verwende eine neue Einladungsliste), um einen neuen zu erzeugen.

Es gibt keinen Bildschirm mit Einladungsverlauf und keine Schaltfläche zum erneuten Senden pro Kunde.

Der Bereich Importierte Kunden einladen wird nach jedem abgeschlossenen Import angezeigt, auch nach einem Import von Mitgliedschaften oder Kursen. Dort Einladungen zu senden hat in diesem Fall keine Wirkung, da bei diesem Vorgang keine neuen Kunden angelegt wurden – Einladungen gehen immer nur an Kunden, die durch einen Kunden-Import angelegt wurden.


Eine Migration fortsetzen​

Der Tab Migration merkt sich, wo du warst:

  • Wenn du eine Datei analysiert, aber nicht importiert hast, lade dieselbe Datei erneut hoch, um zur Tabelle Spaltenzuordnung prüfen zurückzukehren und abzuschließen.
  • Wenn ein Import bereits abgeschlossen wurde, öffnet der Tab auf dem Schritt Import abgeschlossen, damit du Einladungen senden kannst.

Was tun, wenn etwas schiefgeht?​

Meine alte Plattform gibt mir keinen Datenexport Nach Art. 20 DSGVO (Recht auf Datenübertragbarkeit) muss jede Plattform, die personenbezogene Daten über deine Kunden speichert, diese Daten auf Anfrage in einem strukturierten, maschinenlesbaren Format bereitstellen. Sende eine schriftliche Anfrage an ihr Support-Team. Wenn sie sich weigern oder nicht innerhalb von 30 Tagen antworten, kannst du dich an deine nationale Datenschutzbehörde wenden. Siehe den DSGVO-Leitfaden.

Die Spaltenzuordnungen sind falsch Korrigiere sie in der Tabelle Spaltenzuordnung prüfen über das Dropdown in der Spalte Agon-Feld. Du kannst auch die Überschriften in deiner Datei so umbenennen, dass sie den Feldnamen von Agon entsprechen, und sie erneut hochladen. Siehe Spaltenzuordnung.

Einige Zeilen wurden übersprungen Öffne die Liste Übersprungene Zeilen und lies den Grund. Siehe Spaltenzuordnung für die Bedeutung jedes Grundes und wie du ihn behebst – die Gründe unterscheiden sich für Kunden, Mitgliedschaften und Kurse. Korrigiere die Quelldatei und importiere sie erneut.

Alle (oder fast alle) meiner Mitgliedschaftszeilen wurden übersprungen Die häufigste Ursache ist, Mitgliedschaften vor Kunden zu importieren – eine Mitgliedschaftszeile wird übersprungen, wenn die E-Mail ihres Kunden noch nicht in Agon ist. Importiere zuerst deine Kunden-Datei, dann die Mitgliedschaftsdatei erneut. Die zweithäufigste Ursache ist ein membership_type_name, der zu keinem bereits in Agon eingerichteten Mitgliedschaftstyp passt (Mitgliedschaften in der linken Seitenleiste) – der Name muss exakt übereinstimmen (Groß-/Kleinschreibung spielt keine Rolle, die Schreibweise aber schon).

Ein Kunde hat seine Einladung nicht erhalten oder sein Link ist abgelaufen Bitte den Kunden, seinen Spam-Ordner zu prüfen. Einladungslinks gelten 7 Tage; um einen neuen auszustellen, führe den Import für diesen Kunden erneut aus oder sende eine neue Einladungsliste. Es gibt keine Schaltfläche zum erneuten Senden. Das gilt nur für einen Kunden-Import – Mitgliedschaften und Kurse senden keine Einladungen.

Ich sehe den Tab Migration nicht Er wird nur Managern angezeigt. Bitte einen Manager in deinem Studio, die Migration durchzuführen oder deine Rolle zu ändern.

Ein Kurs wurde ohne Kursleiter importiert Das passiert, wenn der instructor_name in deiner Datei nicht exakt dem Namen eines Kursleiters in Agon entspricht. Der Kurs wird trotzdem importiert – öffne ihn aus der Kursliste und weise den Kursleiter manuell zu.

Verwandte Seiten​