# Mitglieder per Tabelle importieren

> Wie du eine Personenliste aus jeder .xlsx- oder .csv-Tabelle in die Community holst - Herkunft, Datei, Spalten, Gruppen und Tags, Einwilligung, Zusammenfassung und Bericht -, was jede Person per E-Mail erhält und wie sie die Einladung ablehnt.

Der Tab **Tabelle importieren** im Fenster **Mitglieder einladen** holt die Personen aus einer Tabelle in die Community: die Angemeldeten eines Events, den Mitgliederstamm eines Verbands, die Teilnehmenden eines Kurses. Jede Tabelle passt: Du legst fest, wohin jede Spalte geht, wählst Rolle, Gruppen und Tags für alle, prüfst eine Zusammenfassung und importierst erst dann. Jede neue Person erhält eine Einladung per E-Mail.

> [!WARNING]
> Importiere nur Personen, die **zugestimmt** haben, E-Mails zu erhalten und an der Community teilzunehmen. Gekaufte Listen, Gewinnspiele und von Bots gesammelte Daten sind verboten. Lies vor dem Import die [Richtlinie für Einladungen und Mitgliederimport](/membros/politica-de-convites).

## Wofür das gut ist

| Community | Tabelle |
|---|---|
| Event | Die Angemeldeten, die *„Ich möchte an der Community teilnehmen“* angekreuzt haben, mit der Spalte für die Ticketart als Tag |
| Verband | Der Mitgliederstamm, mit Firma und Position als benutzerdefinierte Felder |
| Schule | Die Eingeschriebenen des Semesters, alle in der Gruppe der Klasse |
| Coworking | Die Residents, mit der Spalte *Etage* unter Gruppen |

## So funktioniert es

### Wer importieren darf

**Eigentümer** und **Administrator**. Der Import vergibt nur die Rolle **Mitglied** oder **Moderator**: Wer als Administrator oder Finanzen beitreten soll, wird über den Tab **E-Mails eingeben** eingeladen. Siehe [Mitglieder einladen](/membros/convidar-membros).

### Die Datei

- **.xlsx** oder **.csv**. Das alte `.xls` und `.xlsm` (mit Makros) werden abgelehnt, auch umbenannt.
- Bis **5 MB**, **5.000 Datenzeilen** und **100 Spalten**.
- Formeln zählen mit ihrem berechneten Wert; verbundene Zellen mit dem Wert der ersten.
- Bei CSV erkennt Memberfy die **Kodierung** selbst (Umlaute richtig, auch bei Dateien aus älteren Excel-Versionen) und das **Trennzeichen** (Komma, Semikolon, Tabulator oder senkrechter Strich). Beides lässt sich ändern.

### Was mit jeder Zeile passiert

| Fall | Was passiert |
|---|---|
| E-Mail ohne Memberfy-Konto | Bekommt das Konto und tritt der Community bei, mit Rolle, Gruppen (auch der [Standardgruppe](/membros/grupos-e-organograma)), Tags und Feldern. Erhält die Einladung mit **Mein Passwort festlegen** |
| Hat ein Konto, ist aber nicht in dieser Community | Tritt der Community bei. Name und Telefon des Kontos ändern sich nicht (sie gelten in anderen Communities). Erhält die Einladung mit **Anmelden** |
| **Ist bereits Mitglied** | Rolle und Name ändern sich nicht. **Bekommt** die Gruppen und Tags dazu (nichts wird entfernt) und füllt nur **leere** benutzerdefinierte Felder. Erhält keine E-Mail. Zählt als *aktualisiert* |
| E-Mail doppelt in der Tabelle | Die erste Zeile gilt; die anderen werden als *doppelt in der Tabelle* übersprungen |
| Ohne E-Mail oder mit ungültiger E-Mail | Wird mit Grund übersprungen, ohne den Rest aufzuhalten |
| Ohne Einwilligung | Wird übersprungen (wenn es eine Einwilligungsspalte gibt) |
| Hat gebeten, an dieser Community nicht teilzunehmen | Wird übersprungen; es geht keine E-Mail raus |
| Wert, der nicht zum Feld passt | Nur dieses Feld bleibt leer; die Person wird importiert, und der Bericht weist darauf hin |

### Die Einladung per E-Mail

Jede **neue** Person in der Community erhält eine E-Mail im Namen der Community, mit der **Herkunft der Liste** (*„Du erhältst diese Einladung, weil deine Daten hier enthalten sind: Teilnehmende von Event X 2026“*) und in der Fußzeile dem Link **Danke für die Einladung, aber ich möchte nicht teilnehmen**. Wer kein Konto hat, erhält **Mein Passwort festlegen** (der Link gilt 7 Tage und nur einmal); wer eines hat, **Anmelden**. Wer schon Mitglied war, erhält nichts.

Die E-Mails des Imports **zählen nicht** zum [Versandkontingent der Kampagnen](/notificacoes/campanhas-de-email#versandkontingent).

### Im Hintergrund

Mit einem Klick auf **Importieren** kommt der Import in eine Warteschlange und läuft von selbst: Du kannst das Fenster schließen. Die Einladungen gehen im Tempo der Kampagnen raus, etwa **5 pro Sekunde**; eine Liste mit 3.000 Personen braucht also rund 10 Minuten, bis alles zugestellt ist. Am Ende erhält, wer importiert hat, einen Hinweis in der App und eine E-Mail mit der Zusammenfassung.

Die Community liest **eine Tabelle auf einmal**. Importiert gerade eine andere Person aus dem Team, sagt die Ansicht *„Gerade wird eine andere Tabelle gelesen. Versuche es gleich noch einmal.“*

### Was gespeichert wird

Der Import hält fest, wer importiert hat, wann, den Dateinamen, die Herkunft und die verwendete Einwilligung (die Spalte und die Werte oder die Erklärung). Eine **Kopie der Originaldatei** wird an einem privaten Ort gespeichert, ohne Löschfrist: Eigentümer und Administrator laden sie über den Verlauf herunter (**Frühere Importe › Ansehen › Originaldatei herunterladen**). Im Datensatz der importierten Person liest das Team *„Herkunft: Tabellenimport am …“*.

## Schritt für Schritt

*Rolle: Eigentümer oder Administrator.*

1. **Verwaltung › Mitglieder**, Schaltfläche **Mitglieder einladen**, Tab **Tabelle importieren**.
2. Wähle oben im Fenster die **Rolle** (Mitglied oder Moderator), die **Gruppen** und die **Tags** für alle. Neue Gruppen und Tags legst du direkt dort an, indem du den Namen tippst. Diese drei Felder sind dieselben wie im Tab **E-Mails eingeben**: Was du in einem wählst, gilt im anderen.
3. **1. Herkunft.** Schreibe die **Herkunft der Liste** (Pflichtfeld, bis 150 Zeichen, ohne Links), zum Beispiel *Teilnehmende von Event X 2026*. Sie steht in der E-Mail jeder eingeladenen Person. Wähle die Datei (hineinziehen oder klicken) und klicke auf **Weiter**.
4. **2. Datei.** Prüfe, wie gelesen wurde: das **Blatt** (bei einer .xlsx mit mehreren), die **Kopfzeile** (*„Kopfzeile in Zeile 8.“*, wenn die Tabelle oben einen Titel hat) und bei CSV das **Trennzeichen** und die **Kodierung**. Jede Änderung liest die Datei neu.
5. **3. Spalten.** Jede Spalte erscheint mit den ersten 3 Zeilen und der Auswahl **Ziel**. Die **automatisch erkannten** (E-Mail, Vorname, Nachname, Telefon, vorhandene Felder) stehen oben; die anderen stehen auf **Ignorieren**, eingeklappt unter *„28 ignorierte Spalten — anzeigen“*. Die Ziele:

   | Ziel | Regel |
   |---|---|
   | **E-Mail** | Pflicht, nur eine Spalte. Ohne sie: *„Wählen Sie die E-Mail-Spalte, um fortzufahren.“* |
   | **Vorname** und **Nachname** | Zusammen ergeben sie den vollständigen Namen. Eine Spalte mit dem vollständigen Namen geht auch |
   | **Telefon** | Ins internationale Format gebracht, mit dem Land der Community als Standard; Unleserliches bleibt leer |
   | **Tags** | Jeder Wert wird ein Tag (mehrere mit `,` `;` oder `\|` trennen). Z. B. *Ticketart* |
   | **Gruppen** | Jeder Wert ordnet die Person der gleichnamigen Gruppe zu; fehlende Gruppen **werden neu angelegt** |
   | **Einwilligung** | Die Spalte, die sagt, wer zugestimmt hat. Markiere, welche Werte **als Ja gelten** (*Ja*, *x*, *akzeptiert*…) |
   | **Feld: …** | Ein vorhandenes [benutzerdefiniertes Feld](/membros/campos-customizados) |
   | **+ Neues benutzerdefiniertes Feld** | Legt das Feld mit dem Namen der Spalte (änderbar) und dem aus dem Inhalt vorgeschlagenen Typ an. Es entsteht als **optional** |
   | **Ignorieren** | Die Spalte wird nicht importiert |

   Einwilligung, Tags und Gruppen werden nie vorgeschlagen: Du wählst sie. Spalten mit demselben Namen erscheinen getrennt (*Telefon (Sp. 24)*, *Telefon (Sp. 30)*), und nur eine kann zu jeder Angabe der Person gehen.
6. **Einwilligung.** Mit einer Einwilligungsspalte werden nur die Zeilen mit den markierten Werten importiert. Ohne sie setze das Häkchen bei der Erklärung *„Ich erkläre, dass alle Personen auf dieser Liste zugestimmt haben, E-Mails zu erhalten und an dieser Community teilzunehmen.“* Ohne eines von beiden lässt sich nicht importieren.
7. **4. Zusammenfassung.** Prüfe vor dem Speichern: **Zeilen in der Tabelle**, **Neue Personen**, **Bereits Mitglieder**, **Werden übersprungen** (mit Grund), **Übersprungen, weil sie nicht teilnehmen möchten**, **Einladungs-E-Mails, die gesendet werden** und die Gruppen, Tags und Felder, die **erstellt werden**, mit Namen. Der Klick auf **Importieren** bestätigt all das; eine weitere Rückfrage gibt es nicht.
8. **5. Ergebnis.** Der Fortschritt erscheint im Fenster. Am Ende: **Importiert**, **Aktualisiert**, **Übersprungen** und **Einladungen gesendet**, die Liste der **Übersprungenen Zeilen** mit Grund, die **Mit Hinweis importierten Zeilen** und die Schaltfläche **Fehler-CSV herunterladen** (die Originalzeilen mit der Spalte für den Grund, zum Korrigieren und erneuten Importieren).

**Frühere Importe**, im selben Tab, zeigt den Verlauf: jeden Import mit Datum, Zählungen, Status und der Originaldatei.

## Die Einladung ablehnen

Wer importiert wurde und nicht teilnehmen möchte, hat zwei Wege:

- **Über die E-Mail:** Der Link **Danke für die Einladung, aber ich möchte nicht teilnehmen** öffnet eine Seite der Community, ohne Login, mit **Bestätigen: Ich möchte nicht teilnehmen**.
- **In der Community:** Unter **Mein Konto** steht derselbe Satz dezent, mit der Erklärung *„Sie wurden dieser Community durch einen Listenimport hinzugefügt.“*

Nach der Bestätigung verlässt die Person die Community und kommt auf die **Ablehnungsliste**: Die Community kann sie nicht mehr importieren oder einladen. Ihr Memberfy-Konto bleibt bestehen. Sie kommt nur zurück, wenn sie selbst beitritt, über die offene Registrierung.

- Der Link in der E-Mail gilt **30 Tage** und verfällt, sobald die Person **die Einladung annimmt** (das Passwort festlegt und sich anmeldet) oder **ihre Rolle wechselt**. Danach wendet sie sich zum Verlassen an die Verantwortlichen der Community.
- Die Ablehnung **gilt nicht für das Team** (Moderator, Administrator, Finanzen) und nicht für Personen mit aktivem oder ausstehendem **Abonnement** in der Community: Die Person kündigt das Abonnement vorher.
- Die Ablehnungsliste gilt auch für die **Einladung per E-Mail** und für **Neues Mitglied**: Wer abgelehnt hat, erscheint als *„Hat gebeten, an dieser Community nicht teilzunehmen“*, und es geht keine E-Mail raus.

Eine einzelne Ablehnung ist kein Verstoß; viele Ablehnungen bei derselben Liste führen dazu, dass Memberfy die Community prüft. Siehe die [Richtlinie für Einladungen](/membros/politica-de-convites#wie-eingeladene-ablehnen-oder-melden).

## Beispiele

**Ein Event mit 220 Angemeldeten.** Die Tabelle hat oben einen Titel und die Kopfzeile in Zeile 8. Die Organisation prüft die Kopfzeile, schickt die Spalte *Neuigkeiten erwünscht* an **Einwilligung** mit *Ja* als Ja-Wert, *Ticketart* an **Tags** und *Firma* an **+ Neues benutzerdefiniertes Feld**. Die Zusammenfassung zeigt 97 neue Personen, 109 ohne Einwilligung, 12 doppelte und 2 ohne E-Mail. Sie importiert; 97 Einladungen gehen raus.

**Ein Verband holt seinen Stamm erneut.** Die Hälfte ist schon Mitglied. Diese Hälfte bekommt die Gruppe *Mitglieder 2026* und füllt die leere *Firma*, ohne E-Mail; nur die Neuen werden eingeladen.

## Häufige Fehler und Lösungen

| Meldung | Was zu tun ist |
|---|---|
| *Laden Sie eine .xlsx- oder .csv-Datei hoch.* | Speichere die Tabelle als .xlsx oder .csv |
| *Die Datei ist größer als 5 MB.* / zu viele Datenzeilen | Teile sie auf und importiere einen Teil nach dem anderen |
| *Keine eindeutige Kopfzeile gefunden, daher wurde Zeile 1 verwendet…* | Wähle im Schritt Datei die richtige **Kopfzeile** |
| Vertauschte Umlaute (*Müller*) | Ändere im Schritt Datei die **Kodierung** |
| *Wählen Sie die E-Mail-Spalte, um fortzufahren.* | Schicke eine Spalte an **E-Mail** |
| *Nur eine Spalte kann zu Telefon gehen.* | Lass die andere auf **Ignorieren** oder schicke sie an ein benutzerdefiniertes Feld |
| *Markieren Sie, welche Werte der Einwilligungsspalte als Ja gelten.* | Markiere die Werte unter **Gelten als Ja** |
| *Geben Sie die Herkunft der Liste an.* | Fülle die Herkunft in Schritt 1 aus |
| *Bestätigen Sie die Einwilligungserklärung, um zu importieren.* | Ohne Einwilligungsspalte ist die Erklärung Pflicht |
| *Gerade wird eine andere Tabelle gelesen. Versuche es gleich noch einmal.* | Warte ein paar Sekunden und klicke erneut |
| *Der Tabellenimport akzeptiert nur Mitglied oder Moderator.* | Für andere Rollen nutze **E-Mails eingeben** |
| *Durch die Sperre der Community unterbrochen* | Memberfy hat den Beitritt von Mitgliedern gesperrt; was schon verarbeitet war, bleibt. Siehe [Sperre für Beitritte und Verkäufe](/membros/politica-de-convites#sperre-fur-beitritte-und-verkaufe) |

## Häufige Fragen

**Kann ich importieren, ohne E-Mails zu schicken?**
Nein. Jede neue Person erhält die Einladung, mit Herkunft und Ablehnungslink: So erfährt sie, woher ihre Daten stammen, und kann Nein sagen.

**Lässt sich ein Import rückgängig machen?**
Es gibt keine Schaltfläche zum Rückgängigmachen. Um jemanden zu entfernen, nutze [Mitglieder verwalten](/membros/gerenciar-membros).

**Kann ich jemanden importieren, der abgelehnt hat?**
Nein. Wer abgelehnt hat, kommt nur zurück, wenn er selbst beitritt.

**Die Gruppenspalte schreibt den Namen anders als die Gruppe.**
Der Vergleich ignoriert Groß- und Kleinschreibung und Akzente (*engenharia* findet *Engenharia*). Ein Name, der zu keiner Gruppe passt, legt eine neue Gruppe an, und die Zusammenfassung zeigt vor dem Import, welche.

**Kann ich über Claude oder ChatGPT importieren?**
Ja: Hänge die Tabelle im Gespräch an und bitte darum. Siehe das Rezept [Eine Tabelle über den Assistenten importieren](/mcp/receitas#61-eine-tabelle-uber-den-assistenten-importieren).

## In der API

`POST /api/members/imports` (die Datei, als `multipart`), `POST /api/members/imports/{id}/preview`, `POST /api/members/imports/{id}/start`, `GET /api/members/imports`, `GET /api/members/imports/{id}`, `GET /api/members/imports/{id}/errors.csv` und `GET /api/members/imports/{id}/file`. Die Ablehnung ist `POST /api/invite-opt-out/{token}` (über den Link) und `POST /api/profiles/me/decline` (angemeldet). Siehe [Member Imports](/api/referencia/member-imports) in der API-Referenz.

## Verwandte Artikel

- [Richtlinie für Einladungen und Mitgliederimport](/membros/politica-de-convites)
- [Mitglieder einladen](/membros/convidar-membros)
- [Benutzerdefinierte Felder](/membros/campos-customizados)
- [Gruppen und Organigramm](/membros/grupos-e-organograma)
- [Tags](/membros/tags)