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

# Kontakte aus einer Datei in CloudTalk importieren

> Eine einfache Anleitung zum Importieren von Kontakten aus einer Excel-/CSV-Datei in CloudTalk

<Note>
  In diesem Artikel führen wir Sie durch das Hochladen einer Kontaktdatei in CloudTalk.
</Note>

**Benutzerebene**:

* Admin

***

<Warning>
  ⚠️ **Der Kontaktimport über CSV-Dateien kann einige Zeit dauern.** Für beste Ergebnisse empfehlen wir, zu Stoßzeiten zusätzliche Verarbeitungszeit einzuplanen.

  Wenn das Timing für Ihren Import entscheidend ist, ziehen Sie alternative Methoden in Betracht, etwa eine CRM-Integration oder die API von CloudTalk für eine Synchronisierung in Echtzeit.

  📘 **Mehr erfahren**: [Wie importiere ich Kontakte in CloudTalk?](/de/articles/2145547-how-to-import-contacts-into-cloudtalk)
</Warning>

<h2 id="data-preparation">
  Datenvorbereitung
</h2>

<Warning>
  **Maximal 8MB (in der Regel \~ 80k Kontakte)** werden unterstützt. Größere Dateien können nicht hochgeladen werden.
</Warning>

Für den Import von Kontakten aus einer Datei ist derzeit das Format **`.csv`** erforderlich. Es gibt verschiedene Programme, mit denen Sie Ihre Daten als CSV speichern können. Im häufigsten Fall, der Nutzung von Excel, gehen Sie zu **Datei > Speichern als**. Wählen Sie unter dem Feld *Dateiname* das Format **CSV** aus.

Es ist sehr wichtig, dass Sie Ihre CSV-Datei gemäß unserer **CSV-Dateivorlage** aufbauen. Um auf diese Vorlage zuzugreifen, navigieren Sie in Ihrem **[CloudTalk Dashboard](https://dashboard.cloudtalk.io/)**-Konto zu ***Kontakte*** *> **Liste** > **Massenkontaktimport*** und klicken Sie dann unten links auf **Vorlage herunterladen**. Beachten Sie, dass Sie nicht verwendete Spalten problemlos aus der Vorlage löschen können.Wenn Sie nur Basisangaben wie **Name**, **Telefonnummer** oder **E-Mail** importieren möchten, können Sie alle anderen Spalten ohne Weiteres entfernen.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/6Hiy83aLw1wFZVvu/images/help-center/articles/3422012/2dadc89fbf39-screenshot-2026-03-18-at-11-36-16.png?fit=max&auto=format&n=6Hiy83aLw1wFZVvu&q=85&s=7c677bcda4a98521e4afc2be17bbe2fe" alt="" width="1258" height="824" data-path="images/help-center/articles/3422012/2dadc89fbf39-screenshot-2026-03-18-at-11-36-16.png" />
</Frame>

<Info>
  #### Anforderungen an die CSV-Datei

  Es wird **dringend empfohlen**, die Vorlage herunterzuladen und sich daran zu halten. Achten Sie vor allem darauf:

  * Schreiben Sie alle Spaltennamen in **Kleinbuchstaben** (bei eigenen Attributen kann das abweichen)

  * **Vermeiden Sie Sonderschriftarten oder stilisierten Text** (z. B. Schreibschrift, kalligrafische oder dekorative Schriftarten) in Kontaktnamen oder anderen Feldern. Dadurch lässt sich Ihre Datei möglicherweise nicht korrekt hochladen.

  * Verwenden Sie im Dateinamen und im Inhalt ausschließlich **Standard-ASCII-Zeichen**. CSV-Importe können fehlschlagen, wenn Sonderzeichen oder Nicht-ASCII-Zeichen (z. B. ö, ü, ç) verwendet werden.

  * Erfassen Sie Werte für **`name`** und **`phone`** oder **`email`** bei **jedem Kontakt.**

  Werden diese Vorgaben nicht eingehalten, kann das zu fehlgeschlagenen Zeilen oder unvollständigen Importen führen.\
  Manche Probleme (etwa falsche Spaltenüberschriften oder eine falsche Dateistruktur) können verhindern, dass der Import überhaupt startet.
</Info>

<Warning>
  **Wichtig: Standard-Ländervorwahl**\
  Das in Ihren **Kontoeinstellungen** festgelegte Standardland bestimmt, welche internationale Vorwahl (`+`) automatisch auf hochgeladene Telefonnummern angewendet wird, die noch keine enthalten.

  Prüfen Sie vor dem Import Ihrer Datei noch einmal, ob das unter **Konto > Einstellungen > Standard-Ländervorwahl** ausgewählte Land dem Land der Telefonnummern in Ihrer CSV-Datei entspricht.

  Wenn das Standardland abweicht, werden Ihre Nummern möglicherweise mit der falschen internationalen Vorwahl importiert.
</Warning>

<h3 id="h_603d66a186">
  Beispielspalten in Ihrer Tabelle
</h3>

<table>
  <tbody>
    <tr>
      <td>
        **Spalte**
      </td>

      <td>
        **Beschreibung**
      </td>

      <td>
        **Beispiel**
      </td>
    </tr>

    <tr>
      <td>
        `name`
      </td>

      <td>
        Vor- und Nachname des Kontakts. Dieses Feld muss mindestens ein Zeichen enthalten.
      </td>

      <td>
        `Jane Smith`
      </td>
    </tr>

    <tr>
      <td>
        `phone`
      </td>

      <td>
        Telefonnummern können im internationalen Format (E.164) oder im lokalen Format angegeben werden. Enthält eine Nummer keine Ländervorwahl, wendet CloudTalk die Standard-Ländervorwahl aus Ihren Kontoeinstellungen an.

        Für beste Ergebnisse empfiehlt sich das E.164-Format. Sie können **mehrere Telefonnummern** angeben, getrennt durch einen Doppelpunkt (`:`).
      </td>

      <td>
        `+14155550123`

        `0908678545`

        `+14155550123:+12125550189`
      </td>
    </tr>

    <tr>
      <td>
        `email`
      </td>

      <td>
        Haupt-E-Mail-Adresse. Sie können in diesem Feld **mehrere E-Mail-Adressen** angeben, getrennt durch einen Doppelpunkt (`:`).
      </td>

      <td>
        [`jane.smith@company.com`](mailto:jane.smith@company.com)

        [`jane@company.com`](mailto:jane@company.com)`:j.smith@company.com`
      </td>
    </tr>

    <tr>
      <td>
        `email2`
      </td>

      <td>
        Zusätzliche E-Mail-Adresse. Dieses Feld bleibt aus Gründen der **Abwärtskompatibilität** mit dem ursprünglichen System erhalten.
      </td>

      <td>
        [`jane.alt@company.com`](mailto:jane.alt@company.com)
      </td>
    </tr>

    <tr>
      <td>
        `title`
      </td>

      <td>
        Position des Kontakts.
      </td>

      <td>
        `Head of Sales`
      </td>
    </tr>

    <tr>
      <td>
        `company`
      </td>

      <td>
        Name des Unternehmens, dem der Kontakt angehört.
      </td>

      <td>
        `Acme Corp`
      </td>
    </tr>

    <tr>
      <td>
        `address`
      </td>

      <td>
        Adresse des Kontakts.
      </td>

      <td>
        `Main Street 1, San Francisco`
      </td>
    </tr>

    <tr>
      <td>
        `favorite_agent`
      </td>

      <td>
        E-Mail-Adresse eines CloudTalk-Agenten, der dem Kontakt als bevorzugter Agent zugewiesen werden soll. Stimmt die E-Mail-Adresse mit einem vorhandenen Agenten überein, wird dieser zugewiesen. Wird keine Übereinstimmung gefunden, schlägt der Import dieser Zeile fehl.
      </td>

      <td>
        [`agent@company.com`](mailto:agent@company.com)
      </td>
    </tr>

    <tr>
      <td>
        `tag`
      </td>

      <td>
        Ein oder mehrere Tags, die dem Kontakt zugewiesen werden. Mehrere Tags müssen durch einen Doppelpunkt (`:`) getrennt werden. Vorhandene Tags werden wiederverwendet; neue Tags werden automatisch angelegt, wenn sie noch nicht existieren.
      </td>

      <td>
        `coldlead:webinar:priority`
      </td>
    </tr>

    <tr>
      <td>
        Eigene Attribute
      </td>

      <td>
        Beliebige zusätzliche Felder, die Sie importieren möchten. Diese müssen zuvor als eigene Attribute in den Kontoeinstellungen angelegt werden, und die Spaltennamen müssen exakt übereinstimmen.
      </td>

      <td>
        `industry` → `Gesundheitswesen`
      </td>
    </tr>
  </tbody>
</table>

<h4 id="h_fe7c42c7f4">
  Spalte „country" (unterstützte Formate)
</h4>

Wenn Ihre CSV-Datei eine Spalte `country` enthält, akzeptiert CloudTalk mehrere Länderformate, um den Import zu erleichtern.

Sie können verwenden:

* **Zweibuchstabige Ländercodes**, zum Beispiel: `US`, `GB`, `DE`

* **Dreibuchstabige Ländercodes**, zum Beispiel: `USA`, `FRA`, `DEU`

* **Vollständige Ländernamen auf Englisch**, zum Beispiel: `United States`, `Germany`, `France`

* **Gängige, eindeutige Varianten**, zum Beispiel: `United States of America`, `Great Britain`, `Trinidad & Tobago`

CloudTalk gleicht gängige Formatunterschiede automatisch an, darunter:

* Groß- und Kleinschreibung der Werte

* zusätzliche Leerzeichen vor, nach oder innerhalb des Werts

* die Verwendung von `&` statt `and` (und umgekehrt)

Kann der Länderwert nicht erkannt werden, schlägt die Zeile mit einer eindeutigen Fehlermeldung fehl, die auf einen ungültigen Länderwert hinweist.

<h4 id="h_202c0f0772">
  Eigene Attribute
</h4>

Damit die zusätzlichen Kontaktfelder aus Ihrer CSV-Datei bei den Kontakten korrekt angezeigt werden, müssen Sie diese als *[eigene Attribute](/de/articles/2144934-custom-attributes)* in Ihren Dashboard-Einstellungen anlegen.

1. Navigieren Sie im Dashboard zu **Konto > Einstellungen**.

2. Scrollen Sie auf der Registerkarte *Allgemeine Einstellungen* zum Abschnitt *Kontakte*.

3. Hier können Sie über `+ Eigenes Attribut hinzufügen` Ihre eigenen Feldnamen hinzufügen. Achten Sie darauf, dass die hier eingegebenen Namen in Schreibweise und Groß-/Kleinschreibung exakt den Namen in Ihrer CSV-Datei entsprechen.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/6Hiy83aLw1wFZVvu/images/help-center/articles/3422012/4850012ef211-screenshot-2024-12-13-at-16-49-46.png?fit=max&auto=format&n=6Hiy83aLw1wFZVvu&q=85&s=a015e03e061b2611efa613f935921644" alt="" width="2155" height="598" data-path="images/help-center/articles/3422012/4850012ef211-screenshot-2024-12-13-at-16-49-46.png" />
</Frame>

<h2 id="importing-contacts-from-a-file">
  Kontakte aus einer Datei importieren
</h2>

Sobald die CSV-Datei fertig ist und im richtigen Format gespeichert wurde, kann sie importiert werden.

1. Gehen Sie zu **Kontakte > Liste > Massenkontaktimport.**

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/6Hiy83aLw1wFZVvu/images/help-center/articles/3422012/f91509de118b-screenshot-2026-01-08-at-15-43-57.png?fit=max&auto=format&n=6Hiy83aLw1wFZVvu&q=85&s=0eec35d6d5fb6ceea39b5c54d7e61384" alt="" width="350" data-path="images/help-center/articles/3422012/f91509de118b-screenshot-2026-01-08-at-15-43-57.png" />
   </Frame>

2. Laden Sie die CSV-Datei hoch.

3. **Taggen Sie Ihre Kontakte**: Erstellen Sie ein Tag zur Kennzeichnung der Kontakte, die Sie importieren. Dieses Tag ist wichtig für die [Dialer-Kampagnen](/de/articles/8428838-setting-up-campaigns-legacy-dialer) und kann zum Filtern von Kontakten verwendet werden.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/6Hiy83aLw1wFZVvu/images/help-center/articles/3422012/1439c01d7f67-screenshot-2024-12-13-at-14-32-52.png?fit=max&auto=format&n=6Hiy83aLw1wFZVvu&q=85&s=5e302a417b9525143b19e4db27742204" alt="" width="330" data-path="images/help-center/articles/3422012/1439c01d7f67-screenshot-2024-12-13-at-14-32-52.png" />
   </Frame>

4. Wählen Sie `Bestätigen` aus, um den Import zu starten.

Nach dem Hochladen der Datei erscheint der Import unter **Kontakte > Importierte Dateien**, wo Sie den Fortschritt verfolgen und die Ergebnisse prüfen können.

<h3 id="h_8ecaab147c">
  Importierte Dateien
</h3>

CloudTalk führt einen übersichtlichen Verlauf aller CSV-Importe, damit Sie leicht nachvollziehen können, was passiert ist, Probleme erkennen und beheben, ohne den Support kontaktieren zu müssen.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/6Hiy83aLw1wFZVvu/images/help-center/articles/3422012/fb7aedb0243a-screenshot-2026-01-08-at-17-01-15.png?fit=max&auto=format&n=6Hiy83aLw1wFZVvu&q=85&s=3d5d8da94cc5adcf32045b1a36a8b883" alt="" width="2398" height="488" data-path="images/help-center/articles/3422012/fb7aedb0243a-screenshot-2026-01-08-at-17-01-15.png" />
</Frame>

Wenn Sie einen Importvorgang öffnen, zeigt CloudTalk eine detaillierte Aufschlüsselung, unter anderem:

* Gesamtzahl der Zeilen in der Datei

* Anzahl der erfolgreich importierten Kontakte

* Anzahl der fehlgeschlagenen Kontakte (falls vorhanden)

* Einen zeilenweisen Status mit eindeutigen Ergebnismeldungen. Zu jeder fehlgeschlagenen Zeile gibt es eine konkrete Begründung, warum der Kontakt nicht importiert werden konnte.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/6Hiy83aLw1wFZVvu/images/help-center/articles/3422012/661d3101fb1a-screenshot-2026-01-08-at-14-47-34.png?fit=max&auto=format&n=6Hiy83aLw1wFZVvu&q=85&s=83f8e6224f56f95c8f949e3db3f1e927" alt="" width="2852" height="1139" data-path="images/help-center/articles/3422012/661d3101fb1a-screenshot-2026-01-08-at-14-47-34.png" />
</Frame>

<h2 id="h_bb7f784856">
  Was passiert, wenn ein Import fehlschlägt
</h2>

<h3 id="h_3e4dc60c74">
  Globale Importfehler
</h3>

Schlägt der Import fehl, bevor Zeilen verarbeitet werden, sehen Sie eine globale Fehlermeldung mit der Ursache, zum Beispiel:

* Datei konnte nicht geladen werden

* Vorübergehende Dienststörung (behebt sich in der Regel nach kurzer Zeit von selbst. Wenn das Problem weiterhin besteht oder innerhalb weniger Stunden mehrfach auftritt, hilft Ihnen der [CloudTalk Support](mailto:support@cloudtalk.io) bei der weiteren Analyse)

* Dateigröße überschreitet 8 MB

<Frame>
  <img src="https://mintcdn.com/cloudtalk/6Hiy83aLw1wFZVvu/images/help-center/articles/3422012/fb6879d5840a-screenshot-2026-03-18-at-15-45-34.png?fit=max&auto=format&n=6Hiy83aLw1wFZVvu&q=85&s=b108cea23b1f53953bc1068920aacff3" alt="" width="500" data-path="images/help-center/articles/3422012/fb6879d5840a-screenshot-2026-03-18-at-15-45-34.png" />
</Frame>

<h3 id="h_21e352821e">
  Teilweise Importe
</h3>

CloudTalk weist nicht mehr die gesamte Datei wegen eines einzigen ungültigen Kontakts zurück.

* Gültige Kontakte werden erfolgreich importiert

* Ungültige Kontakte werden als **Fehlgeschlagen** markiert

* Ein Import mit diesem Ergebnis wird mit einem **orangefarbenen Status „Abgeschlossen"** angezeigt, was bedeutet, dass der Import beendet wurde, einige Zeilen aber fehlgeschlagen sind.

* Wenn zu viele Zeilen fehlschlagen (der Schwellenwert liegt bei **1000** fehlgeschlagenen Datensätzen), kann der Import gestoppt werden, um fehlerhafte Daten zu vermeiden.

Sie können den Fehlerbericht herunterladen, nur die fehlgeschlagenen Zeilen korrigieren und erneut hochladen.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/6Hiy83aLw1wFZVvu/images/help-center/articles/3422012/2b0125eb2640-screenshot-2026-01-08-at-15-10-53.png?fit=max&auto=format&n=6Hiy83aLw1wFZVvu&q=85&s=2ea927d02e569d430aa07eaecfcfe2a5" alt="" width="2416" height="1176" data-path="images/help-center/articles/3422012/2b0125eb2640-screenshot-2026-01-08-at-15-10-53.png" />
</Frame>

<h3 id="h_f4f028935e">
  So beheben Sie fehlgeschlagene Zeilen
</h3>

1. Öffnen Sie **Kontakte > Importierte Dateien**

2. Klicken Sie beim fehlgeschlagenen Import auf **Details anzeigen**

3. Prüfen Sie die Fehlerursache für jeden Kontakt

4. Laden Sie den Fehlerbericht herunter (falls verfügbar)

5. Korrigieren Sie nur die fehlgeschlagenen Zeilen in Ihrer CSV-Datei

6. Laden Sie die korrigierte Datei erneut hoch

<h3 id="h_9a3fafc70c">
  Liste der Fehler bei fehlgeschlagenen Zeilen & wie Sie sie beheben
</h3>

<table>
  <tbody>
    <tr>
      <td>
        **Fehlername**
      </td>

      <td>
        **Beschreibung**
      </td>

      <td>
        **Behebung**
      </td>
    </tr>

    <tr>
      <td>
        `The value X in column Y is not a valid phone number.`

        `[phone, columnIndex]`
      </td>

      <td>
        Die Nummer ist keine gültige lokale oder internationale Telefonnummer.
      </td>

      <td>
        Geben Sie eine gültige Telefonnummer im internationalen Format (z. B. `+14155550123`) oder im lokalen Format mit korrekt eingestelltem Standardland ein.
      </td>
    </tr>

    <tr>
      <td>
        `The value X in column Y is not a valid email address.`

        `[email, columnIndex]`
      </td>

      <td>
        Der angegebene Wert ist keine gültige E-Mail-Adresse.
      </td>

      <td>
        Geben Sie eine gültige E-Mail-Adresse ein (z. B. [firstName\_lastName@gmail.com](mailto:firstName_lastName@gmail.com))
      </td>
    </tr>

    <tr>
      <td>
        `The [columnName] value in column 1 is required.`
      </td>

      <td>
        Eine erforderliche Spalte fehlt oder ist leer.
      </td>

      <td>
        Prüfen Sie die Spaltenüberschriften auf zusätzliche Leerzeichen und stellen Sie sicher, dass die erforderlichen Spalten korrekt benannt und ausgefüllt sind.
      </td>
    </tr>

    <tr>
      <td>
        `The X value in column Y is required.`

        `[fieldName, columnIndex]`
      </td>

      <td>
        Sie versuchen, den Kontakt ohne Telefonnummer oder E-Mail-Adresse hochzuladen.

        Entweder **`phone`** oder **`email`** ist ein Pflichtfeld, damit CloudTalk diesen Kontakt importieren kann.
      </td>

      <td>
        Prüfen Sie den Kontakt und stellen Sie sicher, dass mindestens eine gültige Kennung (Telefonnummer im E.164-Format oder E-Mail-Adresse) angegeben ist.
      </td>
    </tr>

    <tr>
      <td>
        `The provided X value in column Y exceeds the maximum length of N characters.`

        `[fieldName, columnIndex, max]`
      </td>

      <td>
        Die maximal zulässige Zeichenanzahl für eine Spalte wurde überschritten.
      </td>

      <td>
        Kürzen Sie den Wert, sodass er das zulässige Zeichenlimit für dieses Feld einhält.
      </td>
    </tr>

    <tr>
      <td>
        `The provided X value in column Y must be at least N characters long.`

        `[fieldName, columnIndex, max]`
      </td>

      <td>
        Die angegebene Zeichenanzahl liegt unter der Mindestzeichenlänge.
      </td>

      <td>
        Die Spalte **`name`** muss mindestens 1 Zeichen enthalten. Dieses Feld ist erforderlich.

        Alle anderen Felder (z. B. **`company`**, **`website`**, **`title`**, **`industry`**, **`address`**, **`city`**, **`zip`** usw.) sind optional.

        Wenn ein optionales Feld leer bleibt, wird für dieses Feld kein Wert importiert.
      </td>
    </tr>

    <tr>
      <td>
        `The value X in column Y is not a valid website address.`

        `[columnName]`
      </td>

      <td>
        Der Wert in der Website-Spalte ist keine gültige Website-Adresse.
      </td>

      <td>
        Bitte prüfen Sie die Angabe und laden Sie eine gültige Website-Adresse erneut hoch.
      </td>
    </tr>

    <tr>
      <td>
        `The value X in column Y is invalid.`

        `[displayFieldName, columnIndex]`
      </td>

      <td>
        Dies ist ein allgemeiner Fehler. Der Wert in der Spalte ist ungültig.
      </td>

      <td>
        Prüfen Sie den Wert für diesen Kontakt und korrigieren Sie offensichtliche Fehler. Wenn Sie nicht sicher sind, wie Sie den Fehler beheben können, wenden Sie sich bitte an unser [Support-Team](mailto:support@cloudtalk.io).
      </td>
    </tr>
  </tbody>
</table>

<h4 id="h_fae39d618e">
  Maximale Zeichenlänge
</h4>

| Feld | Maximale Zeichenanzahl |
| - | - |
| `name` | 150 |
| `zip` | 15 |
| `title` | 255 |
| `company` | 100 |
| `industry` | 100 |
| `website` | 100 |
| `address` | 255 |
| `city` | 255 |

Überschreitet ein Wert die maximale Länge, reduzieren Sie die Zeichenanzahl und laden Sie die Datei erneut hoch.

Alle anderen Felder sind optional. Wenn ein optionales Feld leer bleibt, wird für dieses Feld kein Wert importiert.

<Warning>
  Wenn nach dem Korrigieren der fehlgeschlagenen Zeilen weiterhin Probleme auftreten oder Sie Hilfe bei anderen konkreten Importproblemen benötigen, sehen Sie sich diese Anleitungen zur Fehlerbehebung an:

  * **[CSV-Import hängt fest](/de/articles/12958920-csv-import-stuck)** – erklärt, warum ein Import lange im Status *Wird bearbeitet* bleiben kann, wann das normal ist und wann Sie handeln sollten.

  * **[Hochladen der CSV-Datei schlägt fehl](/de/articles/12930295-upload-of-csv-file-fails)** – geht gängige Formatierungs- und Strukturprobleme durch (etwa Zeichenkodierung, fehlende Spaltenüberschriften oder falsche Trennzeichen) und zeigt, wie Sie sie beheben.
</Warning>

***

*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

- [So importieren Sie Kontakte in CloudTalk](/de/articles/2145547-how-to-import-contacts-into-cloudtalk.md)
- [Pipedrive Deal Stage: Automatisierung mit Zapier](/de/articles/5724062-pipedrive-deal-stage-zapier-automation.md)
- [Upload einer CSV-Datei schlägt fehl](/de/articles/12930295-upload-of-csv-file-fails.md)


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