> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Kontakte importieren

> Bringe Kontakte per CSV-Datei in Audience, mit Spaltenzuordnung und Validierung

Der CSV-Import ist der schnellste Weg, viele Kontakte auf einmal hinzuzufügen – egal, ob du eine neue Liste startest oder Audience mit einem Tabellenexport auffüllst.

## Deine Datei vorbereiten

* **Nur CSV** (kein Excel), UTF-8-kodiert, bis zu 12 MB.
* Komma- oder semikolongetrennt – Famulor erkennt anhand der ersten Zeile, welches Format vorliegt, sodass europäische Tabellenexporte unverändert funktionieren.
* Eine Kopfzeile wird dringend empfohlen: Famulor liest sie, um offensichtliche Spalten vorab zuzuordnen. Eine Datei ohne Kopfzeile wird trotzdem importiert; die Spalten heißen dann einfach Column 1, Column 2 und so weiter.
* Jede Zeile braucht eine Telefonnummer. Alles andere – Name, E-Mail, Tags, Custom Fields – ist optional.

```csv theme={null}
phone,name,email,tags,company
+491701234567,Ada Lovelace,ada@example.com,vip;renewal,TechStart Solutions
+14155551234,Grace Hopper,grace@example.com,,Acme Corp
```

## Import-Schritte

Wähle **Import** in Audience. Der Wizard hat drei Schritte.

<Steps>
  <Step title="Datei hochladen">
    Zieh deine CSV-Datei hinein oder wähle sie von der Festplatte aus. Du wirst gebeten zu bestätigen, dass diese Kontakte einer Kontaktaufnahme zugestimmt haben und nicht aus einer gekauften Liste stammen – das liegt in deiner Verantwortung, Famulor prüft das nicht für dich.
  </Step>

  <Step title="Spalten zuordnen">
    Ordne jede Spalte einem Ziel zu: einem Kontaktfeld (**Phone**, **Name**, **Email**, **Tags**), einer Assistant-Variable (wenn du direkt in eine Kampagne mit zugewiesenem Assistenten importierst), einem Workspace-**Custom Attribute** oder einem frei definierten Custom Key. Eindeutige Treffer – eine Spalte, die wörtlich „phone“ oder „email“ heißt – sind bereits vorausgewählt; überprüfe und passe den Rest an und setze alles, was du nicht brauchst, auf **Ignore this column**.

    Dieser Schritt enthält außerdem zwei Einstellungen für den gesamten Batch. **Default country for phone numbers** wird an jede Nummer angehängt, die noch keine Ländervorwahl enthält (`01701234567` → `+491701234567`), sodass du deine Datei nicht vorher nach Land aufteilen musst. **Tags** fügt jedem Kontakt im Batch dieselben Tags hinzu.
  </Step>

  <Step title="Vorschau">
    Überprüfe die ersten fünf zugeordneten Kontakte, sieh dir die Zähler **Ready to import** und **Skipped (invalid phone)** an und bestätige.
  </Step>
</Steps>

## Wo importierte Kontakte landen

Ein Import aus **Audience** erstellt nicht zugewiesene Kontakte, die für jede Kampagne und jedes Segment im Workspace verfügbar sind. Derselbe **Import**-Button befindet sich auch auf der Seite einer einzelnen Kampagne – dort verwendet, fügt er die Kontakte direkt der Warteschlange dieser Kampagne hinzu, statt sie unzugewiesen zu lassen.

<Tip>
  Um bereits bestehende Audience-Kontakte einer Kampagne hinzuzufügen, statt sie erneut zu importieren, nutze **Assign leads** in der Kampagne – wähle ein gespeichertes Segment oder picke Kontakte manuell heraus. Siehe [Eine Kampagne einrichten](/de/campaigns/overview#eine-kampagne-einrichten).
</Tip>

## Referenz zur Spaltenzuordnung

| Ziel                     | Woher die Werte kommen                                                                                                                           |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| Phone, Name, Email, Tags | Eingebaute Kontaktfelder. Eine **Tags**-Spalte kann mehrere, durch Komma oder Semikolon getrennte Tags enthalten                                 |
| Assistant variable       | Wird nur angeboten, wenn du in eine Kampagne mit zugewiesenem Assistenten importierst                                                            |
| Custom attribute         | Workspace-definierte Felder unter **Settings → Workspace → Custom Attributes**                                                                   |
| Custom key               | Frei definierbar: Kleinbuchstaben, Ziffern und Unterstriche, beginnend mit einem Buchstaben. `phone`, `name`, `email` und `tags` sind reserviert |

## Deine Daten sauber halten

* Bevorzuge das E.164-Telefonformat (`+491701234567`) gegenüber lokalen Formaten (`0170 123 4567`, `(030) 123-4567`) – das beseitigt jede Unklarheit über das Land.
* Speichere die Datei als UTF-8-CSV. Exportierst du aus Excel, wandle Formeln in Werte um und vermeide verbundene Zellen vor dem Speichern.
* **Vor dem Import deduplizieren.** Telefonnummern und E-Mail-Adressen sind pro Workspace eindeutig, und ein Import führt nicht wie das Einzelkontakt-Formular automatisch zusammen – eine Zeile, deren Telefon oder E-Mail bereits zu einem Kontakt gehört, schlägt stattdessen fehl. Entferne solche Zeilen vorher aus der Datei, oder aktualisiere diese Kontakte einzeln in Audience.
* Gib jedem Import-Batch im Schritt **Spalten zuordnen** einen gemeinsamen Tag (z. B. `import-2026-08`), damit du diesen Batch später in Audience wiederfindest.

## Fehlerbehebung

| Symptom                                                  | Lösung                                                                                                                                                                                                                                    |
| -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Upload wird grundsätzlich abgelehnt                      | Die Datei muss `.csv`, UTF-8-kodiert und maximal 12 MB groß sein – Excel (`.xlsx`) wird nicht unterstützt; zuerst als CSV exportieren oder speichern                                                                                      |
| Keine Kontakte importiert                                | Stelle sicher, dass eine Spalte auf **Phone** gemappt ist – eine Zeile ohne gültige Telefonnummer wird immer übersprungen                                                                                                                 |
| Weniger Kontakte als Zeilen in der Datei                 | Sieh dir im Vorschau-Schritt den Zähler **Skipped (invalid phone)** an – bei diesen Zeilen konnte die Telefonnummer nicht geparst werden                                                                                                  |
| Der Import bricht mit einem Duplicate-Identity-Fehler ab | Telefon oder E-Mail einer Zeile gehören bereits zu einem anderen Kontakt in diesem Workspace. Entferne die doppelten Zeilen und importiere erneut – vor dem Abbruch bereits erstellte Kontakte bleiben bestehen                           |
| Falsche Ländervorwahl wurde hinzugefügt                  | Nur Nummern ohne Ländervorwahl erhalten die Standard-Vorwahl angehängt – stelle vor dem Bestätigen die richtige Standardeinstellung ein, oder ergänze diese Nummern in der Datei um `+<Ländervorwahl>`                                    |
| Ein Custom Key wird abgelehnt                            | Keys müssen aus Kleinbuchstaben, Ziffern und Unterstrichen bestehen und mit einem Buchstaben beginnen. `phone`, `name`, `email` und `tags` sind reserviert; benenne die Spalte um oder wähle stattdessen ein bestehendes Custom Attribute |

Siehe auch [Kontakte](/de/audience/contacts) zum Bearbeiten und Zusammenführen von Datensätzen nach dem Import sowie [Kampagnen-Übersicht](/de/campaigns/overview) zum Zuweisen von Kontakten für Outreach.