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.
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
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.- CloudTalk prüft, ob die Datei die Grundanforderungen erfüllt (CSV-Format, Größenbeschränkung, erforderliche Kopfzeilen)
- Die Datei kommt in eine gemeinsame Verarbeitungswarteschlange
- Wenn Sie an der Reihe sind, verarbeitet CloudTalk die Datei und validiert jede Zeile
- Kontakte, welche die Validierung bestehen, werden direkt zu Ihren Kontakten hinzugefügt
- „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
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
- Der Status bleibt auf Kontaktimport läuft
- Es erscheinen keine neuen Kontakte
- Erneutes Hochladen der Datei führt zum selben Wartezustand
⚠️ 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
⚠️ 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
⚠️ 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 (
nameund mindestens eine von:phoneoderemail) - Kopfzeilen mit Großbuchstaben statt des erforderlichen Kleinbuchstabenformats
⚠️ 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
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.
- Prüfen Sie, ob neue Kontakte erschienen sind
Da CloudTalk keinen detaillierten Importfortschritt anzeigt, prüfen Sie am einfachsten so, ob der Import vorankommt:
- Gehen Sie zu Kontakte
- Suchen Sie nach mehreren Kontakten aus Ihrer Datei
- Aktualisieren Sie die Seite „Kontakte”
- 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.
- 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
- 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.
- Verwenden Sie die CSV-Vorlage von CloudTalk
Wenn Ihr Import nie vorankommt oder immer an derselben Stelle hängen bleibt:
- Laden Sie die CSV-Vorlage von CloudTalk herunter
- Öffnen Sie sie in Google Sheets
- Kopieren Sie Ihre Daten in die Vorlage
- Exportieren Sie als CSV (UTF-8)
- Versuchen Sie den Import erneut
- 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, 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
- 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 – wir sind für Sie da.