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

# Dialer, Wiederholungen & Compliance

> Paralleles Wählen, Wiederholungslogik, Anruffenster, DNC-Listen und Voicemail-Verarbeitung

Der Dialer läuft weiter, auch nachdem du den Browser geschlossen hast, und
tätigt Anrufe innerhalb deiner Kampagnenregeln.

## Paralleles Wählen (Parallelität)

* Lege pro Kampagne mit **Parallel calls (concurrency)** fest, wie viele
  Anrufe gleichzeitig laufen – ein Regler von 1 bis 10.
* Das tatsächliche Limit ist der niedrigere Wert aus Kampagneneinstellung und
  dem Parallel-Anruf-Kontingent deines Plans; höhere Werte werden
  serverseitig gedeckelt. Dieses Plan-Kontingent ist eine einzige,
  Workspace-weite Obergrenze, die sich jede aktive Assistenten-Session teilt
  – eingehende und ausgehende Anrufe, Web-Anrufe, WhatsApp Voice und
  Web-Chat – statt eines Budgets pro Kampagne oder Kanal.
* **Concurrent Lines** ist ein kostenpflichtiges, gestaffeltes Add-on, das du
  unter **Settings → Plan** kaufst, für Workspaces, die mehr gleichzeitige
  Kapazität brauchen, als der Plan enthält. Jede gekaufte Leitung erhöht die
  Workspace-Obergrenze um eins.
* Anrufe, die nie verbinden, werden automatisch freigegeben, damit sie
  keinen Slot dauerhaft blockieren.

<Note>
  Das ist ein anderes Limit als die [tägliche Obergrenze für ausgehende Anrufe](/de/telephony/outbound-limits): Parallelität steuert, wie viele Anrufe gleichzeitig laufen, die Tagesobergrenze steuert, wie viele Anrufe insgesamt an einem Tag gestartet werden dürfen.
</Note>

## Wiederholungslogik

Nicht erreichte Leads werden automatisch erneut angerufen:

* **Max. retries** zählt *zusätzliche* Versuche nach dem ersten Anruf. Der
  Standardwert ist 2, ein Lead wird also bis zu dreimal angerufen.
* **Retry delay (min)** ist die Wartezeit bis zum nächsten Versuch (Standard
  60\) – die Wiederholung landet zu einer *anderen Tageszeit*, was die
  Erreichbarkeit messbar verbessert.
* Ein Lead, das 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 vollständige Versuchsverlauf ist pro Lead einsehbar.

**Max. retries** ist die harte Obergrenze für jede der folgenden
Wiederholungsregeln. Die Voicemail- und Ziel-Optionen können keine
Endlosschleifen erzeugen; sobald die Versuche aufgebraucht sind, erhält der
Lead sein endgültiges Ergebnis.

### Erneut versuchen, bis ein Mensch abhebt

Aktiviere **Retry on voicemail** („Continue calling until a human answers“),
um weiter zu versuchen, wenn die Anrufbeantworter-Erkennung Voicemail, ein
IVR oder eine Nichterreichbarkeitsansage meldet. Ein menschliches Abheben
oder ein aufgebrauchtes Wiederholungskontingent schließt den Lead ab.

Das ist eine Wiederholungs-*Regel*. Was der Assistent tatsächlich tut, wenn
er auf eine Maschine trifft, ist eine separate, assistentenspezifische
Einstellung – siehe [AMD & Voicemail](#amd--voicemail) weiter unten.

### 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 completed** („Continue calling until the goal is
  achieved“) – markiert einen Lead nur dann als abgeschlossen, wenn das
  gewählte Ziel als wahr ausgewertet wird; andernfalls wird innerhalb des
  Maximums ein weiterer Versuch eingeplant.
* **Goal variable** – wähle eines der Ja/Nein-Felder aus der
  Post-Call-Auswertung des Assistenten oder das eingebaute Ergebnis **Call
  successful**. Ist die Liste leer, ergänze zuerst ein boolesches Feld im
  [Analysis](/de/assistants/analysis)-Tab des Assistenten.

Wird das Ziel nie erreicht, wird der Lead nur bis zum Erreichen von **Max.
retries** erneut angerufen.

## Anruffenster

Lege pro Wochentag in der **timezone** der Kampagne fest, **wann die
Kampagne wählen darf** – z. B. Mo–Fr 09:30–18:00 Uhr. Außerhalb des Fensters
pausiert der Dialer und läuft danach automatisch weiter.

<Note>
  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.
</Note>

## Nicht anrufen (DNC)

Eine zentrale Suppressions-Liste pro Workspace blockiert abgemeldete
Kontakte hart, bevor proaktive Marketing-Kommunikation stattfindet:

* **Universal mode** blockiert nach einem Opt-out über einen Kanal alle
  verknüpften Kanäle.
* **Per-channel mode** blockiert nur den Kanal, über den das Opt-out einging.
* 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, wenn sich der Consent-Status nicht
  verifizieren lässt.

Modus und Einträge werden unter **Settings → Data → Suppression** verwaltet.
[Consent & compliance](/de/settings/consent-compliance) beschreibt das
kanalübergreifende Verhalten, die Wiederherstellungslogik, 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

Aktiviere **Answering machine detection (AMD)** in den
Kampagneneinstellungen, um eine Maschine zu erkennen, bevor der Assistent
spricht, und wähle **Conservative** (weniger fälschliche Auflöser) oder
**Aggressive** (schnellere Erkennung bei höherem Volumen). AMD ordnet die
abhebende Stelle einer von fünf Kategorien zu:

| 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 eine
konfigurierte Nachricht abspielen und danach auflegen – ist ein einzelner
Schalter beim **Assistenten**, nicht bei der Kampagne: [Settings →
Conversation → Voicemail](/de/assistants/conversation-quality#voicemail). Bleibt diese
Nachricht leer, spielt stattdessen die normale Begrüßung des Assistenten.

Das AMD-Ergebnis erscheint beim Anruf und hilft der Wiederholungslogik, eine
Mailbox von einem unbeantworteten Anruf zu unterscheiden. Aktiviere bei
Bedarf [Retry on voicemail](#erneut-versuchen-bis-ein-mensch-abhebt).

<Tip>
  Eine Voicemail-Nachricht gefolgt von einem erneuten Versuch zu einer anderen
  Uhrzeit kann die Erreichbarkeit verbessern. Kombiniere die
  Voicemail-Nachricht des Assistenten mit **Retry on voicemail**.
</Tip>

Zusammengenommen durchläuft ein Anrufversuch für einen Lead diesen Ablauf:

```mermaid theme={null}
%%{init: {'flowchart': {'defaultRenderer': 'elk'}}}%%
flowchart TD
    Dial["Lead anrufen — Versuch N"] --> Outcome{"Ergebnis des Anrufs"}
    Outcome -->|"AMD: human oder uncertain"| Talk["Gespräch läuft normal weiter"]
    Outcome -->|"AMD: machine-vm / machine-ivr / machine-unavailable"| VM{"Hat der Assistent eine<br/>Voicemail-Nachricht hinterlassen?"}
    Outcome -->|"busy / no answer / failed"| Budget{"Innerhalb von Max. retries noch Versuche übrig?"}
    Talk --> GoalToggle{"Retry until goal completed aktiviert?"}
    VM -->|"Nein — aufgelegt"| Budget
    VM -->|"Ja"| VMToggle{"Retry on voicemail aktiviert?"}
    VMToggle -->|"Ja"| Budget
    VMToggle -->|"Nein"| GoalToggle
    GoalToggle -->|"Nein"| Done["Lead als abgeschlossen markiert —<br/>keine weiteren Versuche"]
    GoalToggle -->|"Ja"| GoalCheck{"Goal variable wahr?"}
    GoalCheck -->|"Ja"| Done
    GoalCheck -->|"Nein"| Budget
    Budget -->|"Ja"| Next["Nächsten Versuch nach Retry delay einplanen"]
    Next --> Dial
    Budget -->|"Nein"| Final["Lead erhält sein endgültiges Ergebnis —<br/>Wiederholungen aufgebraucht"]
```

## Fehlerbehebung

### Kampagne startet nicht

| Meldung                                                   | Ursache                                                     | Lösung                                                                                                 |
| --------------------------------------------------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| "The campaign has no assistant assigned."                 | Für diese Kampagne ist kein Assistent ausgewählt            | Weise der Kampagne in ihren Einstellungen einen Assistenten zu                                         |
| "The campaign has no leads."                              | Die Lead-Warteschlange ist leer                             | [Leads importieren](/de/audience/importing-contacts) oder Kontakte aus Audience zuweisen               |
| "Archived campaigns cannot be started. Restore it first." | Die Kampagne wurde archiviert                               | Kampagne wiederherstellen und dann starten                                                             |
| "This campaign is blocked by your current plan limit. …"  | Du hast das Kampagnen-Kontingent deines Plans überschritten | Plan upgraden oder eine andere Kampagne archivieren                                                    |
| "Campaign is already running."                            | Die Kampagne wählt bereits                                  | Nichts zu tun – um Einstellungen zu ändern, zuerst **Stop** wählen und die Kampagne danach neu starten |

Eine geplante Kampagne durchläuft dieselben Prüfungen, sobald ihre Startzeit
erreicht ist. Schlägt eine davon fehl, wechselt die Kampagne statt zu
Running zu Paused und behält den Fehler – eine Kampagne, die gestern
Scheduled war und heute Paused ist, ist also meist an einer der obigen
Zeilen gescheitert.

### Es werden keine Anrufe getätigt

Bei einer laufenden Kampagne, die keine Anrufe tätigt, liegt es meist an
einem der folgenden Punkte:

* **Außerhalb des Anruffensters** – prüfe die aktuelle Uhrzeit gegen das
  [Anruffenster](#anruffenster) und die Zeitzone der Kampagne.
* **Warteschlange erschöpft** – jeder Lead hat entweder **Max. retries**
  aufgebraucht oder wartet auf seinen nächsten Versuch. Importiere weitere
  Leads, oder prüfe die [Wiederholungseinstellungen](#wiederholungslogik).
* **Gesperrt** – Leads auf der [Sperrliste](#nicht-anrufen-dnc) werden
  übersprungen, nicht erneut versucht.

### Fehlersuche bei der Zielerreichung

Markiert [Retry until goal completed](#erneut-versuchen-bis-das-ziel-erreicht-ist)
Leads unerwartet als abgeschlossen – oder nie – liegt die Ursache meist an
der Zielvariable selbst, nicht an der Wiederholungslogik:

1. Prüfe aktuelle Anruf-Transkripte auf Extraktionsfehler bei der
   Zielvariable.
2. Führe ein paar Testanrufe durch und prüfe, was der Assistent tatsächlich
   extrahiert.
3. Schärfe die Beschreibung der Variable und die Prompt-Formulierung
   drumherum, damit die Kriterien eindeutig sind.

<Note>
  Der Start einer Kampagne wählt die erste Welle sofort, danach prüft der
  Dialer jede laufende Kampagne etwa einmal pro Minute erneut. Ist nach ein
  paar Minuten nichts passiert, arbeite die obigen Prüfpunkte durch, statt
  einfach mehr Zeit abzuwarten.
</Note>