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

# Kontakte hinzufügen & Anrufe planen

> Füge Kontakte aus deinem CRM oder anderen Systemen zu telli hinzu und plane Anrufe mit ihnen

<iframe width="560" height="315" src="https://www.loom.com/embed/150c954c421a467585f80cb83e8b1500?sid=bc65de9a-a402-44c3-94f0-ed728bfa8b4c" frameborder="0" webkitallowfullscreen mozallowfullscreen allowfullscreen />

<br />

## Voraussetzungen

* Ein telli-Konto mit API-Zugang
* Ein API-Key aus deinem telli-Dashboard (Einstellungen > API & Webhooks)
* Ein CRM-System, eine Datenbank oder eine Automatisierungsplattform (Zapier, Make, n8n) mit zu synchronisierenden Kontakten
* Kontaktdaten bestehend aus: Vorname, Nachname und Telefonnummer (E-Mail und Zeitzone sind optional)

Du kannst Kontakte programmatisch über die API zu telli hinzufügen, um eine nahtlose Integration mit deinem CRM, deiner Datenbank oder anderen Systemen zu ermöglichen.

## Einzelnen Kontakt hinzufügen

Füge einen einzelnen Kontakt über den `/v1/add-contact`-Endpoint hinzu:

```json theme={null}
POST /v1/add-contact

{
  "external_contact_id": "crm-12345",
  "first_name": "John",
  "last_name": "Doe",
  "phone_number": "+14155552671",
  "email": "john.doe@example.com",
  "timezone": "America/New_York",
  "contact_details": {
    "company": "Acme Corp",
    "notes": "Interested in product demo"
  }
}
```

Siehe die [Add Contact Endpoint-Dokumentation](/de/v1/endpoint/add-contact) für vollständige Details.

## Mehrere Kontakte hinzufügen (Batch)

Füge mehrere Kontakte effizient über den `/v1/add-contacts-batch`-Endpoint hinzu:

```json theme={null}
POST /v1/add-contacts-batch

{
  "contacts": [
    {
      "external_contact_id": "crm-12345",
      "first_name": "John",
      "last_name": "Doe",
      "phone_number": "+14155552671",
      "email": "john.doe@example.com"
    },
    {
      "external_contact_id": "crm-12346",
      "first_name": "Jane",
      "last_name": "Smith",
      "phone_number": "+14155552672",
      "email": "jane.smith@example.com"
    }
  ]
}
```

Siehe die [Add Contacts (Batch) Endpoint-Dokumentation](/de/v1/endpoint/add-contacts-batch) für vollständige Details.

## Einzelnen Anruf planen

Nach dem Hinzufügen eines Kontakts kannst du einen Anruf mit der `contact_id` aus der Antwort planen. Verwende den `/v1/schedule-call`-Endpoint:

```json theme={null}
POST /v1/schedule-call

{
  "contact_id": "6bd1e7e0-6d00-4c0b-ad5b-daa72457a27d",
  "agent_id": "d8931604-92ad-45cf-9071-d9cd2afbad0c"
}
```

Siehe die [Schedule Call Endpoint-Dokumentation](/de/v1/endpoint/schedule-call) für vollständige Details.

## Mehrere Anrufe planen (Batch)

Plane Anrufe für mehrere Kontakte gleichzeitig über den `/v1/schedule-calls-batch`-Endpoint:

```json theme={null}
POST /v1/schedule-calls-batch

{
  "contacts": [
    {
      "contact_id": "6bd1e7e0-6d00-4c0b-ad5b-daa72457a27d",
      "agent_id": "d8931604-92ad-45cf-9071-d9cd2afbad0c"
    },
    {
      "contact_id": "7ce2e8f1-7e11-5d1c-be6c-ebb83568b38e",
      "agent_id": "d8931604-92ad-45cf-9071-d9cd2afbad0c"
    }
  ]
}
```

Siehe die [Schedule Calls (Batch) Endpoint-Dokumentation](/de/v1/endpoint/schedule-calls-batch) für vollständige Details.

## Best Practices

1. **Verwende external\_contact\_id**: Gib immer die Kontakt-ID deines CRMs an, um die Zuordnung beizubehalten
2. **Batch wenn möglich**: Nutze Batch-Endpoints für den Import mehrerer Kontakte und die Planung von Anrufen
3. **Fehler behandeln**: Prüfe die Antwort auf fehlgeschlagene Kontakte bei Batch-Operationen
4. **contact\_id speichern**: Speichere die zurückgegebene `contact_id`, um telli-Kontakte mit deinem System zu verknüpfen und Anrufe zu planen
5. **Nach dem Hinzufügen planen**: Plane nach dem Hinzufügen von Kontakten sofort Anrufe mit der zurückgegebenen `contact_id`, um deinen Workflow zu automatisieren