# Kontakte

> Kontakte sind die Personen in Ihrem Workspace. Erfahren Sie, wie Kontakte, Kontaktlisten und Abonnenten zusammenhängen, was die Seite Contacts und das Kontaktprofil zeigen und wie Opt-outs funktionieren.

Ein Kontakt ist eine Person in Ihrem Workspace, identifiziert durch ihre E-Mail-Adresse. Kontakte enthalten die Namen und Werte eigener Felder, mit denen Sie Kampagnen personalisieren, und sie treten Kontaktlisten bei, also den Listen, an die Kampagnen senden. Diese Seite erklärt, wie die Teile zusammenhängen und was Sie in der Weboberfläche und per API mit Kontakten tun können.

## Kontakte, Kontaktlisten und Abonnenten

Emailit trennt Personen und Listen. Eine Person existiert einmal als Kontakt, und jede Liste, auf der sie steht, ist ein eigener Abonnenten-Datensatz mit eigenem Opt-in-Status.

| | Kontakt | Kontaktliste | Abonnent |
| --- | --- | --- | --- |
| **Was es ist** | Eine Person | Eine benannte Liste, an die Sie Kampagnen senden | Die Mitgliedschaft eines Kontakts in einer Kontaktliste |
| **ID-Präfix** | `con_` | `aud_` | `sub_` |
| **Eindeutig nach** | E-Mail-Adresse, pro Workspace | Name, pro Workspace | Einer pro Kontakt und Kontaktliste |
| **Enthält** | E-Mail-Adresse, Vorname, Nachname, eigene Felder, Marketing-Status | Name, Anzahl der Abonnenten, Anmelde-URL | Ein Kennzeichen **Subscribed** mit An- und Abmeldedatum |
| **Beim Löschen** | Wird der Kontakt auch aus allen Kontaktlisten entfernt | Werden alle Abonnenten entfernt. Die Kontakte bleiben. | Wird diese Mitgliedschaft entfernt. Der Kontakt bleibt. |

```text
Workspace
├── Contacts ────────────── one per email address
│   ├── email, first_name, last_name, custom_fields
│   └── marketing status (unsubscribed: true | false)
└── Audiences ───────────── named lists, for example "Newsletter"
    └── Subscribers ─────── one per contact on the list
        └── subscribed: true | false
```

In der Praxis:

- Ein Kontakt kann Abonnent vieler Kontaktlisten sein, mit einem eigenen Kennzeichen **Subscribed** in jeder.
- Wenn Sie jemanden per E-Mail-Adresse zu einer Kontaktliste hinzufügen, wird zuerst der Kontakt angelegt, falls er noch nicht existiert.
- Namen und eigene Felder gehören zum Kontakt. Wenn Sie sie über eine Kontaktliste bearbeiten, ändert sich der Kontakt, und die Änderung erscheint überall.

### Wer eine Kampagne erhält

Eine Kampagne geht an jeden Kontakt, der alle drei Bedingungen erfüllt:

1. Der Kontakt ist Abonnent mindestens einer der Kontaktlisten der Kampagne, mit aktiviertem **Subscribed**.
2. Der Marketing-Status des Kontakts ist **Subscribed**.
3. Die Adresse steht nicht auf Ihrer [Sperrliste](/de/docs/suppressions/).

Ein Kontakt in mehreren der ausgewählten Kontaktlisten erhält nur ein Exemplar. Die vollständigen Regeln finden Sie unter [Kampagne erstellen](/de/docs/campaigns/create/).

## Marketing-Status

Jeder Kontakt hat außerdem einen workspaceweiten **Marketing status**: **Subscribed** oder **Unsubscribed** (das Feld `unsubscribed` in der API). Das ist ein globales Opt-out, das über dem Kennzeichen pro Kontaktliste steht.

| Was Sie ändern | Wie | Wirkung auf Kampagnen |
| --- | --- | --- |
| Marketing-Status | Massenaktion **Unsubscribe** oder **Resubscribe** auf der Seite Contacts oder `unsubscribed` in der API | Kontakte mit **Unsubscribed** werden in jeder Kontaktliste übersprungen. Ihre Mitgliedschaften in Kontaktlisten ändern sich nicht. |
| Eine Anmeldung bei einer Kontaktliste | **Unsubscribe** oder **Resubscribe** auf der Kontaktseite oder in der Kontaktliste oder `subscribed` beim Abonnenten | Der Kontakt wird nur bei Kampagnen an diese Kontaktliste übersprungen. |
| Der Empfänger klickt auf den Abmeldelink | Die gehostete Abmeldeseite | Der Kontakt wird von allen Kontaktlisten abgemeldet, denen er angehört. |

Marketing-Status und Anmeldungen bei Kontaktlisten steuern nur Kampagnen. Sie blockieren keine E-Mails, die Sie per API oder SMTP senden, und keine E-Mails von Automatisierungen. Um alle E-Mails an eine Adresse zu stoppen, fügen Sie sie Ihren [Sperrungen](/de/docs/suppressions/) hinzu. [Abmeldungen](/de/docs/audiences/unsubscribes/) behandelt jeden Weg zum Opt-out.

## Die Seite Contacts

Öffnen Sie **Email Marketing → Contacts**, um alle Kontakte im Workspace zu sehen, die neuesten zuerst.

- **Spalten.** **Email** wird immer angezeigt. Blenden Sie **First name**, **Last name**, **Audiences**, **Created** und **Updated** unter **Display options > Edit columns** ein oder aus, oder wählen Sie **Show full name**, um die Namen in einer Spalte **Name** zusammenzuführen. In der Spalte **Audiences** ist jedes Badge einer Kontaktliste grün, solange der Kontakt dort angemeldet ist, und rot, nachdem er sich abgemeldet hat.
- **Suche** findet Treffer in E-Mail-Adresse, Vorname und Nachname.
- **Filtern** Sie nach Email, Name, First name, Last name, Unsubscribed, Created, Updated, Audiences oder Audience sowie nach jedem [eigenen Feld](/de/docs/contacts/custom-fields/). Bei zwei oder mehr Filtern wählen Sie, ob alle oder nur einer zutreffen müssen.
- **Sortieren** Sie, indem Sie eine Spaltenüberschrift wählen.
- **Import** und **Export** übertragen Kontakte als Dateien. Siehe [Kontakte importieren und exportieren](/de/docs/contacts/import-export/).

Wählen Sie eine Zeile, um den Kontakt zu öffnen. Das Zeilenmenü enthält **Edit** und **Delete**.

### Kontakt hinzufügen

Wählen Sie **Add contact** und geben Sie **Email** sowie optional **First name**, **Last name** und **Audiences** ein. Wählen Sie **Show custom fields**, um Werte eigener Felder einzutragen. Eine E-Mail-Adresse kann pro Workspace nur einmal existieren. Das Hinzufügen einer bestehenden Adresse schlägt daher fehl.

Um einen Kontakt später zu ändern, wählen Sie **Edit**. Sie können die Namen und eigenen Felder ändern. Die E-Mail-Adresse lässt sich in der Weboberfläche nicht ändern. Verwenden Sie stattdessen das Feld `email` von [Kontakt aktualisieren](/de/docs/api-reference/contacts/update/).

### Massenaktionen

Wählen Sie Kontakte über die Checkboxen aus (die Checkbox in der Kopfzeile wählt die ganze Seite) und öffnen Sie dann **Actions**. Jede Aktion gilt für bis zu 100 Kontakte auf einmal.

| Aktion | Was passiert |
| --- | --- |
| **Add to audience** | Fügt die Kontakte zur gewählten Kontaktliste hinzu. Bestehende Mitgliedschaften bleiben, wie sie sind. Kontakte mit dem Marketing-Status **Unsubscribed** treten als abgemeldete Abonnenten bei. |
| **Remove from audience** | Löscht ihre Mitgliedschaft in der gewählten Kontaktliste. Die Kontakte bleiben. |
| **Unsubscribe** | Setzt ihren Marketing-Status auf **Unsubscribed**. |
| **Resubscribe** | Setzt ihren Marketing-Status wieder auf **Subscribed**. Anmeldungen bei Kontaktlisten ändern sich nicht. |
| **Delete** | Löscht die Kontakte und alle ihre Mitgliedschaften. Das lässt sich nicht rückgängig machen. |

## Die Kontaktseite

Die Kontaktseite zeigt alles, was Emailit über eine Person weiß. Oben finden Sie **Edit** und **Delete**.

| Bereich | Was er zeigt |
| --- | --- |
| **Details** | E-Mail-Adresse, Vorname, Nachname, Marketing-Status, Erstellungs- und Änderungsdatum. |
| **Custom fields** | Jedes im Workspace definierte eigene Feld und den Wert des Kontakts. |
| **Metrics and Insights** | **Emails sent**, **Loads**, **Clicks**, **Last activity**, **Subscribed audiences** (angemeldet von insgesamt) und **Marketing status**. Die Zahlen umfassen jede ausgehende E-Mail an die Adresse, nicht nur Kampagnen. |
| **Audiences** | Jede Kontaktliste, der der Kontakt angehört, mit Status sowie An- und Abmeldedatum. Über das Zeilenmenü können Sie den Kontakt für diese Kontaktliste mit **Unsubscribe** abmelden, mit **Resubscribe** erneut anmelden oder mit **Remove from audience** entfernen. **Add to audience** fügt eine neue Mitgliedschaft hinzu. |
| **Sent emails** | Ausgehende E-Mails an die Adresse mit Betreff, Status, Kampagne, Ladevorgängen, Klicks und Sendezeitpunkt. |
| **Activity log** | Eine Zeitleiste der Ereignisse zum Kontakt, etwa „Contact created“, „Added to Newsletter“, „Unsubscribed from Newsletter“ und „Email delivered“. |

## Per API nutzen

Die [API für Kontakte](/de/docs/api-reference/contacts/) deckt alles ab, was Liste und Profil können, außer dem Import von Dateien:

- Kontakte [erstellen](/de/docs/api-reference/contacts/create/), [abrufen](/de/docs/api-reference/contacts/get/), [aktualisieren](/de/docs/api-reference/contacts/update/), [auflisten](/de/docs/api-reference/contacts/list/) und [löschen](/de/docs/api-reference/contacts/delete/). Überall, wo eine ID erwartet wird, können Sie statt der `con_`-ID die E-Mail-Adresse des Kontakts übergeben.
- Übergeben Sie beim Erstellen eines Kontakts `audiences` (ein Array von `aud_`-IDs), um ihn sofort anzumelden. Beim Aktualisieren ersetzt `audiences` die Mitgliedschaften des Kontakts.
- [Massenaktion ausführen](/de/docs/api-reference/contacts/bulk/) für bis zu 100 Kontakte und bis zu 10.000 Kontakte als CSV oder XLSX [exportieren](/de/docs/api-reference/contacts/export/).

```bash
curl https://api.emailit.com/v2/contacts \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "ada@example.com",
    "first_name": "Ada",
    "last_name": "Lovelace",
    "custom_fields": { "company": "Acme", "plan": "pro" },
    "audiences": ["aud_2kq8Vt4xLm7Rz"]
  }'
```

Das Erstellen eines Kontakts mit einer bereits vorhandenen E-Mail-Adresse gibt `409` mit dem bestehenden Kontakt in `existing` zurück. Die API für Kontakte erfordert einen API-Schlüssel mit **Full Access**.

Änderungen an Kontakten erzeugen die Events [`contact.created`, `contact.updated` und `contact.deleted`](/de/docs/webhooks/events/contact/), Änderungen an Mitgliedschaften die Events [`subscriber.*`](/de/docs/webhooks/events/subscriber/). Beide können Sie per [Webhooks](/de/docs/webhooks/) empfangen.

## Nächste Schritte

  - [Eigene Felder](/de/docs/contacts/custom-fields/): Zusätzliche Daten bei Kontakten speichern und in Filtern und E-Mails verwenden.
  - [Import und Export](/de/docs/contacts/import-export/): Kontakte aus einer CSV- oder Excel-Datei übernehmen und herunterladen.
  - [Kontaktlisten](/de/docs/audiences/): Kontakte in Listen gruppieren, an die Sie Kampagnen senden.
  - [Abmeldungen](/de/docs/audiences/unsubscribes/): Wie Opt-outs funktionieren und wie Sie sie respektieren.

---
Quelle: https://emailit.com/de/docs/contacts/