Ausgehende Kampagnen¶

Mit Outbound Campaigns ruft ein Voice Agent eine vorbereitete Empfängerliste an. Beginnen Sie mit einem kontrollierten Testempfänger, prüfen Sie die ausgefüllte Begrüßung und den Prompt und kontrollieren Sie die Liste vor echten Anrufen.

Zugang und Voraussetzungen¶

Campaigns ist eine Private-Beta-Funktion und muss für Ihren Workspace freigeschaltet sein. Bei einem Sub-Tenant muss auch der übergeordnete Reseller freigeschaltet sein. Wenden Sie sich bei angezeigter Zugangsseite an das Nuvoca-Team oder Ihren Reseller. Freischaltung und Berechtigungen zum Erstellen oder Starten von Kampagnen sind getrennte Voraussetzungen.

Bereiten Sie einen konfigurierten Voice Agent, eine verfügbare Caller number (From) und die benötigten Empfängerinformationen vor. Verwenden Sie für Ihren Anrufablauf freigegebene Empfänger.

1. Kampagne einrichten¶

Öffnen Sie Campaigns, erstellen Sie eine Kampagne und füllen Sie Setup aus:

Feld	Zweck
Campaign name	Kennzeichnet die Kampagne im Workspace.
Company name	Liefert `{my_company}` für Kampagnenvorlagen.
Voice Agent	Stellt Stimme, Tools und bestehende Agent-Anweisungen bereit.
Caller number (From)	Nummer, von der aus angerufen wird.
Outbound greeting	Erster Satz ausgehender Anrufe; ersetzt die zeitabhängige Begrüßung eingehender Anrufe.
Campaign prompt	Ergänzt den bestehenden System-Prompt um Kampagnenauftrag und Empfängerkontext.
Shared values	Gemeinsame Werte für alle Empfänger.
Recipient fields	Deklarierte Schlüssel, die je Empfänger befüllt werden.

Speichern Sie Setup, bevor Sie Audience, Launch oder Run history öffnen.

2. Vorlagen vorbereiten¶

Kampagnenvorlagen unterstützen {agent_name}, {campaign_name}, {my_company} und {recipient_phone_number} sowie Ihre deklarierten gemeinsamen Werte und Empfängerfelder. Dies sind Kampagnenvariablen; nicht jede Agent-Prompt-Variable steht hier zur Verfügung.

Deklarieren Sie beispielsweise das Empfängerfeld name und verwenden Sie diese Begrüßung:

Guten Tag {name}, hier ist {agent_name}, der digitale Assistent von {my_company}.
Passt es gerade für ein kurzes Gespräch?

Prüfen Sie die Vorschau für jeden Empfänger. Nicht deklarierte oder unaufgelöste Variablen verhindern einen gültigen Anruftext. Ersetzen Sie fehlende Informationen nicht durch Platzhalterwerte.

3. Empfängerliste erstellen¶

Verwenden Sie in Audience manuelle Eingabe, CSV oder eine API-Quelle und speichern Sie die geprüften Empfänger als Call List.

Manuelle Eingabe: E.164-Rufnummern und die deklarierten Empfängerfelder eingeben.
CSV: UTF-8, kommagetrennt, höchstens 256 KiB, mit phone_number und Ihren Empfängerfeldern als Spaltenüberschriften. Die Spaltenreihenfolge ist frei.
API-Quelle: Einen GET-Aufruf, den Collection-Pfad ($ für ein Array auf oberster Ebene), den Rufnummernpfad und die Feldzuordnungen konfigurieren. Optional stehen OAuth, Query-Parameter und vertrauliche Header zur Verfügung. Die Vorschau ruft die Quelle ab, startet aber keine Telefonate.

Prüfen Sie Validierungsfehler, Duplikate und Zielbeschränkungen in der Vorschau. Eine korrekt formatierte Nummer ist nicht automatisch ein erlaubtes Ziel. Korrigieren Sie abgelehnte Zeilen vor dem Start. Eine gespeicherte Liste ist eine Momentaufnahme; rufen Sie bei geänderten Empfängern neue Quelldaten ab und speichern Sie diese erneut.

4. Prüfen und starten¶

Öffnen Sie die gespeicherte Call List und erzeugen Sie die Ausführungsvorschau.
Prüfen Sie Empfängerzahl, Agent, Absenderrufnummer, ausgefüllte Texte und angezeigte Preisaufschlüsselung.
Wählen Sie Start now oder Datum und Uhrzeit mit einer ausdrücklich gewählten Schedule timezone.
Prüfen Sie die Bestätigung und wählen Sie Start calls now oder Schedule calls.

Der Start löst echte Anrufe aus

Anrufe laufen nacheinander. Geplante Anrufe beginnen nicht vor dem gewählten Zeitpunkt. Speichern oder Vorschau allein starten keine Liste.

Wenn eine Startanfrage nicht bestätigt werden kann, prüfen Sie Launch und den bestehenden Run, bevor Sie erneut starten. Vermeiden Sie doppelte Anrufe durch sofortiges Wiederholen einer unklaren Anfrage.

5. Überwachen oder abbrechen¶

Nutzen Sie Launch für laufende Aktivitäten und Run history für abgeschlossene oder abgebrochene Runs samt Ergebnissen. Unterscheiden Sie abgeschlossene, nicht angenommene, besetzte, fehlgeschlagene und abgebrochene Empfängeranrufe.

Cancel Run verhindert weitere Anrufe an verbleibende Empfänger. Ein bereits startender, klingelnder oder verbundener Anruf kann regulär enden. Ein abgebrochener Run lässt sich nicht fortsetzen; prüfen Sie die Ergebnisse vor einem neuen Run.

Fehlerbehebung¶

Problem	Prüfen
Kampagnenfunktionen fehlen	Workspace-Freischaltung und Rollenberechtigungen.
Vorlagenvorschau schlägt fehl	Deklarierte Schlüssel und nicht leere Empfängerwerte.
Ziel wird abgelehnt	Validierung und angezeigten Ablehnungsgrund der Zeile.
API-Empfängerliste ist leer	Collection-Pfad, Feldzuordnungen, Authentifizierung und Quellantwort.
Vorschau ist veraltet	Änderungen speichern und Vorschau neu erzeugen.
Geplanter Zeitpunkt stimmt nicht	Gewählte Zeitzone und angezeigtes Datum samt Uhrzeit.

Siehe Voice-Konfiguration, Prompting und Anrufhistorie für Agent-Einrichtung und Nachprüfung.