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

# Kampagnen und Leads

> Führe Multi-Channel-Outreach über Lead-Listen durch

Eine Kampagne erreicht **Leads** über genau einen Hauptkanal: KI-Telefonanruf, freigegebenes WhatsApp-Template, WhatsApp Call (Beta) oder SMS. Voice-Kampagnen können nach endgültig erfolglosen Anrufversuchen genau ein optionales WhatsApp- oder SMS-Follow-up senden.

Bestehende Kampagnen bleiben Telefonkampagnen. API-Clients ohne `channel` erzeugen weiterhin `phone_call`.

## Leads und Zielgruppen

Leads sind die Personen, die eine Kampagne kontaktiert:

* **Importiere** Leads per CSV oder füge sie einzeln hinzu (UI, API oder MCP `add_lead`).
* Jeder Lead hat eine **Telefonnummer** (E.164), optional Name/E-Mail/Tags und frei definierbare **benutzerdefinierte Felder** (z. B. `company`, `open_amount`, `appointment_date`).
* Kampagnen-Mappings unterstützen Kontaktfelder, Custom Fields, Assistant-Variablen, kampagnenlokale Zeitwerte sowie schreibgeschützte System-/Kanalwerte wie `last_call_id`, `telegram_user_id` oder `whatsapp_user_id`.
* In den Kampagnen-Lead-Details sind Kontaktfelder und nutzerverwaltete Variablen editierbar; Laufzeit- und Kanalidentitäten werden separat schreibgeschützt angezeigt.
* Jede Haupt- und Follow-up-Aktion wird als Delivery-Versuch protokolliert.

## Kampagne einrichten

<Steps>
  <Step title="Kampagne erstellen">
    Wähle Call, WhatsApp, WhatsApp Call (Beta) oder SMS. Der Wizard zeigt nur benannte Ressourcen des aktuellen Workspaces.
  </Step>

  <Step title="Leads hinzufügen">
    Importiere deine CSV-Datei. Nummern auf deiner [Do-Not-Call-Liste](/campaigns/dialer-and-compliance#do-not-call-dnc) werden automatisch markiert.
  </Step>

  <Step title="Kampagneneinstellungen konfigurieren">
    Assistent oder Sender, freigegebenes Template und Mapping, Outreach-Fenster, Zeitzone, Retries und optionales Voice-Follow-up festlegen.
  </Step>

  <Step title="Start">
    Sofort starten oder Datum und Uhrzeit in der Kampagnen-Zeitzone planen. Pause stoppt neue Claims; laufende Calls und bereits akzeptierte Sends enden sauber.
  </Step>
</Steps>

## Laufende Kampagne überwachen

Die Kampagnenansicht zeigt Haupt- und Follow-up-Status, letzte/nächste Aktivität, erfolgreiche und fehlgeschlagene Deliveries sowie Voice-Dauer, wenn passend. WhatsApp-Call-Leads können sichtbar auf **Awaiting permission** warten.

Standardmäßig schließt sich die Kampagne automatisch ab, sobald keine Leads mehr übrig sind und alle Anrufe beendet wurden. Gesteuert wird das über die Einstellung **`mark_complete_when_no_leads`** (standardmäßig aktiv) – schalte sie **aus**, damit die Kampagne für einen fortlaufenden, automatisierten Lead-Import weiterläuft: So werden neu hinzugefügte Leads übernommen, statt dass sich die Kampagne selbst schließt.

## Ergebnisse

`GET/PATCH /api/v1/campaigns/{id}/leads/{leadId}` oder MCP `get_lead` / `update_lead` verwalten einen einzelnen Lead. `GET /api/v1/variables/catalog` und MCP `list_variable_sources` liefern gültige Mapping-Quellen. `GET /api/v1/campaigns/{id}/deliveries` und MCP `list_campaign_deliveries` liefern die kundensichere Delivery-Historie.