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

# Kontakte im Talkturo-CRM

> Kontakte speichern, durchsuchen und anreichern — mit Anrufhistorie, Lead-Status, eigenen Feldern und Firmenbezug.

Kontakte sind die Basis des CRM. Jeder Kontakt ist eine Person, die Ihr Assistent anrufen kann — mit Telefonnummer, optional E-Mail, Jobtitel, Lead-Status und Verknüpfung zu einem [Firmendatensatz](/de/crm/companies). Während Gesprächen reichert Talkturo Kontakte automatisch an, damit keine manuelle Pflege nötig ist.

## Inhalt eines Kontaktdatensatzes

<CardGroup cols={2}>
  <Card title="Identität" icon="user">
    Vorname, Nachname, Jobtitel, E-Mail, Haupttelefon, optional zweites Telefon.
  </Card>

  <Card title="Lead-Status" icon="chart-bar">
    Z. B. **New**, **Contacted**, **Qualified**, **Unqualified**, **Customer**, **Churned** oder **Do Not Contact**.
  </Card>

  <Card title="Firma" icon="building">
    Verknüpfung mit einem [Firmendatensatz](/de/crm/companies). Jeder Kontakt gehört zu genau einer Firma.
  </Card>

  <Card title="Eigene Felder" icon="sliders">
    Zusätzliche Felder Ihres Teams — oder automatisch durch den [KI-Info-Extraktor](/de/crm/info-extraction) aus Transkripten.
  </Card>
</CardGroup>

Weitere Felder u. a.: Quelle (wie der Kontakt ins CRM kam), Zeitzone, bevorzugter Kontaktweg, Do-not-call, Tags, Freitextnotizen.

## Kontakte hinzufügen

Einzeln über das Dashboard oder per CSV-Import in Masse.

### Manuell anlegen

<Steps>
  <Step title="Seite Contacts">
    In der Seitenleiste **Contacts** öffnen.
  </Step>

  <Step title="Add Contact">
    Oben rechts **Add Contact**.
  </Step>

  <Step title="Daten eintragen">
    Vor- und Nachname sind Pflicht; eine Firma muss gewählt werden — [Firma zuerst anlegen](/de/crm/companies), falls noch nicht vorhanden.

    Optional: E-Mail, Mobilnummer, Jobtitel, Lead-Status, Quelle, eigene Felder.
  </Step>

  <Step title="Speichern">
    **Create Contact** — der Kontakt erscheint sofort in der Tabelle.
  </Step>
</Steps>

<Note>
  Ohne mindestens eine Firma kein Kontakt — die Zuordnung ist Pflicht.
</Note>

### CSV-Import

<Steps>
  <Step title="CSV vorbereiten">
    Mindestens Spalten **First Name**, **Last Name**, **Company Name**. Optional u. a. E-Mail, Telefon, Jobtitel, Lead-Status, Quelle, Zeitzone, Tags, Firmendaten (Website, Branche, Stadt, Land …).

    Beispiel:

    ```csv theme={null}
    first_name,last_name,email,phone,job_title,lead_status,company_name,company_industry,company_city
    Jane,Smith,jane@acme.com,+12025550100,CEO,qualified,Acme Corp,Technology,San Francisco
    John,Doe,john@widgets.com,+12025550101,Sales Manager,new,Widgets Inc,Retail,New York
    ```
  </Step>

  <Step title="Import CSV">
    Auf der Contacts-Seite **Import CSV** (oben rechts).
  </Step>

  <Step title="Hochladen und zuordnen">
    `.csv` hochladen. Talkturo mappt gängige Spaltennamen (`first_name`, `email`, `company_name` …) automatisch — Zuordnung prüfen.

    **Import and update company fields** aktivieren, wenn Firmendaten mitgeschrieben werden sollen.
  </Step>

  <Step title="Import starten">
    **Start Import** — Erfolgszahl und Fehlerzeilen mit Meldungen werden angezeigt.
  </Step>
</Steps>

<Tip>
  Unbekannte Firmen aus der CSV legt Talkturo optional automatisch an. **Automatically create companies** in Schritt 3 deaktivieren, wenn unbekannte Firmen übersprungen werden sollen.
</Tip>

## Anrufhistorie

Zeile in der Kontaktliste anklicken — Detailpanel mit allen Anrufen zu/von diesem Kontakt, Zeitstempeln, Aufnahmen und KI-Zusammenfassungen. Aktualisiert sich nach jedem abgeschlossenen Anruf.

## Eigene Felder (Custom fields)

Frei definierbare Felder mit Typen:

| Typ      | Beispiel                     |
| -------- | ---------------------------- |
| Text     | Produktinteresse, Quelle     |
| Number   | Dealvolumen, Mitarbeiterzahl |
| Date     | Letzte Demo, Vertragsende    |
| Boolean  | Newsletter-Opt-in            |
| Select   | Sprache, Region              |
| Textarea | Notizen                      |

Verwaltung der Felddefinitionen in den Kontoeinstellungen. Der [KI-Info-Extraktor](/de/crm/info-extraction) kann fehlende Felder auch automatisch anlegen.

<Note>
  Automatisch angelegte Felder sind standardmäßig vom Typ **text** — Typ später in den Einstellungen änderbar.
</Note>

## API

REST-API zum Anlegen und Auflisten; Bearer-Token erforderlich.

### Kontakt anlegen

```bash theme={null}
POST /api/crm/contacts
```

```json theme={null}
{
  "teamId": "your-team-id",
  "companyId": "company-uuid",
  "firstName": "Jane",
  "lastName": "Smith",
  "email": "jane@acme.com",
  "phone": "+12025550100",
  "jobTitle": "CEO",
  "leadStatus": "qualified",
  "source": "import",
  "customFields": {
    "product_interest": "Enterprise Plan"
  }
}
```

**Pflicht:** `teamId`, `companyId`, `firstName`, `lastName`

### Kontakte listen

```bash theme={null}
GET /api/crm/contacts?teamId=your-team-id&limit=50&offset=0
```

**Query-Parameter:**

| Parameter    | Typ              | Beschreibung                    |
| ------------ | ---------------- | ------------------------------- |
| `teamId`     | string           | Pflicht. Team-ID.               |
| `search`     | string           | Suche in Name, E-Mail, Telefon. |
| `leadStatus` | string           | Filter nach Lead-Status.        |
| `companyId`  | string           | Filter nach Firma.              |
| `hasPhone`   | `true` / `false` | Nur mit Telefonnummer.          |
| `doNotCall`  | `true` / `false` | Filter Do-not-call.             |
| `limit`      | integer          | Pro Seite, Standard 50.         |
| `offset`     | integer          | Pagination, Standard 0.         |

**Antwort:**

```json theme={null}
{
  "success": true,
  "contacts": [...],
  "count": 120,
  "limit": 50,
  "offset": 0
}
```

## Siehe auch

* [Unternehmen im CRM](/de/crm/companies)
* [KI-Infoextraktion](/de/crm/info-extraction)