> ## 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. # CSV-Import bleibt hängen > Was Sie tun können, wenn Ihr CSV-Import von Kontakten hängen bleibt oder länger dauert als erwartet Wenn Ihr CSV-Import ungewöhnlich lange bei **Kontaktimport läuft** stehen bleibt, bedeutet das in der Regel, dass die Datei in der Importwarteschlange wartet oder CloudTalk mehr Zeit als erwartet für die Verarbeitung der Daten benötigt. Dieser Artikel erklärt, was im Hintergrund passiert, warum Importe länger dauern können und was Sie tun können, um das Problem zu lösen. **Benutzerebene:** Agent ***

Symptome

Möglicherweise stellen Sie eines oder mehrere der folgenden Symptome fest: * Der Status bleibt lange auf **Kontaktimport läuft** * Der Importbildschirm zeigt keinen Fortschritt an * Ihre Datei bleibt auch nach erneutem Hochladen im Status „in Verarbeitung" * Eine ähnliche Datei wurde zuvor schnell importiert, diese dauert jedoch länger * Nur ein Teil der Datei erscheint in den Kontakten, der Rest scheint eingefroren zu sein Manchmal sind diese Symptome vorübergehend und lösen sich von selbst, sobald sich die Warteschlange bewegt.

So funktionieren CSV-Importe

Wenn Sie eine CSV-Datei hochladen, verarbeitet CloudTalk sie im Hintergrund. Der Vorgang umfasst mehrere Schritte, von denen die meisten in der Oberfläche nicht sichtbar sind. 1. CloudTalk prüft, ob die Datei die Grundanforderungen erfüllt (CSV-Format, Größenbeschränkung, erforderliche Kopfzeilen) 2. Die Datei kommt in eine gemeinsame Verarbeitungswarteschlange 3. Wenn Sie an der Reihe sind, verarbeitet CloudTalk die Datei und validiert jede Zeile 4. Kontakte, welche die Validierung bestehen, werden direkt zu Ihren Kontakten hinzugefügt Es gibt keine Schritt-für-Schritt-Fortschrittsanzeige. Stattdessen sehen Sie: * **„Kontaktimport läuft"**, während die Datei wartet oder verarbeitet wird * **„Wir konnten Ihre Kontakte nicht importieren."**, wenn das System die Datei nicht verarbeiten kann Bei einem erfolgreichen Import erscheinen die Kontakte in Ihrer Kontaktliste, sobald die Verarbeitung abgeschlossen ist. Je nach Ergebnis wird der Import im Bereich „Importierte Dateien" als abgeschlossen markiert. Die Kontakte erscheinen einfach in Ihrer Kontaktliste, sobald die Verarbeitung abgeschlossen ist. Da CSV-Importe unbemerkt im Hintergrund ablaufen, sieht jede Verzögerung in der Warteschlange einem „hängenden" Import sehr ähnlich.

Ursachen

⚠️ Ihr CSV-Import wartet in der gemeinsamen Warteschlange

Das ist der häufigste Grund für Verzögerungen. CloudTalk verarbeitet alle CSV-Importe aller Kunden über eine gemeinsame Warteschlange nach einer einfachen Regel: **Wer zuerst hochlädt, wird zuerst verarbeitet.** Das bedeutet: * Große Dateien, die andere Kunden hochladen, können Ihren Import verzögern * Ihre Datei wartet möglicherweise, bis frühere Aufträge abgeschlossen sind * Wenn Ihr Team mehrere CSV-Dateien hochlädt, werden diese strikt der Reihe nach verarbeitet * Ein Upload zu Stoßzeiten kann die Wartezeit verlängern **Was Ihnen bei Verzögerungen in der Warteschlange auffallen kann** * Der Status bleibt auf **Kontaktimport läuft** * Es erscheinen keine neuen Kontakte * Erneutes Hochladen der Datei führt zum selben Wartezustand Dieses Verhalten ist zu Spitzenzeiten normal.

⚠️ Die Datei ist groß und benötigt mehr Verarbeitungszeit

CloudTalk unterstützt CSV-Dateien bis **8 MB**. Selbst wenn die Datei innerhalb dieser Grenze liegt, kann die Verarbeitung länger dauern, wenn sie Folgendes enthält: * Eine große Anzahl von Zeilen * Viele Spalten * Mehrere benutzerdefinierte Felder * Lange Textwerte * Komplexe oder unterschiedliche Zeichensätze Größere Dateien brauchen mehr Zeit zum Einlesen und Validieren.

⚠️ Die Datei enthält Elemente, welche die Validierung verlangsamen

Der Import kann erfolgreich abgeschlossen werden, aber dennoch länger dauern, wenn die Datei Folgendes enthält: * Telefonnummern, die CloudTalk normalisieren muss * Fehlende Ländercodes, die eine automatische Vorwahlverarbeitung erfordern * Viele ungültige Telefonnummern * Spaltenformate, die CloudTalk interpretieren muss * Sehr große oder komplexe Zeilen * Zusätzliche Leerzeichen um die Werte * Sehr lange Namen oder Freitextfelder Diese Punkte verhindern den Import nicht, können aber die Verarbeitungszeit verlängern.

⚠️ Die Datei kann wegen Struktur- oder Kodierungsproblemen nicht verarbeitet werden

Wenn der Import nie startet oder unmittelbar nach dem Verarbeitungsbeginn fehlschlägt, enthält die Datei möglicherweise Struktur- oder Kodierungsprobleme. Zum Beispiel: * Falsche Kodierung * Falsches Trennzeichen * Versteckte oder überflüssige Zeichen aus Excel oder Numbers * Fehlerhafte oder leere Zeilen innerhalb der Tabelle * Nicht unterstützte Symbole oder Emojis * Spaltennamen, die nicht den Anforderungen von CloudTalk entsprechen * Fehlende Pflichtspalten (`name` und mindestens eine von: `phone` oder `email`) * Kopfzeilen mit Großbuchstaben statt des erforderlichen Kleinbuchstabenformats Dieses Thema wird ausführlicher behandelt in **[Upload der CSV-Datei schlägt fehl](/de/articles/12930295-upload-of-csv-file-fails)** Allgemeine Anleitungen zur Vorbereitung einer CSV-Datei, einschließlich Dateigrößenbeschränkungen, Pflichtspalten und Formatierungsrichtlinien, finden Sie unter **[So importieren Sie Kontakte aus einer Datei in CloudTalk](/de/articles/3422012-how-to-import-contacts-to-cloudtalk-from-a-file)**.

⚠️ Versteckte Excel-Formatierung

Auch wenn die Datei optisch korrekt aussieht, können Excel oder Numbers versteckte Formatierungen hinzufügen, welche die Verarbeitung verlangsamen: * Versteckte Zeichen * Aus anderen Tabellen kopierte Formatierung * Zusätzliche Trennzeichen * Kodierte Symbole * Unsichtbare leere Spalten Diese Probleme machen Importe oft langsamer oder lassen sie hängen erscheinen, selbst wenn sie am Ende abgeschlossen werden.

Schritt-für-Schritt-Lösung

Nachfolgend finden Sie praktische Schritte, mit denen Sie feststellen, ob der Import tatsächlich hängt oder einfach nur an der Reihe wartet.

1. Prüfen Sie, ob neue Kontakte erschienen sind

Da CloudTalk keinen detaillierten Importfortschritt anzeigt, prüfen Sie am einfachsten so, ob der Import vorankommt: 1. Gehen Sie zu **Kontakte** 2. Suchen Sie nach mehreren Kontakten aus Ihrer Datei 3. Aktualisieren Sie die Seite „Kontakte" Wenn neue Kontakte erscheinen, läuft der Import.

2. Geben Sie dem Import etwas Zeit

In Zeiten hoher Auslastung können CSV-Importe länger dauern als gewöhnlich. Die Wartezeit hängt davon ab, wie viele CSV-Dateien gerade über alle CloudTalk-Workspaces hinweg verarbeitet werden. Auch wenn sich in der Oberfläche nichts zu ändern scheint, verarbeitet das System im Hintergrund weiter. Die meisten Importe starten automatisch, sobald frühere Dateien abgeschlossen sind.

3. Laden Sie außerhalb der Stoßzeiten hoch

Wenn Sie regelmäßig mit CSV-Dateien arbeiten: * Laden Sie Dateien früh morgens oder später am Abend hoch * Laden Sie nicht mehrere große Dateien hintereinander hoch * Meiden Sie die Stoßzeiten Ihres Teams oder Workspace Das beschleunigt den Start des Imports häufig.

4. Verringern Sie die Dateigröße

CloudTalk unterstützt den Import großer CSV-Dateien, auch solcher mit **Zehntausenden Zeilen**. Sehr große Datensätze benötigen jedoch mehr Verarbeitungszeit. Als allgemeine Richtlinie gilt: * Größere Dateien (zum Beispiel über **5 MB**) können länger in der Verarbeitung dauern * Dateien mit **Hunderttausenden Zeilen** sollten in kleinere Pakete aufgeteilt werden * Bei extrem großen Importen (zum Beispiel **250.000+ Zeilen**) verbessert das Aufteilen der Daten auf mehrere Dateien die Leistung erheblich und verringert das Risiko von Zeitüberschreitungen

Tipps zur Optimierung großer Importe

So läuft Ihr Import schneller: * Entfernen Sie Spalten, die Sie nicht benötigen * Kürzen Sie lange Freitextfelder * Reduzieren Sie die Anzahl benutzerdefinierter Attribute (sofern nicht erforderlich) * Teilen Sie sehr große Dateien in mehrere kleinere CSV-Dateien auf * Beispiel: Verwenden Sie statt einer Datei mit 200.000 Zeilen vier Dateien mit je 50.000 Zeilen

Maximal zulässige Zeichenanzahl für Spalten

Jedes Feld in CloudTalk hat eine maximal zulässige Zeichenanzahl. Ein Überschreiten dieser Grenzen kann zu Importfehlern oder abgeschnittenen Feldern führen. | **Spalte** | **Max. Zeichen** | | - | - | | `name` | 150 | | `zip` | 15 | | `title` | 255 | | `company` | 100 | | `industry` | 100 | | `website` | 100 | | `address` | 255 | | `city` | 255 | | `state` | 255 |

5. Verwenden Sie die CSV-Vorlage von CloudTalk

Wenn Ihr Import nie vorankommt oder immer an derselben Stelle hängen bleibt: 1. Laden Sie die CSV-Vorlage von CloudTalk herunter 2. Öffnen Sie sie in Google Sheets 3. Kopieren Sie Ihre Daten in die Vorlage 4. Exportieren Sie als CSV (UTF-8) 5. Versuchen Sie den Import erneut Google Sheets bereinigt versteckte Formatierungen automatisch.

6. Laden Sie die Datei erneut hoch

Manchmal hilft ein erneutes Hochladen, wenn der vorherige Upload fehlgeschlagen ist oder während einer Spitzenauslastung erfolgte – eine bessere Position in der Warteschlange garantiert das jedoch nicht. Besonders nützlich ist das, wenn: * Sie während einer Spitzenauslastung hochgeladen haben * Ein anderer Import die Warteschlange blockiert hat * Sie Änderungen an der Datei vorgenommen haben

Schnellere Alternativen zum CSV-Import

Wenn Sie regelmäßig große Mengen an Kontaktdaten verarbeiten, ist CSV möglicherweise nicht die schnellste Option. Ziehen Sie Folgendes in Betracht: * **Native Integrationen** HubSpot, Salesforce, Pipedrive, Zoho und andere synchronisieren Kontakte automatisch und umgehen die CSV-Warteschlange. * **CloudTalk API** Ideal für große oder häufige Importe. Der Endpunkt „Bulk Requests" unterstützt Vorgänge mit hohem Durchsatz. * **Zapier oder Make** Am besten für dynamische Quellen wie Google Sheets geeignet. Nach der Einrichtung fließen Aktualisierungen automatisch in CloudTalk.

Wann Sie den Support kontaktieren sollten

Wenden Sie sich an den [Support](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884), wenn: * Der Import länger als eine Stunde auf **Kontaktimport läuft** bleibt * Der Import nie startet, auch nicht zu Zeiten geringer Auslastung * Erneutes Hochladen zum selben Ergebnis führt * Nach wiederholten Versuchen keine Kontakte erscheinen * Die Datei dauerhaft stockt, selbst wenn sie in kleinere Teile aufgeteilt wird Fügen Sie Folgendes bei: * Ihre CSV-Datei * Einen Screenshot des **Importfensters**, sofern vorhanden * Den ungefähren Zeitpunkt des Uploads * Die Größe der Datei *** *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 - [Upload einer CSV-Datei schlägt fehl](/de/articles/12930295-upload-of-csv-file-fails.md) - [Kontakte aus einer Datei in CloudTalk importieren](/de/articles/3422012-how-to-import-contacts-to-cloudtalk-from-a-file.md) - [So importieren Sie Kontakte in CloudTalk](/de/articles/2145547-how-to-import-contacts-into-cloudtalk.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.