> ## 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.
# Dialer, Wiederholungsversuche & Compliance
> Paralleles Wählen, Wiederholungslogik, Anruffenster, DNC-Listen und Voicemail-Verarbeitung
Der Dialer läuft **serverseitig** – du musst kein Browser-Tab offen lassen. Er tickt kontinuierlich, gleicht abgeschlossene Anrufe ab und startet neue nach deinen Regeln.
## Paralleles Wählen (Parallelität)
* Lege pro Kampagne eine **Parallelität** fest: wie viele Anrufe gleichzeitig laufen.
* Das tatsächliche Limit ist der *niedrigere* Wert aus der Kampagnen-Einstellung und dem `max_parallel_calls` deines Plans.
* Hängengebliebene Anrufe (die im Klingeln feststecken) werden automatisch erkannt und freigegeben – so gehen nie Slots verloren.
## Wiederholungslogik
Nicht erreichte Leads werden automatisch erneut angerufen:
* **Maximale Versuche** (`retry_max`) pro Lead (z. B. 3).
* **Verzögerung zwischen Versuchen** (z. B. 120 Minuten) – der nächste Versuch landet zu einer *anderen Tageszeit*, was die Erreichbarkeit messbar verbessert.
* Ein Lead, der abhebt, wird nicht mehr erneut angerufen; bei den Ergebnissen `busy`, `no answer` und `failed` wird der nächste Versuch eingeplant, bis das Budget aufgebraucht ist.
* Der komplette Versuchsverlauf ist pro Lead einsehbar.
`retry_max` ist die harte Obergrenze für **jede** Wiederholungsregel weiter unten. Die Voicemail- und Ziel-Optionen erzeugen keine Endlosschleifen – sobald die zusätzlichen Versuche aufgebraucht sind, wird der Lead mit einem finalen Status (`failed` / `no_answer`) abgeschlossen.
### Erneut versuchen, bis ein Mensch abhebt
Aktiviere **`retry_on_voicemail`** (standardmäßig aus), damit *so lange weiter angerufen wird, bis ein Mensch abhebt (Voicemails werden übersprungen)*. Ist die Option aktiv, zählt ein Anruf, dessen [AMD-Ergebnis](#amd--voicemail) einer Maschinen-Kategorie entspricht (`machine-vm`, `machine-ivr`, `machine-unavailable`), **nicht** als erreicht – der Lead wird stattdessen für einen weiteren Versuch neu eingeplant, statt als erledigt markiert zu werden, bis maximal `retry_max`. Erst ein `human`-Ergebnis (oder ein aufgebrauchtes Wiederholungsbudget) schließt den Lead endgültig ab.
Das ist eine Wiederholungsregel. Was der Assistent tatsächlich tut, wenn er auf eine Maschine trifft – lautlos auflegen oder eine Nachricht hinterlassen – wird beim **Assistenten** konfiguriert (Einstellungen → Konversation → Voicemail), nicht in der Kampagne.
### Erneut versuchen, bis das Ziel erreicht ist
Zwei Einstellungen sorgen gemeinsam dafür, dass ein Lead so lange angerufen wird, bis ein definiertes Ergebnis erreicht ist:
* **`retry_until_goal`** (Boolean, standardmäßig aus) – *So lange weiter anrufen, bis das Ziel erreicht ist.* Ein Lead wird nur dann als `completed` markiert, wenn seine Zielvariable beim abgeschlossenen Anruf auf `true` steht; andernfalls plant der Dialer einen weiteren Versuch ein (begrenzt durch `retry_max`).
* **`goal_variable`** (Text) – *Variable, die `true` sein muss, damit ein Lead als abgeschlossen gilt.* Der Name eines booleschen Post-Call-Auswertungsfelds. Die Auswahl kommt aus den Post-Call-Analysefeldern des Kampagnen-Assistenten (den `boolean`-Feldern in dessen Analyse-Konfiguration) sowie dem eingebauten **`success`**-Flag. Der Dialer liest den Wert aus den Analysedaten des abgeschlossenen Anrufs (oder aus dem `success`-Flag des Anrufs, wenn die Variable `success` heißt).
Ist `retry_until_goal` aktiviert, wird die Zielvariable aber nie `true`, wird der Lead so lange erneut angerufen, bis `retry_max` erreicht ist, und dann mit einem finalen Status abgeschlossen – die Ziel-Regel setzt die Wiederholungs-Obergrenze niemals außer Kraft.
## Anruffenster
Lege pro Wochentag in der **Zeitzone** der Kampagne fest, **wann die Kampagne anrufen darf** – z. B. Mo–Fr 09:30–18:00 Uhr. Außerhalb des Fensters pausiert der Dialer und läuft danach automatisch weiter.
In Deutschland verstoßen unerwünschte Anrufe außerhalb angemessener Zeiten gegen das UWG. Anruffenster sind mehr als nur eine nette Geste – richte sie für jede Kampagne ein, die Verbraucher anruft.
## Nicht anrufen (DNC)
Eine zentrale Suppressions-Liste pro Workspace blockiert abgemeldete Kontakte
vor proaktiver Marketing-Kommunikation:
* Im **universellen Modus** blockiert ein Opt-out über einen Kanal alle
verknüpften Kanäle.
* Im **kanalbezogenen Modus** wird nur der Ursprungskanal gesperrt.
* Telefon, E-Mail, Kontaktidentität, Scope, Quelle, Grund und der beim Opt-out
aktive Modus bleiben für den Audit-Nachweis erhalten.
* Der Kampagnen-Dialer prüft die aktive Voice-Suppression unmittelbar vor dem
Dispatch und blockiert bei nicht verifizierbarem Consent-Status.
Modus und Einträge werden unter **Einstellungen → Daten → Suppression**
verwaltet. [Einwilligung & Compliance](/de/settings/consent-compliance)
beschreibt das kanalübergreifende Verhalten, die Wiederherstellung, REST-
Beispiele und MCP-Tools.
* `GET /api/v1/suppression-list` – aktive Einträge auflisten
* `POST /api/v1/suppression-list` – ein Opt-out erfassen
* `DELETE /api/v1/suppression-list/{id}` – Consent wiederherstellen, ohne den
Audit-Verlauf zu löschen
Dieselben Operationen stehen auch über MCP zur Verfügung.
## AMD & Voicemail
**Anrufbeantworter-Erkennung** klassifiziert, wer abgehoben hat, in eine von fünf Kategorien:
| AMD-Ergebnis | Bedeutung |
| --------------------- | -------------------------------------------------------------------------------------------- |
| `human` | Eine Person hat abgehoben – das Gespräch läuft normal weiter |
| `uncertain` | Konnte nicht klassifiziert werden – wird wie ein Mensch behandelt, das Gespräch läuft weiter |
| `machine-vm` | Voicemail / Anrufbeantworter |
| `machine-ivr` | Ein IVR-/Telefonmenü-System |
| `machine-unavailable` | Nummer nicht erreichbar / Ansage des Netzbetreibers |
Was der Assistent bei einer Maschine *tut* – lautlos auflegen oder nach dem Signalton eine Nachricht hinterlassen – wird beim **Assistenten** konfiguriert (Einstellungen → Konversation → Voicemail), nicht in der Kampagne.
Das AMD-Ergebnis wird am Anruf gespeichert und fließt in den Lead-Status ein, sodass die Wiederholungslogik zwischen „Mailbox" und „nie abgehoben" unterscheiden kann. Aktiviere [`retry_on_voicemail`](#retry-until-a-human-answers), um so lange weiter anzurufen, bis ein Mensch (statt einer `machine-*`-Kategorie) abhebt.
Voicemail-Nachricht + Wiederholung zu einer anderen Uhrzeit ist die Kombination mit dem höchsten ROI für Kaltakquise: Die Mailbox-Nachricht bereitet den Lead vor, der erneute Versuch erreicht ihn live. Kombiniere die Voicemail-Nachricht des Assistenten mit dem `retry_on_voicemail`-Schalter der Kampagne.