Zum Hauptinhalt springen

​
Ü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 importierenWenn 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

FeldErforderlich?FormatNotizen
E-MailEmpfohlen[email protected]Muss eindeutig sein
VornameEmpfohlenText
NachnameEmpfohlenText
UnternehmenOptionalDomain oder IDVerknüpft mit vorhandenem Unternehmen
TelefonOptionalMehrere SpaltenSiehe unten
BerufsbezeichnungOptionalText
Benutzerdefinierte FelderOptionalVariiertMuss im Datenmodell existieren

​
E-Mail-Format

  • Muss ein gültiges E-Mail-Format haben: [email protected]
  • Muss eindeutig sein — keine Duplikate in Ihrer Datei oder in Twenty
  • Für zusätzliche E-Mails verwenden Sie die Spalte Emails / Additional Emails:
["[email protected]","[email protected]"]

​
Telefonformat

Telefon ist ein verschachteltes Feld, das mehrere Spalten erfordert:
SpalteBeispiel
Phones / Primary Phone Number4159095555
Phones / Primary Phone Country CodeUS
Phones / Primary Phone Calling Code+1

​
Verknüpfung mit Unternehmen

Fügen Sie eine Spalte mit dem eindeutigen Bezeichner des Unternehmens hinzu:
SpaltennameFormatBeispiel
companyDomainURL-Formathttps://acme.com
companyIdUUIDc776ee49-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

firstName,lastName,email,jobTitle,companyDomain,Phones / Primary Phone Number,Phones / Primary Phone Country Code
John,Smith,[email protected],CEO,https://acme.com,4159095555,US
Jane,Doe,[email protected],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

SpaltentypZuordnen zuNotizen
UnternehmensreferenzCompany-BeziehungsfeldVerwenden Sie Domain ODER ID, nicht beides
E-MailE-MailPrimäre E-Mail-Adresse
Zusätzliche E-MailsEmails / Additional EmailsArray-Format
TelefonGetrennte SpaltenNummer, 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

FehlerUrsacheLösung
Doppelte E-MailE-Mail existiert bereits in Twenty oder in der DateiDuplikat entfernen oder bestehenden Datensatz aktualisieren
Ungültiges E-Mail-FormatE-Mail-Format ist falschAuf [email protected] korrigieren
Relation nicht gefundenUnternehmen existiert nichtImportieren Sie zuerst Unternehmen oder korrigieren Sie die Referenz
Erforderliches Feld fehltErforderliches Feld ist leerWert 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.

​
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: