CSV-Dateiformat für den Import von Kontakten und Opportunities

Dieser Artikel hilft Ihnen, Ihre CSV-Datei korrekt zu formatieren, bevor Sie sie in HighLevel importieren. Durch die Befolgung dieser Anleitung vermeiden Sie häufige Importfehler, sparen Zeit und stellen sicher, dass Ihre Daten nahtlos in Ihr CRM fließen.


INHALTSVERZEICHNIS

  • Wichtige Vorteile der Vorbereitung Ihrer CSV-Datei

  • Was ist ein CSV-Dateiformat?

  • Strukturierung Ihrer Datei

    1. Beispiel-CSV-Format

    2. Pflichtfelder

    3. Feldformatierung

    4. Unterstützter Dateityp und Dateigröße

    5. Pflicht- und optionale Felder für den Import

    6. Formatierungsrichtlinien nach Feldtyp

  • Unterstützte Länderliste für CSV-Importe

  • Unterstützte Zeitzonen

  • Häufig gestellte Fragen

  • Verwandte Artikel


Wichtige Vorteile der Vorbereitung Ihrer CSV-Datei

Die Zeit zu investieren, um Ihre CSV-Datei vor dem Import korrekt zu formatieren, stellt sicher, dass Ihre Kontaktdaten sauber, vollständig und korrekt zugeordnet sind.

  • Verringert die Wahrscheinlichkeit von Importfehlern oder Upload-Fehlschlägen

  • Hilft HighLevel, Felder während des Imports automatisch zuzuordnen

  • Ermöglicht die Duplikaterkennung und präzise Updates

  • Unterstützt benutzerdefinierte Felder und erweiterte Segmentierung

  • Spart Zeit, indem Nachbearbeitung nach dem Import vermieden wird

  • Erhöht den Erfolg beim Hochladen von Kontakten oder Opportunities in großen Mengen


Was ist ein CSV-Dateiformat?

CSV steht für „Comma-Separated Values“ (durch Kommas getrennte Werte). Es handelt sich um ein einfaches Dateiformat, das tabellarische Daten wie Tabellen oder Datenbanken speichert. Jede Zeile in einer CSV-Datei stellt einen einzelnen Datensatz dar, und Felder innerhalb des Datensatzes sind durch Kommas getrennt. Es ist eines der am weitesten verbreiteten Formate zum Importieren und Exportieren von Daten zwischen verschiedenen Systemen.

  • CSV-Dateien haben typischerweise die Endung .csv.

  • Sie können in Tools wie Excel, Google Sheets oder Notepad erstellt oder bearbeitet werden.

  • Stellen Sie sicher, dass nur ein Tabellenblatt in der Datei vorhanden ist, um Importprobleme zu vermeiden.

Beispiel:

First Name

Last Name

Email

Phone

Jane

Doe

jane@example.com

+11234567890

John

Smith

john@example.com

+10987654321


Strukturierung Ihrer Datei

Um eine genaue Datenzuordnung zu gewährleisten, strukturieren Sie Ihre CSV-Datei mit Spaltenüberschriften, die den Standard- oder benutzerdefinierten Feldern in HighLevel entsprechen.

1. Beispiel-CSV-Format

First Name

Last Name

Email

Phone

Company

Tags

Status

Created Date

Additional Phone

John

Doe

john@example.com

+11234567890

ABC Corp

VIP, Lead

New

01/01/2024

+17877123462

Jane

Smith

jane@example.com

+15556667777

XYZ Ltd

Customer

Active

02/02/2024

+17877123464

  • Jede Zeile repräsentiert einen einzelnen Kontakt oder eine Opportunity.

  • Jede Spalte repräsentiert eine eindeutige Eigenschaft.

  • Die Kopfzeile ist erforderlich, um Felder korrekt zuzuordnen.


2. Pflichtfelder

Mindestens eines der folgenden Felder ist erforderlich, um einen Kontakt zu erstellen oder zu aktualisieren:

  • Vorname

  • E-Mail-Adresse

  • Telefonnummer

Hinweis: Zum Aktualisieren von Kontakten ist ein eindeutiger Bezeichner (Kontakt-ID, E-Mail oder Telefon) erforderlich, basierend auf Ihren Duplikateinstellungen. Für Opportunities fügen Sie die Opportunity-ID hinzu, wenn Sie aktualisieren. Andernfalls wird eine neue Opportunity erstellt.


3. Feldformatierung

Befolgen Sie diese spezifischen Formatierungsregeln, um Importfehler zu vermeiden:

Feldtyp

Akzeptierte Formate / Hinweise

Datumsauswahl (Datumsfelder)

MM/DD/YYYY, YYYY/MM/DD, MM-DD-YYYY, YYYY-MM-DD

Mehrfachauswahl / Checkbox

Kommas: VIP, Lead; Semikolons: Gold; Silver; Punkte: Yes. ❌ Schrägstriche = ungültig

Einzeloption (Dropdown)

Nur ein Wert, z. B.: Blue

Kontaktbesitzer

Vorname Nachname — z. B. Logan Paul

Tags

Kommas, Semikolons oder Punkte, z. B.: Blue, Yellow, Blue; Yellow

Telefonnummer

E.164: +11234567890 (empfohlen); auch 123-456-7890, (123) 456-7890 (nur US)

Ungültige Telefonnummern

1234567, abc1234567

Numerische Felder

1.23, 1234, .123

Geldbeträge

1234, 1,234,234.33

Kontakt-Follower

Vorname Nachname, Vorname2 Nachname2 — z. B. Adam Smith, David Lee

Zusätzliche E-Mails

abc@email.com, abc1@email.com

Zusätzliche Telefonnummern

+1 7877123460, +1 7877123461


4. Unterstützter Dateityp und Dateigröße

Anforderung

Details

Dateiformat

Nur .csv

Erlaubte Tabellenblätter

Ein Blatt pro Datei

Maximale Dateigröße

30 MB


5. Pflicht- und optionale Felder für den Import

Importaktion

Pflicht/Optionale Felder

Hinweise

Neuer Kontakt

Name oder E-Mail oder Telefon

Mindestens eines erforderlich

Bestehenden Kontakt aktualisieren

Kontakt-ID oder Name/E-Mail/Telefon

Abhängig von den Duplikateinstellungen

Kopfzeile

Pflicht

Muss bestehenden oder benutzerdefinierten Feldern in HighLevel entsprechen


6. Formatierungsrichtlinien nach Feldtyp

Feldtyp

Format

Beispiel

Hinweise

Telefonnummer

E.164 oder Standard-US-Formate

+1 1234567890 / 123-456-7890

Sauberes und konsistentes Format

E-Mail-Adresse

Standardformat

name@example.com

Muss @ und Domain enthalten

Datum

Mehrere akzeptierte Formate

04/16/2025, 2025-04-16

Wählen Sie ein Format und bleiben Sie dabei

Mehrfachauswahlfelder

Getrennt durch ,, ; oder .

Blue, Yellow, Green

Muss mit CRM-Feldoptionen übereinstimmen

Zusätzliche E-Mails

Komma-getrennt

email1@example.com, email2@example.com

In separater Spalte hinzufügen

Zusätzliche Telefonnummern

Komma-getrennt

1234567890, 9876543210

In separater Spalte hinzufügen

Tipp: Stellen Sie vor dem Import sicher, dass benutzerdefinierte Felder bereits in Ihrem HighLevel-Konto mit denselben Bezeichnungen und Datentypen erstellt wurden. Weitere Informationen finden Sie unter Übersicht über Merge Fields & Custom Variables.


Unterstützte Länderliste für CSV-Importe

Diese Liste enthält die offiziellen Ländercodes, die bei CSV-Importen in HighLevel verwendet werden müssen.

  • Zweck: HighLevel überprüft die Ländernamen während des Imports. Wenn Ihre CSV-Datei ein Länderfeld enthält, muss jede Zeile mit einem der genauen Namen in dieser Liste übereinstimmen.

  • Format: Muss exakt übereinstimmen – Groß-/Kleinschreibung und Rechtschreibung beachten. Beispiel: „United States“ ist akzeptiert, „USA“ oder „U.S.“ führt zu einem Fehler.

  • Benutzerdefinierte Felder: Wenn Sie ein benutzerdefiniertes Länderfeld verwenden, profitieren Sie dennoch davon, sich an diese Liste zu halten.

Ländername (Code)

Ländername (Code)

Ländername (Code)

Afghanistan (AF)

Albanien (AL)

Algerien (DZ)

Andorra (AD)

Angola (AO)

Antigua und Barbuda (AG)

Argentinien (AR)

Armenien (AM)

Australien (AU)

Österreich (AT)

Aserbaidschan (AZ)

Bahamas (BS)

Bahrain (BH)

Bangladesch (BD)

Barbados (BB)

Belarus (BY)

Belgien (BE)

Belize (BZ)

Benin (BJ)

Bhutan (BT)

Bolivien (BO)

Bosnien und Herzegowina (BA)

Botswana (BW)

Brasilien (BR)

Brunei (BN)

Bulgarien (BG)

Burkina Faso (BF)

Burundi (BI)

Cabo Verde (CV)

Kambodscha (KH)

Kamerun (CM)

Kanada (CA)

Zentralafrikanische Republik (CF)

Tschad (TD)

Chile (CL)

China (CN)

Kolumbien (CO)

Komoren (KM)

Kongo (CG)

Kongo (Kinshasa) (CD)

Costa Rica (CR)

Kroatien (HR)

Kuba (CU)

Zypern (CY)

Tschechische Republik (CZ)

Dänemark (DK)

Dschibuti (DJ)

Dominica (DM)

Dominikanische Republik (DO)

Osttimor (TL)

Ecuador (EC)

Ägypten (EG)

El Salvador (SV)

Äquatorialguinea (GQ)

Eritrea (ER)

Estland (EE)

Eswatini (SZ)

Äthiopien (ET)

Fidschi (FJ)

Finnland (FI)

Frankreich (FR)

Gabun (GA)

Gambia (GM)

Georgien (GE)

Deutschland (DE)

Ghana (GH)

Griechenland (GR)

Grenada (GD)

Guatemala (GT)

Guinea (GN)

Guinea-Bissau (GW)

Guyana (GY)

Haiti (HT)

Honduras (HN)

Ungarn (HU)

Island (IS)

Indien (IN)

Indonesien (ID)

Iran (IR)

Irak (IQ)

Irland (IE)

Israel (IL)

Italien (IT)

Jamaika (JM)

Japan (JP)

Jordanien (JO)

Kasachstan (KZ)

Kenia (KE)

Kiribati (KI)

Nordkorea (KP)

Südkorea (KR)

Kosovo (XK)

Kuwait (KW)

Kirgisistan (KG)

Laos (LA)

Lettland (LV)

Libanon (LB)

Lesotho (LS)

Liberia (LR)

Libyen (LY)

Liechtenstein (LI)

Litauen (LT)

Luxemburg (LU)

Madagaskar (MG)

Malawi (MW)

Malaysia (MY)

Malediven (MV)

Mali (ML)

Malta (MT)

Marshallinseln (MH)

Mauretanien (MR)

Mauritius (MU)

Mexiko (MX)

Mikronesien (FM)

Moldawien (MD)

Monaco (MC)

Mongolei (MN)

Montenegro (ME)

Marokko (MA)

Mosambik (MZ)

Myanmar (MM)

Namibia (NA)

Nauru (NR)

Nepal (NP)

Niederlande (NL)

Neuseeland (NZ)

Nicaragua (NI)

Niger (NE)

Nigeria (NG)

Nordmazedonien (MK)

Norwegen (NO)

Oman (OM)

Pakistan (PK)

Palau (PW)

Panama (PA)

Papua-Neuguinea (PG)

Paraguay (PY)

Peru (PE)

Philippinen (PH)

Polen (PL)

Portugal (PT)

Katar (QA)

Rumänien (RO)

Russland (RU)

Ruanda (RW)

St. Kitts und Nevis (KN)

St. Lucia (LC)

St. Vincent und die Grenadinen (VC)

Samoa (WS)

San Marino (SM)

São Tomé und Príncipe (ST)

Saudi-Arabien (SA)

Senegal (SN)

Serbien (RS)

Seychellen (SC)

Sierra Leone (SL)

Singapur (SG)

Slowakei (SK)

Slowenien (SI)

Salomonen (SB)

Somalia (SO)

Südafrika (ZA)

Südsudan (SS)

Spanien (ES)

Sri Lanka (LK)

Sudan (SD)

Suriname (SR)

Schweden (SE)

Schweiz (CH)

Syrien (SY)

Taiwan (TW)

Tadschikistan (TJ)

Tansania (TZ)

Thailand (TH)

Togo (TG)

Tonga (TO)

Trinidad und Tobago (TT)

Tunesien (TN)

Türkei (TR)

Turkmenistan (TM)

Tuvalu (TV)

Uganda (UG)

Ukraine (UA)

Vereinigte Arabische Emirate (AE)

Vereinigtes Königreich (GB)

Vereinigte Staaten (US)

Uruguay (UY)

Usbekistan (UZ)

Vanuatu (VU)

Vatikanstadt (VA)

Venezuela (VE)

Vietnam (VN)

Jemen (YE)

Sambia (ZM)

Simbabwe (ZW)


Unterstützte Zeitzonen

Verwenden Sie eines der folgenden Zeitzonenformate in Ihrer CSV. Sie sind case-sensitive und müssen exakt übereinstimmen.

Zeitzone

Zeitzone

Zeitzone

Etc/GMT+12

Pacific/Midway

Pacific/Honolulu

America/Juneau

US/Alaska

America/Dawson

America/Los_Angeles

America/Phoenix

America/Tijuana

US/Arizona

America/Belize

America/Boise

America/Chihuahua

America/Denver

America/Edmonton

America/Guatemala

America/Managua

America/Regina

Canada/Saskatchewan

US/Mountain

America/Bahia_Banderas

America/Bogota

America/Cancun

America/Chicago

America/Mexico_City

US/Central

America/Caracas

America/Detroit

America/Indiana/Indianapolis

America/Louisville

America/Manaus

America/New_York

America/Santiago

America/Santo_Domingo

America/Toronto

US/East-Indiana

US/Eastern

America/Argentina/Buenos_Aires

America/Glace_Bay

America/Montevideo

America/Sao_Paulo

Canada/Atlantic

America/St_Johns

Canada/Newfoundland

America/Godthab

America/Noronha

Etc/GMT+2

Atlantic/Cape_Verde

Atlantic/Azores

UTC

Africa/Algiers

Africa/Casablanca

Africa/Lagos

Atlantic/Canary

Europe/London

Africa/Cairo

Africa/Harare

Europe/Amsterdam

Europe/Belgrade

Europe/Brussels

Europe/Madrid

Europe/Oslo

Europe/Sarajevo

Africa/Nairobi

Asia/Amman

Asia/Baghdad

Asia/Jerusalem

Asia/Kuwait

Asia/Qatar

Europe/Athens

Europe/Bucharest

Europe/Helsinki

Europe/Moscow

Asia/Baku

Asia/Dubai

Asia/Kabul

Asia/Tehran

Asia/Karachi

Asia/Yekaterinburg

Asia/Colombo

Asia/Kolkata

Asia/Calcutta

Asia/Kathmandu

Asia/Almaty

Asia/Dhaka

Asia/Rangoon

Asia/Bangkok

Asia/Krasnoyarsk

Asia/Irkutsk

Asia/Kuala_Lumpur

Asia/Shanghai

Asia/Taipei

Australia/Perth

Asia/Seoul

Asia/Tokyo

Asia/Yakutsk

Australia/Adelaide

Australia/Darwin

Asia/Vladivostok

Australia/Brisbane

Australia/Canberra

Australia/Hobart

Australia/Sydney

Pacific/Guam

Asia/Magadan

Pacific/Auckland

Pacific/Fiji

Pacific/Tongatapu

Häufig gestellte Fragen (FAQ)

F: Kann ich Kontakte mit mehr als einer Telefonnummer oder E-Mail importieren?
A: Ja! Verwenden Sie separate Spalten wie Zusätzliche Telefonnummern und Zusätzliche E-Mail-Adressen und trennen Sie die Einträge mit Kommas.

F: Was passiert, wenn ich ein Feld in der CSV-Datei habe, das in HighLevel nicht existiert?
A: Dieses Feld wird ignoriert, es sei denn, Sie ordnen es während des Imports einem bestehenden Standard- oder benutzerdefinierten Feld zu.

F: Erkennt HighLevel Duplikate automatisch?
A: Ja. Basierend auf Ihren Duplikaterkennungseinstellungen kann HighLevel anhand von Kontakt-ID, Telefonnummer oder E-Mail Übereinstimmungen erkennen und die Datensätze entweder zusammenführen oder überspringen.

F: Kann ich Kontakte mit einem CSV-Import aktualisieren?
A: Absolut. Stellen Sie nur sicher, dass Sie ein Feld einschließen, das für Ihre Duplikat-Erkennung verwendet wird (wie Kontakt-ID, E-Mail oder Telefonnummer).

F: Muss ich leere Zeilen und Spalten bereinigen?
A: Ja. Es ist am besten, alle unnötigen Daten zu entfernen, um unerwartetes Verhalten beim Import zu vermeiden.


Verwandte Artikel

  • Importieren von Opportunities über eine CSV-Datei

  • Fehlerbehebung bei Bulk-Importen über CSV

  • Importieren von Kontakten über eine CSV-Datei


War dieser Artikel hilfreich?