---
title: "Ausgehende Kampagnen"
description: "Laden Sie eine Kontaktliste hoch und lassen Sie einen Agenten sie abarbeiten — mit Anruffenstern, Wiederholungsversuchen und Live-Fortschritt."
---
Kampagnen wählen in Ihrem Namen eine Kontaktliste an: Wählen Sie einen Agenten, laden Sie eine
CSV-Datei hoch, legen Sie fest, wann Anrufe erlaubt sind, und ThunderPhone arbeitet die Liste ab
— mit Wiederholungsversuchen bei unbeantworteten Anrufen und Mailboxen nach dem von Ihnen gewählten Zeitplan. Sie finden
sie unter **Engagement → Kampagnen** (`/dashboard/campaigns`).
Verwenden Sie für einmalige programmatische Anrufe stattdessen die
[API für ausgehende Anrufe](/de/guides/place-outbound-calls).
## Voraussetzungen
- Ein bereitgestellter Sprachagent.
- Eine für ausgehende Anrufe aktivierte Telefonnummer. VoIP-Nummern von Kunden unterstützen weiterhin
Kampagnen. ThunderPhone-Nummern sind zunächst nur für eingehende Anrufe aktiviert; ein Organisationsadministrator kann
auf der Seite „Telefonnummern“ ausgehende Anrufe beantragen. ThunderPhone prüft
jeden Antrag manuell, und genehmigte Nummern können Kampagnen ausführen. Siehe
[VoIP-Anbieter verbinden](/de/guides/voip-providers).
- Kontakte als CSV-Datei (oder eingefügtes JSON) mit einer Spalte `phone` oder
`phone_number`. **Bis zu 5.000 Zeilen pro Upload**, UTF-8-kodiert.
Neue JSON-Uploads müssen flach sein: Zusätzliche Werte können Zeichenfolgen, Zahlen,
boolesche Werte oder `null` sein. Zeilen mit Arrays oder verschachtelten Objekten werden
einzeln mit einer Validierungsmeldung abgelehnt; gültige Zeilen werden dennoch importiert. CSV-Zellen
sind Zeichenfolgen. Akzeptierte zusätzliche Spalten werden als Variablen pro Kontakt in den
Kontaktdatensätzen der Kampagne gespeichert und automatisch bei jedem Wählvorgang bereitgestellt. ThunderPhone
klassifiziert außerdem vor jedem ausgehenden Anruf den gespeicherten Prompt des Agenten, um zu entscheiden, ob
der Agent durch ein Telefonmenü navigieren soll. Kopfzeilen wie `name` und `account_id`
entsprechen `{{name}}` und `{{account_id}}` im Prompt des gespeicherten Agenten. Die Namenszuordnung kann auch Spalten zu `name` kombinieren. Siehe
[Variablen pro Anruf](/de/guides/call-variables) für Standardwerte, Benennungsregeln,
die Objektgrenze von 32 KB und Werte, die in Abschluss-Webhooks zurückgegeben werden.
Ältere Kontaktdatensätze können verschachtelte Metadaten aus früheren JSON-Uploads enthalten.
Diese Metadaten bleiben beim gespeicherten Kontakt. Jeder Anruf lässt nicht skalare Werte aus
seiner Variablen-Payload weg und protokolliert die ignorierten Schlüsselnamen für diesen Versuch, ohne
Werte zu protokollieren. Wiederholungsversuche verwenden dieselbe Filterung.
## Kampagne erstellen
Geben Sie einen Namen ein, wählen Sie den **Sprachagenten** und die **Absendernummer**
(eine Ihrer für ausgehende Anrufe aktivierten Nummern).
Zeilen mit einer ungültigen Telefonnummer oder ungültigen Variablen werden einzeln abgelehnt und
mit ihren Zeilennummern zurückgemeldet — die übrigen werden problemlos importiert.
Wählen Sie eine **Zeitzone** und ein Fenster für den **täglichen Start/Ende**; die Kampagne
wählt nur innerhalb dieses Fensters. Die Zeitzone richtet sich zunächst nach der Zeitzone Ihrer Absendernummer
(deren Vorwahl in den USA und Kanada, andernorts deren Land) oder bei
Nummern, die sich über mehrere Zeitzonen erstrecken, etwa gebührenfreien Nummern, nach der Ihres
Browsers. Der Hinweis unter dem Feld zeigt an, welche verwendet wird. Standardmäßig gilt das Fenster
von 9:00 bis 17:00 Uhr. Ein Fenster, das vor 8:00 Uhr beginnt oder nach 21:00 Uhr endet, zeigt eine
Warnung an: Anrufe außerhalb dieser Zeiten können Regeln zu zulässigen Anrufzeiten wie
die TCPA verletzen. Ein Ende vor dem Start überschreitet Mitternacht: 22:00 →
02:00 wählt von 22:00 Uhr bis 2:00 Uhr am nächsten Tag, mit einer Warnung. Das
Fenster gilt in der Zeitzone der Kampagne, nicht in der jedes Kontakts. Teilen Sie
Kontakte daher nach Zeitzone auf, wenn sie verteilt sind.
Legen Sie optional einen **Startzeitpunkt** fest, um den Start zu planen, sowie einen
**Endzeitpunkt**, nach dem die Kampagne automatisch abgeschlossen wird.
- **Gleichzeitige Anrufe** — wie viele Anrufe diese Kampagne gleichzeitig ausführt
(1–10, standardmäßig 3). Kampagnen starten keinen neuen Anruf, solange in Ihrer
Organisation 10 ausgehende Anrufe aktiv sind. Parallele Kampagnen teilen sich daher
dieses Kontingent. Jeder Anruf zählt außerdem für das
[Limit für gleichzeitige Anrufe](/api-reference/introduction#call-limits) Ihrer Organisation
(standardmäßig 20, über eingehende, ausgehende, Web- und Testanrufe hinweg).
Wenn dieses Limit erreicht ist oder dieselbe Nummer in den
letzten 10 Sekunden angerufen wurde, wartet der Kontakt einfach auf einen späteren Durchlauf; seine
Versuche werden nicht verbraucht.
- **Maximale Versuche** — wie oft jeder Kontakt angerufen werden darf
(1–10, standardmäßig 2).
- **Wartezeit vor Wiederholungsversuchen (Minuten)** — die Wartezeit vor einem erneuten Versuch (mindestens 30,
standardmäßig 60).
- **Wiederholen bei** — welche Ergebnisse einen erneuten Versuch auslösen: **keine Antwort**,
**Mailbox**, **fehlgeschlagen** (standardmäßig alle aktiviert).
Sie benötigen mehr Versuche oder kürzere Abstände? Wenden Sie sich an den Support: Mitarbeitende können
beide Limits für Ihre Organisation erhöhen.
Kampagnen werden als Entwürfe erstellt — Kontakte können nur hinzugefügt werden, solange eine
Kampagne ein Entwurf ist. Das Starten einer Kampagne erfordert eine ausdrückliche Zustimmung
zu den Anrufgebühren. Mit einem zukünftigen **Startzeitpunkt** wird sie
*geplant*; andernfalls startet sie sofort und *läuft*.
Kampagnen, die vor diesen Limits gespeichert wurden, laufen weiterhin genau wie konfiguriert.
Ihre Versuche und Abstände bleiben bei anderen Bearbeitungen wie gespeichert.
## So funktionieren Ergebnisse und Wiederholungsversuche
Nach jedem Anruf erhält der Kontakt ein Ergebnis — erfolgreiche Anrufe werden
als abgeschlossen markiert; ein als nicht beantwortet eingestufter, als
Voicemail erkannter oder fehlgeschlagener Anruf wird wiederholt, wenn dieses
Ergebnis in Ihrer Liste **bei erneutem Versuch** enthalten ist und für den
Kontakt noch Versuche übrig sind. Kontakte ohne verbleibende Versuche werden
als *ausgeschöpft* markiert; nicht wiederholbare Fehler werden als
*fehlgeschlagen* markiert.
Das Wählen wird automatisch pausiert, solange Ihr Kontoguthaben nicht
ausreichend ist, und fortgesetzt, sobald es wieder ausreichend ist. Lassen Sie
[automatische Aufladung](/de/guides/billing-and-topups) bei langen Kampagnen aktiviert.
## Überwachen und steuern
Jede Kampagnenkarte zeigt ihren Status und Fortschritt an (z. B. „173 von 248
abgeschlossen“). Öffnen Sie eine Kampagne, um die Statusaufschlüsselung,
Ergebnisse pro Kontakt und letzte Anrufe anzuzeigen — jeder davon verlinkt zum
vollständigen Transkript und zur Aufzeichnung im Anrufverlauf.
- **Pausieren / fortsetzen** — durch das Pausieren werden keine neuen Anrufe
gestartet; bereits laufende Anrufe werden regulär beendet. Pausierte Kampagnen können bearbeitet und fortgesetzt werden.
- **Abbrechen** — beendet die Kampagne dauerhaft.
- Eine Kampagne wird automatisch abgeschlossen, wenn jeder Kontakt einen
endgültigen Status erreicht oder die Zeit **beenden um** verstrichen ist.
Kampagnenstatus: `draft`, `scheduled`, `running`, `paused`,
`completed`, `cancelled`. Kontaktstatus: `pending`, `scheduled`,
`calling`, `completed`, `failed`, `exhausted`.
## Nächste Schritte
Hören Sie Kampagnenanrufe in Echtzeit mit.
Tätigen Sie einzelne Anrufe programmatisch.