> ## Documentation Index > Fetch the complete documentation index at: https://docs.get-clara.tech/llms.txt > Use this file to discover all available pages before exploring further. # Kontakte über CSV importieren > Vollständige Schritt-für-Schritt-Anleitung zum Importieren von Personen/Kontakten in Twenty. ## Übersicht Diese Anleitung führt Sie durch den Import Ihrer Kontakte (Personen) in Twenty. **Importieren Sie zuerst Unternehmen**, wenn Sie Personen mit Unternehmen verknüpfen möchten. ## Bevor Sie beginnen ### Checkliste der Voraussetzungen Ihre Datei ist im CSV-, XLSX- oder XLS-Format Die Datei enthält weniger als 10.000 Datensätze Keine doppelten E-Mail-Adressen in Ihrer Datei **Unternehmen zuerst importiert** (wenn Personen mit Unternehmen verknüpft werden) Alle benutzerdefinierten Felder existieren in **Einstellungen → Datenmodell** **Unternehmen vor Personen importieren** Wenn Sie Personen mit Unternehmen verknüpfen möchten, importieren Sie zuerst Unternehmen. Das Unternehmen muss existieren, bevor Sie darauf verweisen können. ## Schritt 1: Bereiten Sie Ihre Kontaktdaten vor ### Erforderliche und empfohlene Felder | Feld | Erforderlich? | Format | Notizen | | ----------------------------- | ------------- | ----------------- | ------------------------------------- | | **E-Mail** | Empfohlen | `name@domain.com` | Muss eindeutig sein | | **Vorname** | Empfohlen | Text | | | **Nachname** | Empfohlen | Text | | | **Unternehmen** | Optional | Domain oder ID | Verknüpft mit vorhandenem Unternehmen | | **Telefon** | Optional | Mehrere Spalten | Siehe unten | | **Berufsbezeichnung** | Optional | Text | | | **Benutzerdefinierte Felder** | Optional | Variiert | Muss im Datenmodell existieren | ### E-Mail-Format * Muss ein gültiges E-Mail-Format haben: `name@domain.com` * **Muss eindeutig sein** — keine Duplikate in Ihrer Datei oder in Twenty * Für zusätzliche E-Mails verwenden Sie die Spalte **Emails / Additional Emails**: ``` ["jane@twenty.com","jane.doe@twenty.com"] ``` ### Telefonformat Telefon ist ein **verschachteltes Feld**, das mehrere Spalten erfordert: | Spalte | Beispiel | | --------------------------------------- | ------------ | | **Phones / Primary Phone Number** | `4159095555` | | **Phones / Primary Phone Country Code** | `US` | | **Phones / Primary Phone Calling Code** | `+1` | ### Verknüpfung mit Unternehmen Fügen Sie eine Spalte mit dem eindeutigen Bezeichner des Unternehmens hinzu: | Spaltenname | Format | Beispiel | | --------------- | ---------- | -------------------------------------- | | `companyDomain` | URL-Format | `https://acme.com` | | `companyId` | UUID | `c776ee49-f608-4a77-8cc8-6fe96ae1e43f` | **Domain-URL-Format verwenden** (`https://acme.com`), nicht die Bezeichnung. Dies entspricht der Art, wie Unternehmen in Twenty gespeichert werden. ### Beispielhafte CSV-Struktur ```csv theme={null} firstName,lastName,email,jobTitle,companyDomain,Phones / Primary Phone Number,Phones / Primary Phone Country Code John,Smith,john@acme.com,CEO,https://acme.com,4159095555,US Jane,Doe,jane@widgets.co,CTO,https://widgets.co,2125551234,US ``` **Profi-Tipp:** Klicken Sie während des Imports auf **Beispieldatei herunterladen** oder exportieren Sie einige vorhandene Personen, um die genauen Spaltennamen zu sehen, die Twenty erwartet. ## Schritt 2: Zugriff auf die Importfunktion **Option 1: Aus der Personenansicht** 1. Navigieren Sie zu **Personen** in der linken Seitenleiste 2. Klicken Sie auf das Symbol **⋮** oben rechts 3. Wählen Sie **Datensätze importieren** **Option 2: Über das Befehlsmenü** 1. Drücken Sie `Cmd + K` (Mac) oder `Strg + K` (Windows) 2. Geben Sie "import" ein 3. Wählen Sie **Datensätze importieren** 4. Wählen Sie **Personen** ## Schritt 3: Laden Sie Ihre Datei hoch 1. Klicken Sie auf **Datei auswählen** 2. Wählen Sie Ihre CSV-, XLSX- oder XLS-Datei aus 3. Warten Sie, bis Twenty Ihre Datei analysiert ## Schritt 4: Ordnen Sie Ihre Spalten zu Twenty versucht automatisch, Ihre Spalten den Feldern zuzuordnen. Prüfen und anpassen: 1. **Automatische Zuordnungen prüfen** — vergewissern Sie sich, dass sie korrekt sind 2. **Falsche Zuordnungen korrigieren** — klicken Sie auf das Dropdown, um das richtige Feld auszuwählen 3. **Spalten überspringen** — wählen Sie **Do not map** für Spalten, die Sie nicht importieren möchten ### Wichtige Zuordnungsregeln | Spaltentyp | Zuordnen zu | Notizen | | -------------------- | ------------------------------ | ------------------------------------------ | | Unternehmensreferenz | **Company**-Beziehungsfeld | Verwenden Sie Domain ODER ID, nicht beides | | E-Mail | **E-Mail** | Primäre E-Mail-Adresse | | Zusätzliche E-Mails | **Emails / Additional Emails** | Array-Format | | Telefon | Getrennte Spalten | Nummer, Ländercode, Telefonvorwahl | ### Zuordnung der Unternehmensbeziehung Beim Zuordnen der Unternehmensspalte: 1. Suchen Sie Ihre Unternehmensreferenzspalte (z. B. `companyDomain`) 2. Ordnen Sie sie dem **Company**-Beziehungsfeld zu 3. Twenty verknüpft jede Person mit dem passenden Unternehmen **Ordnen Sie für Beziehungen nur EINEN eindeutigen Bezeichner zu.** Ordnen Sie nicht sowohl `companyId` als auch `companyDomain` zu. Wählen Sie eines — vorzugsweise die Domain, da sie menschenlesbar ist. ## Schritt 5: Werte von Auswahlfeldern zuordnen Wenn Sie Auswahl- oder Mehrfachauswahlfelder haben (wie z. B. Lead-Quelle): 1. Twenty zeigt Ihre Werte neben den vorhandenen Optionen an 2. Ordnen Sie jeden Wert in Ihrer Datei einer Twenty-Option zu 3. Oder erstellen Sie bei Bedarf neue Optionen Auswahloptionen verwenden **API-Namen**, nicht Anzeigenamen. Prüfen Sie **Einstellungen → Datenmodell** → Aktivieren Sie den **Erweiterten Modus**, um API-Namen zu sehen. ## Schritt 6: Fehler prüfen und beheben Bevor der Import abgeschlossen wird, validiert Twenty Ihre Daten: 1. Klicken Sie auf **Nächste Schritte** 2. Zeilen mit Fehlern sind **gelb** hervorgehoben 3. **Fehler direkt beheben** — klicken Sie auf eine Zelle und bearbeiten Sie den Wert 4. **Problematische Zeilen entfernen** — klicken Sie auf das X, um die Zeile zu überspringen ### Häufige Fehler beim Kontaktimport | Fehler | Ursache | Lösung | | ----------------------------- | ---------------------------------------------------- | -------------------------------------------------------------------- | | **Doppelte E-Mail** | E-Mail existiert bereits in Twenty oder in der Datei | Duplikat entfernen oder bestehenden Datensatz aktualisieren | | **Ungültiges E-Mail-Format** | E-Mail-Format ist falsch | Auf `name@domain.com` korrigieren | | **Relation nicht gefunden** | Unternehmen existiert nicht | Importieren Sie zuerst Unternehmen oder korrigieren Sie die Referenz | | **Erforderliches Feld fehlt** | Erforderliches Feld ist leer | Wert ausfüllen oder Zeile entfernen | ## Schritt 7: Import abschließen 1. Importzusammenfassung prüfen 2. Klicken Sie auf **Bestätigen**, um zu importieren 3. Warten Sie, bis der Import abgeschlossen ist 4. Überprüfen Sie dies, indem Sie einige Datensätze und deren Unternehmensverknüpfungen kontrollieren ## Nach dem Import von Kontakten Ihre Kontakte sind jetzt in Twenty! Nächste Schritte: 1. **Unternehmensverknüpfungen überprüfen** — öffnen Sie einige Personen-Datensätze, um zu bestätigen, dass sie mit dem richtigen Unternehmen verknüpft sind 2. **Verkaufschancen importieren** — verknüpfen Sie sie bei Bedarf mit Personen und Unternehmen 3. **E-Mail-Synchronisierung einrichten** — verbinden Sie Ihr Postfach, um den E-Mail-Verlauf in Kontaktdatensätzen zu sehen ## Vorhandene Kontakte aktualisieren So aktualisieren Sie Kontakte, statt neue zu erstellen: 1. Fügen Sie die Spalte `email` oder `id` in Ihrer Datei hinzu 2. Twenty gleicht Datensätze anhand dieses eindeutigen Bezeichners ab 3. Vorhandene Kontakte werden aktualisiert; neue werden erstellt Details finden Sie unter [So aktualisieren Sie vorhandene Datensätze](/l/de/user-guide/data-migration/how-tos/update-existing-records-via-import). ## FAQ E-Mail ist ein eindeutiger Bezeichner in Twenty. Das verhindert doppelte Kontakte und stellt sicher, dass die E-Mail-Synchronisierung E-Mails der richtigen Person korrekt zuordnet. Sie können das E-Mail-Feld leer lassen. Wir empfehlen jedoch, wenn möglich E-Mail-Adressen hinzuzufügen, um die Datenqualität und die E-Mail-Synchronisierung zu verbessern. Fügen Sie eine Spalte mit der Domain des Unternehmens (z. B. `https://acme.com`) oder der ID hinzu. Verbinden Sie diese Spalte beim Mapping mit dem Unternehmens-Relationsfeld. Importieren Sie zuerst Unternehmen und dann Personen. Das Unternehmen muss existieren, bevor Sie darauf verweisen können. Ja! Erstellen Sie in Ihrem Datenmodell ein benutzerdefiniertes Feld, das als "eindeutig" markiert ist, um die externe ID zu speichern. Hinweis: Der Feldname `id` ist für die interne ID von Twenty reserviert. Das Unternehmen, auf das Sie verweisen, existiert nicht. Importieren Sie entweder zuerst das Unternehmen oder prüfen Sie, dass die Domain/ID exakt mit einem vorhandenen Unternehmen übereinstimmt. ## Fehlerbehebung Gibt es Probleme? Prüfen Sie: * [So beheben Sie Importfehler](/l/de/user-guide/data-migration/how-tos/fix-import-errors) * [So importieren Sie Beziehungen](/l/de/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) * [Referenz zur Feldzuordnung](/l/de/user-guide/data-migration/capabilities/field-mapping)