Zum Hauptinhalt springen

Kontakte importieren

Importiere und aktualisiere Kontakte mit einer CSV-Datei – inklusive Vorbereitung deiner CSV, Upload über Desktop oder Mobilgerät und Aktualisierung von Kontaktfeldern.

T
Verfasst von Tobias Ignatzek
Vor über einer Woche aktualisiert

Bevor du startest

Bevor du die Datei hochlädst, erstelle alle notwendigen Kontaktattribute (z. B. Bestellnummer, Kundentyp) in Superchat, damit du die CSV-Datenfelder beim Import korrekt zuordnen kannst. Stelle außerdem sicher, dass deine CSV-Daten richtig formatiert sind. Alle Formatierungsrichtlinien findest du im FAQ-Bereich unten.

Wer kann Kontakte importieren?

Rolle

Berechtigung

Admin

Kann Kontaktimporte erstellen, historische Importe einsehen und löschen

Supervisor

Kann Kontaktimporte erstellen

Mitglied

Kann Kontaktimporte erstellen

Datenformatierung & Anforderungen

Wie muss das Format für Telefonnummern aussehen?

  • Telefonnummern müssen dem E.164-Format entsprechen, das das +-Zeichen und die Landesvorwahl enthält (z. B. +4915123456789).

Wie muss das Format für E-Mail-Adressen aussehen?

  • E-Mails müssen gültige E-Mail-Adressen sein (z. B. max.mustermann@gmail.com).

  • Falls eine E-Mail-Adresse ungültig ist, wird sie beim Import ignoriert und nicht zum Kontakt hinzugefügt.

Wie muss das Format für Datumsangaben und Datum + Uhrzeit aussehen?

  • Nur Datum: Verwende das Format JJJJ-MM-TT (z. B. 2025-07-22).

  • Datum + Uhrzeit: Verwende das Format JJJJ-MM-TT HH:MM:SSZ (z. B. 2025-07-22 10:15:00Z).

    • Hinweis: Das System erwartet die Uhrzeit in UTC. Wenn du von Deutschland aus auf Superchat zugreifst, wird ein Zeitstempel wie 2024-08-22 10:15:00Z (UTC) automatisch in 12:15 Ortszeit umgewandelt und angezeigt.

Wie muss das Format für Zahlen aussehen?

  • Es werden nur ganze Zahlen unterstützt (z. B. 1200).

  • Dezimalzahlen werden nicht unterstützt — wenn du 4,5 hochlädst, wird nur 4 importiert und alles nach dem Komma ignoriert.

  • Verwende keine Währungssymbole oder Tausendertrennzeichen (z. B. 1.200 € → 1200).

Wie muss das Format für Single- und Multi-Select-Attribute aussehen?

  • Single-Select: Der Wert muss exakt mit einer der vordefinierten Optionen übereinstimmen (z. B. VIP).

  • Multi-Select: Trenne die Optionen mit einem Komma (z. B. Option 1, Option 2, Option 3).


Kontakte am Desktop importieren

1. Gehe zum Kontakt-Hub.

2. Klicke auf Importieren.

3. Lade deine CSV-Datei mit den Kontakten hoch.

4. Überprüfe deinen Import in der Dateivorschau:

  • Wenn alles korrekt aussieht, klicke auf Weiter.

  • Falls es Probleme gibt, schau im Abschnitt zur Fehlerbehandlung am Ende dieses Artikels nach.

5. Bestätige, ob die erste Zeile eine Titel-/Kopfzeile ist.

  • Wähle Ja, wenn die erste Zeile Spaltennamen enthält (z. B. „Name“, „Telefonnummer“, „E-Mail“).

  • Wähle Nein, wenn die erste Zeile bereits tatsächliche Kontaktdaten enthält.

6. Ordne deine CSV-Spalten den Kontaktattributen zu, die du in Superchat erstellt hast, und klicke auf Weiter.

7. Optional: Füge die importierten Kontakte einer oder mehreren Kontaktlisten hinzu.

8. Schließe den Import ab. Der Upload kann einige Minuten dauern. Du erhältst eine E-Mail, sobald der Import abgeschlossen ist.


Kontakte am Mobilgerät importieren

In der mobilen App kannst du Superchat Zugriff auf die Kontakte deines Telefons gewähren und auswählen, ob du ausgewählte Kontakte oder alle Kontakte hochladen möchtest.

So importierst du Kontakte:

  1. Gehe zu Einstellungen in der Superchat-Mobil-App.

  2. Tippe auf Kontakte importieren.

  3. Erlaube der Superchat-App den Zugriff auf deine Telefonkontakte.

  4. Wähle aus, ob du alle Kontakte hochladen oder bestimmte Kontakte auswählen möchtest.

  5. Schließe den Import ab.

⚠️ Wichtig:

  • Dabei können private Kontakte enthalten sein, die du möglicherweise nicht teilen möchtest.

  • Alle importierten Kontakte sind für alle Nutzer in deinem Workspace sichtbar.


Fehlerbehebung & Fehler

Warum sieht meine CSV-Vorschau falsch aus (Spalten oder Zeichen sind verschoben)?

  • Das passiert meistens wegen der falschen Dateicodierung oder des falschen Trennzeichens.

Wie kannst du das Problem beheben?

  • Speichere deine CSV-Datei in UTF-8-Codierung.

  • Wähle das richtige Trennzeichen (Komma , oder Semikolon ;) in den Vorschau-Einstellungen.

Warum schlägt der Upload eines Kontakts fehl?

Häufige Gründe sind:

  • Der Kontaktdatensatz enthält keine gültige Telefonnummer oder E-Mail-Adresse (mindestens eines davon ist erforderlich, damit ein Kontakt importiert werden kann).

  • Doppelte Einträge basierend auf eindeutigen Identifikatoren (z. B. dieselbe E-Mail oder Telefonnummer).

  • Überschreiten der Datei- oder Feldgrößenlimits. Die Dateigrößenbeschränkung liegt bei 20 MB, und du kannst bis zu 10.000 Kontakte pro CSV-Datei importieren.

Warum sind einige Datenfelder für einen Kontakt leer, obwohl sie in der CSV-Datei angegeben wurden?

  • Wenn bestimmte Felder nach dem Import leer erscheinen, bedeutet das meistens, dass die Daten die Validierung nicht bestanden haben oder nicht im richtigen Format vorlagen.

  • In solchen Fällen importiert Superchat den ungültigen Wert nicht und lässt das Attribut für diesen Kontakt einfach leer (null).

  • Überprüfe die Formatierungsregeln oben (z. B. E.164-Telefonnummern, gültige E-Mail-Adressen, korrekte Datumsformate, exakte Übereinstimmungen für Auswahlattribute) und korrigiere deine CSV-Datei, bevor du sie erneut hochlädst.


FAQ

Wie viele Kontakte kann ich auf einmal hochladen?

  • Du kannst bis zu 10.000 Kontakte pro CSV-Datei hochladen.

  • Die maximale Dateigröße beträgt 20 MB.

  • Falls deine Datei eines dieser Limits überschreitet, teile sie in kleinere Dateien auf und lade sie separat hoch.

Kann ich mehrere E-Mail-Adressen oder Telefonnummern pro Kontakt hochladen?

Nein, aktuell unterstützt jeder Kontakt beim Import nur eine primäre E-Mail-Adresse und eine primäre Telefonnummer. Du kannst jedoch zusätzliche E-Mails und Telefonnummern manuell in der Kontaktseitenleiste im Unified Inbox oder Kontakt-Hub hinzufügen.

Was passiert mit bereits hochgeladenen Kontakten, wenn ich sie erneut importiere?

Wenn du einen Kontakt importierst, der bereits in Superchat existiert, wird er anhand der E-Mail-Adresse und/oder Telefonnummer abgeglichen und nach folgenden Regeln aktualisiert:

  • Wenn der bestehende Kontakt keinen Wert für ein Feld hat → wird der importierte Wert hinzugefügt.

  • Wenn der bestehende Kontakt einen anderen Wert hat → überschreibt der importierte Wert den alten.

  • Wenn der bestehende Kontakt bereits einen Wert hat und der Import keinen Wert enthält → ändern wir nichts (der bestehende Wert bleibt erhalten).

Wie kann ich Kontakte mithilfe des Kontaktimports aktualisieren?

Du kannst Kontakte per Massenupdate aktualisieren, indem du sie mit aktualisierten Daten erneut importierst.

  • Füge die E-Mail-Adresse oder Telefonnummer jedes Kontakts hinzu (zum Abgleichen).

  • Alle neuen oder geänderten Attribute werden automatisch nach diesen Regeln aktualisiert:

    • Fehlende Werte werden hinzugefügt,

    • unterschiedliche Werte überschreiben die alten,

    • leere Werte im Import entfernen keine bestehenden Daten.

Hat dies deine Frage beantwortet?