Kampagnen

curl -X POST "https://api.talkturo.com/api/crm/campaigns" \
  -H "Authorization: Bearer tk_example_9xmk7q2r" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Q4 reactivation campaign",
    "assistantId": "asst_7d92f4a1",
    "companyId": "cmp_31ab82d9",
    "fromNumberIds": [
      "9f8d1c5f-3c31-45b7-8ef1-72e4b53e6b11"
    ],
    "scheduledStartAt": "2026-09-15T14:00:00Z",
    "callWindowStart": "09:00",
    "callWindowEnd": "17:00",
    "callWindowTimezone": "America/New_York",
    "maxConcurrentCalls": 4,
    "maxAttemptsPerContact": 3,
    "retryDelayMinutes": 120
  }'

{
  "id": "camp_4bc91e27",
  "name": "Q4 reactivation campaign",
  "status": "scheduled",
  "assistantId": "asst_7d92f4a1",
  "companyId": "cmp_31ab82d9",
  "fromNumberIds": [
    "9f8d1c5f-3c31-45b7-8ef1-72e4b53e6b11"
  ],
  "scheduledStartAt": "2026-09-15T14:00:00Z",
  "callWindowStart": "09:00",
  "callWindowEnd": "17:00",
  "callWindowTimezone": "America/New_York",
  "maxConcurrentCalls": 4,
  "maxAttemptsPerContact": 3,
  "retryDelayMinutes": 120
}

Führe ausgehende Kampagnen in großem Umfang aus

Kampagnen sind das System für ausgehende Anrufe von Talkturo. Eine Kampagne kombiniert einen KI-Assistenten mit einer Kontaktliste, einem Satz von Telefonnummern und Anrufregeln und wählt Kontakte dann automatisch entsprechend dem von dir definierten Zeitplan und Wiederholungsverhalten an.

Die Kampagnen-Engine prüft alle 30 Sekunden, ob Arbeit ansteht. Wenn eine Kampagne aktiv ist und sich innerhalb ihres Anruffensters befindet, zieht die Engine berechtigte Kontakte aus der Warteschlange und startet Anrufe auf Grundlage deiner Kampagneneinstellungen.

So funktionieren Kampagnen

Eine Kampagne durchläuft einen vorhersehbaren Lebenszyklus. Du richtest sie einmal ein, meldest Kontakte an, definierst die Regeln und lässt dann die Wähl-Engine die Warteschlange abarbeiten.

Kampagnenstatus

Kampagnen verwenden eine kleine Gruppe von Statuswerten, die dir zeigen, ob sie bereit sind, warten, wählen oder abgeschlossen sind.

Statusübergänge verstehen

Das meiste Kampagnenverhalten lässt sich auf einige wichtige Statusänderungen zurückführen. Wenn du diese Übergänge kennst, kannst du besser vorhersagen, wann eine Kampagne startet, pausiert oder stoppt.

Häufige Übergänge

Was Abschluss bedeutet

Eine Kampagne erreicht completed, wenn sie keine Arbeit mehr zu verarbeiten hat. In der Praxis bedeutet das, dass jeder angemeldete Kontakt angerufen, übersprungen, fehlgeschlagen oder anderweitig aus der aktiven Warteschlange entfernt wurde.

Wenn dein Workflow die automatische Vervollständigung deaktiviert, bleibt die Kampagne möglicherweise außerhalb des normalen Abschlusswegs, selbst wenn die Warteschlange leer ist. Verwende Echtzeit-Kampagnenstatistiken, um zu prüfen, ob noch Arbeit aussteht.

Eine Kampagne erstellen

Du brauchst vier Pflichtfelder, um eine gültige Kampagne zu erstellen. Alles andere steuert Zeitplanung, Parallelität, Wiederholungen und Integrationen.

Pflichtfelder

Optionale Felder

Beispiel für eine Erstellungsanfrage

Kampagnen-API

Verwende diese Endpunkte, um Kampagnen zu erstellen, Kontakte zu verwalten, die Ausführung zu steuern und Live-Statistiken zu lesen.

Mit Kampagnenkontakten arbeiten

Kampagnen wählen CRM-Kontakte nicht direkt an. Sie wählen Kampagnenkontakte an, also angemeldete Datensätze, die innerhalb einer bestimmten Kampagne verfolgt werden.

Methoden zur Anmeldung

Du kannst Kontakte auf drei Arten zu einer Kampagne hinzufügen:

• Alle berechtigten Kontakte über den Zielgruppenmodus
• Manuelle Auswahl nach Kontakt-IDs
• Inline erstellen und anmelden, wenn du einen neuen Kontakt direkt zur Kampagne hinzufügen musst

Wenn ein Kontakt als DNC markiert ist, erfasst Talkturo die Anmeldung trotzdem, markiert diesen Kontakt jedoch automatisch als skipped.

Kontaktstatus

Jeder angemeldete Kontakt durchläuft im Verlauf der Kampagne seinen eigenen Zustellstatus.

Reihenfolge in der Warteschlange

Wenn mehrere Kontakte gleichzeitig bereit sind, verarbeitet Talkturo sie in dieser Reihenfolge:

1. Höhere priority zuerst
2. Früheres created_at zuerst, wenn die Priorität gleich ist

Diese Reihenfolge entspricht priority DESC, created_at ASC. Wenn du auf eine genaue Sequenzierung angewiesen bist, setze die Kontaktpriorität, bevor die Kampagne beginnt.

Guthaben und Kampagnenausführung

Kampagnen benötigen verfügbares Guthaben zum Startzeitpunkt und während sie laufen. Guthaben beeinflusst sowohl, ob eine Kampagne starten kann, als auch, ob sie weiter Kontakte anwählen kann.

Wenn eine geplante Kampagne ihren Startzeitpunkt erreicht, prüft Talkturo vor dem Wechsel zu running das Kontoguthaben. Wenn das Konto nicht über genügend Guthaben verfügt, wechselt die Kampagne zu paused, statt Kontakte anzuwählen.

Nachdem du Guthaben hinzugefügt hast, werden gesperrte Telefonnummern wieder aktiviert. Du kannst die pausierte Kampagne dann fortsetzen und die bestehende Warteschlange weiter verarbeiten.

Verwandte Seiten