Upload einer CSV-Datei schlägt fehl

Benutzerebene: Admin

---

​

Symptome

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

​

Ursachen

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

​

⚠️ Probleme mit Dateiformat oder Kodierung

• 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.

​

⚠️ Fehlende oder falsche Kopfzeilen

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.

​

⚠️ Format der Telefonnummern

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

​

Schritt-für-Schritt-Lösung

​

1. Erstellen Sie die CSV-Datei in einem sauberen Format neu

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)
   
6. Importieren Sie diese neue CSV-Datei in CloudTalk

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

​

2. Überprüfen Sie Ihre Spaltenüberschriften

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 in CloudTalk entspricht.

​

3. Prüfen Sie das Format der Telefonnummern

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.

​

4. Bereinigen Sie die Datei

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

​

5. Wenn Sie benutzerdefinierte Spalten verwenden

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

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

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

​

6. Testen Sie es mit einer kleinen Datei

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

​

Wann Sie den Support kontaktieren sollten

Wenden Sie sich nur dann an den CloudTalk Support, 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 — wir sind für Sie da.