> ## Documentation Index
> Fetch the complete documentation index at: https://help.cloudtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Upload einer CSV-Datei schlägt fehl

> Fehler, Verzögerungen und Formatprobleme beim CSV-Upload beheben

<Note>
  Wenn Ihr CSV-Import hängen bleibt, nur teilweise importiert wird oder mit Fehlern fehlschlägt, hilft Ihnen dieser Leitfaden dabei, Formatierungsprobleme, Verzögerungen in der Warteschlange, fehlende Felder und andere häufige Ursachen zu erkennen.
</Note>

**Benutzerebene:** Admin

***

<h2 id="h_5f21cb133c">
  Symptome
</h2>

Möglicherweise treten eines oder mehrere der folgenden Symptome auf:

* Der Import bleibt bei **Kontaktimport läuft** stehen

* Nur ein Teil der Datei wird importiert (zum Beispiel „352 Kontakte importiert")

* Benutzerdefinierte Spalten werden nicht importiert

* Die CSV-Datei schlägt wiederholt ohne erkennbare Ursache fehl

<h2 id="h_d999f72c5b">
  Ursachen
</h2>

Manche Probleme verhindern, dass der Import überhaupt startet (etwa falsche Kopfzeilen), andere betreffen nur einzelne Zeilen oder führen zu Verzögerungen.

<h3 id="h_00ae6f0320">
  **⚠️** Probleme mit Dateiformat oder Kodierung
</h3>

* Die Datei wurde nicht als **CSV UTF-8** exportiert

* Die Datei wurde in Excel oder Numbers bearbeitet, wodurch verborgene Zeichen entstehen können

* Nicht unterstützte Schriftarten, Emojis oder Zeichen außerhalb von UTF-8

* Falsche Trennzeichen (Semikolon statt Komma)

* Fehlerhafte Struktur, zum Beispiel:

  * Leere Zeilen mitten in den Daten

  * Verbundene Zellen

  * Beliebige Textblöcke ober- oder unterhalb der Tabelle

Diese Probleme können dazu führen, dass der Import einfriert, vorzeitig abbricht oder mit einem allgemeinen Serverfehler fehlschlägt.

<h3 id="h_6509cfd4d4">
  **⚠️** Fehlende oder falsche Kopfzeilen
</h3>

CloudTalk benötigt bestimmte Kopfzeilen, um Ihre CSV-Datei zu verarbeiten.

Importe können hängen bleiben oder fehlschlagen, wenn:

* Erforderliche Spalten fehlen (mindestens `name` und entweder `phone` oder `email`)

* Die Namen der Kopfzeilen nicht exakt übereinstimmen

  (`Name` oder `Phone` ist nicht dasselbe wie `name` und `phone`)

* Benutzerdefinierte Spalten verwendet werden, ohne dass zuvor passende benutzerdefinierte Attribute in CloudTalk angelegt wurden. In diesem Fall werden diese Spalten möglicherweise nicht importiert, der Rest der Datei kann aber trotzdem verarbeitet werden.

<h3 id="h_80029f30a1">
  **⚠️** Format der Telefonnummern
</h3>

Wenn Telefonnummern ungültig sind, können die betroffenen Kontakte nicht importiert werden, der Rest der Datei kann aber trotzdem verarbeitet werden.

Typische Probleme:

* Fehlender oder falscher Ländercode (kann zu einer falschen Formatierung der Nummer führen, wenn das Standardland nicht korrekt eingestellt ist)

* Zusätzliche Zeichen im Telefonfeld:

  * Klammern, Bindestriche

  * Text, Emojis oder Durchwahlen

<h2 id="h_7639fa0334">
  Schritt-für-Schritt-Lösung
</h2>

<h3 id="h_a2f61130e0">
  1. Erstellen Sie die CSV-Datei in einem sauberen Format neu
</h3>

Die sicherste Methode:

1. Laden Sie die CSV-Vorlage von CloudTalk herunter

2. Laden Sie die Vorlage in **Google Sheets** hoch

3. Fügen Sie Ihre Daten in die Vorlage ein

4. Stellen Sie sicher, dass die Tabelle:

   * In der ersten Zeile beginnt

   * Keine verbundenen Zellen enthält

   * Nur eine Kopfzeile hat

5. Laden Sie die Datei in Google Sheets als CSV herunter:

   **Datei > Herunterladen > Kommagetrennte Werte (.csv)**

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/Ql3WX5wAKbGZniqk/images/help-center/articles/12930295/f2cda6063676-image.png?fit=max&auto=format&n=Ql3WX5wAKbGZniqk&q=85&s=8623d193c43a4480ef4f9f0e3f4e2ff4" alt="" width="605" height="603" data-path="images/help-center/articles/12930295/f2cda6063676-image.png" />
   </Frame>

6. Importieren Sie diese neue CSV-Datei in CloudTalk

Damit werden in der Regel Kodierungsprobleme und verborgene Zeichen aus Excel oder Numbers entfernt.

<Warning>
  Eine vollständige Schritt-für-Schritt-Anleitung zum Import, einschließlich Download der CSV-Vorlage und der Importschritte, finden Sie unter [So importieren Sie Kontakte aus einer Datei in CloudTalk](/de/articles/3422012-how-to-import-contacts-to-cloudtalk-from-a-file)
</Warning>

<h3 id="h_9d97c69d39">
  2. Überprüfen Sie Ihre Spaltenüberschriften
</h3>

Prüfen Sie in der Google-Sheets-Datei:

* Sie haben mindestens:

  * `name`

  * `Telefon` oder `email`

* Die Namen der Kopfzeilen sind in **Kleinbuchstaben** geschrieben und stimmen exakt mit CloudTalk überein

* Vor oder nach dem Text der Kopfzeile stehen keine zusätzlichen Leerzeichen

Wenn Sie zusätzliche Spalten verwenden, achten Sie darauf, dass jede benutzerdefinierte Spalte einem [benutzerdefinierten Attribut](/de/articles/2144934-custom-attributes) in CloudTalk entspricht.

<h3 id="h_ffeb355df1">
  3. Prüfen Sie das Format der Telefonnummern
</h3>

Sehen Sie sich einige Beispielzeilen in der Spalte `Telefon` an:

* Telefonnummern können entweder im internationalen Format (E.164) angegeben werden, zum Beispiel: `+14151234567`, oder im lokalen Format (z. B. `090886547`).

* Enthält eine Nummer keinen Ländercode, verwendet CloudTalk den Standard-Ländercode aus Ihren Kontoeinstellungen. Damit das Ergebnis stimmt, prüfen Sie vor dem Import, ob Ihr Standardland korrekt eingestellt ist.

* Sie können mehrere Telefonnummern in einer Zelle angeben, getrennt durch einen Doppelpunkt (`:`), zum Beispiel: `+14151234567:+12125550189`

* Entfernen Sie:

  * Klammern

  * Bindestriche

  * Zusätzlichen Text

* Wenn eine Telefonnummer nicht als gültig erkannt wird, kann dieser Kontakt möglicherweise nicht importiert werden.

<h3 id="h_c493dc01ca">
  4. Bereinigen Sie die Datei
</h3>

Bevor Sie erneut importieren:

* Löschen Sie leere Zeilen in der Mitte und am Ende

* Entfernen Sie offensichtliche Duplikate

* Heben Sie alle Zellverbindungen auf

* Entfernen Sie Emojis oder ungewöhnliche Zeichen aus `name` oder anderen Feldern

* Entfernen Sie zusätzliche Leerzeichen am Anfang oder Ende von Zellen

<h3 id="h_75f070750f">
  5. Wenn Sie benutzerdefinierte Spalten verwenden
</h3>

Wenn zusätzliche Spalten aus Ihrer CSV-Datei nicht erscheinen oder den Import zu blockieren scheinen:

1. Öffnen Sie **Dashboard > Einstellungen > Allgemein > Kontakte**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/Ql3WX5wAKbGZniqk/images/help-center/articles/12930295/08b301a4f442-image.png?fit=max&auto=format&n=Ql3WX5wAKbGZniqk&q=85&s=335f4d7d602b2c40d0d904134fcd2d36" alt="" width="2423" height="1007" data-path="images/help-center/articles/12930295/08b301a4f442-image.png" />
</Frame>

2\. Legen Sie benutzerdefinierte Attribute an, die den Spaltennamen Ihrer CSV-Datei entsprechen

3\. Achten Sie darauf, dass die Namen exakt übereinstimmen (auch die Groß- und Kleinschreibung)

4\. Speichern Sie und importieren Sie die Datei erneut

<h3 id="h_ff3eed4beb">
  6. Testen Sie es mit einer kleinen Datei
</h3>

So finden Sie eine bestimmte problematische Zeile oder bestätigen das Problem:

1. Erstellen Sie eine neue Tabelle mit **20–50 Zeilen** aus Ihrer ursprünglichen CSV-Datei

2. Laden Sie diese Tabelle als CSV herunter

3. Importieren Sie diese kleine Datei in CloudTalk

* Wird die kleine Datei korrekt importiert, liegt das Problem wahrscheinlich in anderen Zeilen der ursprünglichen Datei

* Bleibt auch die kleine Datei hängen, liegt das Problem an der Struktur, den Kopfzeilen oder der Kodierung

<h2 id="h_5e0370ed8f">
  Wann Sie den Support kontaktieren sollten
</h2>

Wenden Sie sich nur dann an den [CloudTalk Support](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884), wenn:

* Der Import länger als **1 Stunde** hängt

* Die Datei sauber und korrekt formatiert ist

* Im Importverlauf keine neuen Zeilen erscheinen

* Auch der erneute Upload fehlschlägt

Fügen Sie bei:

* CSV-Datei

* Screenshots des Importverlaufs

* Fehlermeldung (falls vorhanden)

***

*Brauchen Sie Hilfe oder haben Sie eine Frage?* Melden Sie sich einfach über unser [Support-Portal](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — wir sind für Sie da.


## Related topics

- [CSV-Import bleibt hängen](/de/articles/12958920-csv-import-stuck.md)
- [Kontakte aus einer Datei in CloudTalk importieren](/de/articles/3422012-how-to-import-contacts-to-cloudtalk-from-a-file.md)
- [Doppelte Kontakte verhalten sich unerwartet](/de/articles/12929922-duplicate-contacts-behave-unexpectedly.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.