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

> Erstelle, bearbeite, führe zusammen und lösche die Personen und Unternehmen in deiner Audience

Ein Kontakt ist ein Datensatz für eine Person oder ein Unternehmen – gemeinsam genutzt über alle Anrufe, Nachrichten, E-Mail-Threads und Kampagnen, an denen er beteiligt ist. Audience führt eine einzige Kontaktliste für den gesamten Workspace; Kampagnen ziehen ihre Leads von dort, statt jeweils eine eigene Liste zu pflegen.

## Einen Kontakt erstellen

Wähle **New Lead** in Audience, um das Formular **New contact** zu öffnen. Ein Name ist optional; eine Telefonnummer oder eine E-Mail-Adresse ist erforderlich – eines von beiden allein reicht. Beide müssen im Workspace eindeutig sein: Gehört ein Wert bereits zu einem anderen Kontakt, markiert das Formular die Übereinstimmung und bietet an, diesen Kontakt zu öffnen oder das fehlende Detail dort zu ergänzen, statt ein Duplikat anzulegen.

Kontakte entstehen auch, ohne dass jemand dieses Formular ausfüllt: durch einen [CSV-Import](/de/audience/importing-contacts), beim ersten Anruf oder der ersten Nachricht an eine deiner Nummern, wenn ein Lead einer Kampagne hinzugefügt wird, sowie über die REST-API oder MCP.

## Einen Kontakt bearbeiten

Öffne einen Kontakt, um drei Tabs zu sehen:

* **Overview** – Segmente, letzter Kontakt, Call-QA-Durchschnitt (sofern [AI QA scorecards](/de/assistants/analysis#ai-qa-scorecards) aktiviert sind), persönliche Angaben, Custom Attributes und verknüpfte Kanalprofile.
* **Memory** – einwilligungsbewusstes [Kundengedächtnis](/de/assistants/memory) und über Kanäle hinweg gesammelte, verifizierte Identitäten.
* **Timeline** – jeder Anruf, jede Nachricht und jede E-Mail zu diesem Kontakt, mit einem Link zu [Verlauf](/de/monitoring/history) für den vollständigen Verlauf.

Die Aktionsleiste am unteren Rand des Drawers startet einen Anruf mit jedem aktiven Assistenten, öffnet eine E-Mail an den Kontakt und bietet unter **More actions** die Optionen **Manage** und **Delete**. **Manage Contact** bearbeitet den Datensatz über vier Tabs: **Info** (Name, Telefon, E-Mail, Foto), **Tags**, **Attributes** und **Channels**.

<Note>
  Tagging, Filtern und gespeicherte Segmente werden unter [Audience Call QA](/de/audience/call-qa) behandelt – diese Seite konzentriert sich auf den Kontaktdatensatz selbst.
</Note>

## Custom Attributes

Definiere Workspace-weite Felder unter **Settings → Workspace → Custom Attributes**: einen Namen, einen Typ und ob das Feld erforderlich ist. Die Typen sind **Text**, **Number**, **Boolean** (ein Ja/Nein-Feld), **Enum** (eine von dir definierte Liste an Auswahlmöglichkeiten) und **Date**. Der Key des Attributs wird aus dem Namen generiert – aus „Maiden Name“ wird `maiden_name` – und der Typ steht fest, sobald das Attribut existiert.

Ein Workspace kann bis zu 50 Attribute definieren, und ein Enum-Attribut kann bis zu 50 Auswahlmöglichkeiten bieten. Werte befinden sich im Tab **Attributes** eines Kontakts oder werden beim CSV-Import automatisch befüllt.

Ein Assistent aktiviert gezielt die Attribute, die er braucht: Hake im **Variables**-Panel des Assistenten das Attribut unter **Lead attributes** an, und sein Wert steht bei jedem Anruf mit diesem Kontakt als `{{key}}` zur Verfügung. Siehe [Custom Variables](/de/assistants/variables).

## Kontaktstatus

Jeder Kontakt trägt genau einen Status, der sich aus seiner jüngsten Kampagnenaktivität ergibt:

| Status            | Bedeutung                                                                                        |
| ----------------- | ------------------------------------------------------------------------------------------------ |
| Created           | Noch nicht angerufen                                                                             |
| Processing        | Gerade läuft ein Anruf                                                                           |
| Rescheduled       | Wartet auf den nächsten Versuch                                                                  |
| Max retries       | Wiederholungsbudget ohne Ergebnis aufgebraucht                                                   |
| Completed         | Erreicht, oder das Kampagnenziel wurde erreicht                                                  |
| DNC (Blacklisted) | Auf der [Sperrliste](/de/campaigns/dialer-and-compliance#nicht-anrufen-dnc) – wird nie angerufen |

Filtere Audience nach Status, um Kontakte in jedem dieser Zustände zu finden. Dieselben sechs Zustände steuern auch das Drag-and-drop-Board innerhalb einer Kampagne, wo die Spalten kampagnenspezifische Namen tragen – siehe [Eine laufende Kampagne überwachen](/de/campaigns/overview#eine-laufende-kampagne-überwachen).

## Doppelte Kontakte zusammenführen

Telefonnummern und E-Mail-Adressen sind pro Workspace eindeutig, daher lässt Famulor nie zu, dass ein zweiter Datensatz eine bereits bestehende Identität beansprucht:

* **Beim Erstellen** – wird ein einzelner Kontakt angelegt, dessen Telefonnummer oder E-Mail bereits jemand anderem gehört, führt das die neuen Tags zusammen und ergänzt fehlende Identitätsfelder bei diesem Kontakt, statt einen zweiten Datensatz zu erstellen. Das gilt für das Formular **New contact**, `POST /api/v1/leads` und das MCP-Tool `create_audience_contact`.
* **Beim Bearbeiten** – änderst du Telefon oder E-Mail eines Kontakts auf einen Wert, der bereits woanders verwendet wird, markiert der Info-Tab die Kollision und bietet **Merge into this contact** an. Beim Zusammenführen wandern Telefon, E-Mail, Kanalidentitäten, Anrufe und Konversationen zum Kontakt, den du behältst; der andere Datensatz wird entfernt.
* **Beim Import** – Massenimporte führen nie zusammen. Eine CSV-Zeile oder ein Kampagnen-Lead, deren Telefon oder E-Mail bereits vergeben ist, wird abgelehnt statt in den bestehenden Kontakt eingefügt – dedupliziere daher vor einem größeren Import gegen Audience. Siehe [Kontakte importieren](/de/audience/importing-contacts).

<Warning>
  Das Zusammenführen zweier bestehender Kontakte ist immer ein expliziter Schritt. Eine kollidierende Telefonnummer oder E-Mail bei einer einfachen Aktualisierung wird abgelehnt, nicht still zusammengeführt – du musst das Zusammenführen selbst bestätigen.
</Warning>

Dieselbe Operation steht auch als `POST /api/v1/leads/{id}/merge` oder als MCP-Tool `merge_audience_contacts` zur Verfügung.

## Einen Kontakt löschen

Lösche einen Kontakt über **More actions** in seinem Drawer. Das entfernt den Kontaktdatensatz dauerhaft und kann nicht rückgängig gemacht werden.

Einen Lead aus einer [Kampagne](/de/campaigns/overview) zu entfernen ist eine andere, nicht-destruktive Aktion: Der Lead verlässt die Warteschlange dieser Kampagne, während der Kontakt – mit seinen Anrufen, Konversationen und seinem Verlauf – in Audience erhalten bleibt.

## API & MCP

```bash theme={null}
GET  /api/v1/leads          # list contacts, with status/channel/tag/date filters
POST /api/v1/leads          # create a contact (or merge into a matching one)
POST /api/v1/leads/{id}/merge
```

MCP-Clients können `list_audience_contacts`, `create_audience_contact` und `merge_audience_contacts` für die Workspace-weite Kontaktliste nutzen. `get_lead`, `update_lead` und `delete_lead` wirken auf einen **Kampagnen**-Lead statt auf den Audience-Datensatz – und `delete_lead` entfernt den Lead nur aus seiner Kampagne; der Kontakt bleibt in Audience erhalten.