Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.talkturo.ai/llms.txt

Use this file to discover all available pages before exploring further.

Das Anlegen einer Kampagne dauert wenige Minuten. Sie wählen den Assistenten, die rotierenden Telefonnummern, die Kontakte und das erlaubte Zeitfenster. Sie können sofort starten oder einen Entwurf speichern.
1

Seite Kampagnen öffnen

Klicken Sie in der linken Seitenleiste auf Campaigns, dann oben rechts auf New Campaign. Es öffnet sich ein Dialog mit allen Kampagneneinstellungen.
2

Kampagnennamen vergeben

Tragen Sie unter Campaign Name einen erkennbaren Namen ein — er erscheint in der Liste und im Dashboard (z. B. „Q2 Enterprise Outreach“ oder „Trial Follow-Up“).Optional füllen Sie Description für interne Notizen.
3

Outbound-Assistent wählen

Im Feld Outbound Assistant wählen Sie einen Assistenten. Nur Assistenten mit aktiviertem Outbound und mindestens einer aktiven Telefonnummer erscheinen.
Ist die Liste leer: Assistants → Ihr Assistent → Telephony → Outbound aktivieren und eine aktive Nummer zuweisen.
4

Ausgehende Nummern wählen

Nach der Assistentenauswahl erscheinen alle dem Assistenten zugewiesenen Nummern unter Which numbers do you want to use for outbound calling?Alle sind standardmäßig angehakt; Talkturo rotiert über die Auswahl. Deaktivieren Sie Nummern, die nicht genutzt werden sollen.
5

Firma und Kontakte

Kampagnen zielen auf Kontakte einer Company im CRM. Wählen Sie die Firma aus der Liste.Danach erscheint Audience:All eligible contacts — Talkturo nimmt jeden Kontakt der Firma mit Telefonnummer und ohne DNC. Neue Kontakte können später automatisch einbezogen werden.Manual select — Kontakte filtern und einzeln auswählen. Mit Search, Lead Status und Filtern eingrenzen; Select all eligible wählt alle wählbaren Kontakte über alle Seiten.
Has phone und Exclude DNC (Standard an) lassen unerreichbare Kontakte weg. Ohne Telefon oder mit DNC sind Kontakte nicht wählbar.
6

Zeitplan

Schedule Start (optional) — Datum und Uhrzeit für automatischen Start; Zeit bezieht sich auf die Zeitzone des Anruffensters. Leer lassen für Entwurf und manuellen Start.Keep open for new contacts — Aktivieren, wenn Sie nach Start weiter Kontakte per API nachreichen. Die Kampagne springt dann nicht automatisch auf „Completed“, sobald die erste Liste durch ist.
7

Anruffenster

Das Fenster legt fest, an welchen Uhrzeiten neue Anrufe starten dürfen.
FeldStandardBedeutung
Call Window Start09:00Früheste Startzeit pro Tag
Call Window End17:00Späteste Startzeit pro Tag
Call Window TimezoneAmerica/New_YorkZeitzone für Start/Ende
Geplante Anrufe außerhalb des Fensters warten bis zum nächsten gültigen Tag.
8

Parallelität und Versuche

FeldStandardBedeutung
Max Concurrent Calls1Gleichzeitige ausgehende Anrufe (1–10)
Max Attempts/Contact3Maximale Wahlversuche pro Kontakt
Details zu Verzögerungen und Ergebnissen: Zeitplan & Timing.
9

Kampagne starten

Klicken Sie auf Create Campaign. Mit geplantem Start wird der Status Scheduled; ohne Zeitplan Draft — dann in der Liste das Play-Symbol zum manuellen Start.

Pflichtfelder

Bei Anlage über UI oder API werden u. a. benötigt:
FeldBeschreibung
nameLesbarer Kampagnenname
assistantIdID des Outbound-Assistenten
companyIdID der Firma, deren Kontakte gewählt werden
fromNumberIdsListe der Telefonnummer-IDs für Rotation

API: Kampagne erstellen

Programmatisch senden Sie POST /api/crm/campaigns. Kontakte danach mit POST /api/crm/campaigns/{id}/contacts hinzufügen.
POST /api/crm/campaigns
Content-Type: application/json
Authorization: Bearer <your-token>

{
  "teamId": "your-team-id",
  "name": "Q2 Enterprise Outreach",
  "assistantId": "asst_abc123",
  "companyId": "cmp_xyz456",
  "fromNumberIds": ["num_111", "num_222"],
  "description": "Follow-up calls for enterprise trial accounts",
  "scheduledStartAt": "2026-06-01T09:00:00Z",
  "callWindowStart": "09:00",
  "callWindowEnd": "17:00",
  "callWindowTimezone": "America/New_York",
  "maxConcurrentCalls": 3,
  "maxAttemptsPerContact": 3,
  "retryDelayMinutes": 60
}
Die Antwort enthält bei Erfolg { "success": true, "campaign": { ... } } mit id. Mit dieser id Kontakte hinzufügen:
POST /api/crm/campaigns/{id}/contacts
Content-Type: application/json
Authorization: Bearer <your-token>

{
  "contactIds": ["cnt_aaa", "cnt_bbb", "cnt_ccc"]
}
Alle berechtigten Kontakte einer Firma automatisch hinzufügen mit audience statt contactIds:
{
  "audience": {
    "mode": "all_eligible",
    "companyId": "cmp_xyz456",
    "hasPhoneOnly": true,
    "excludeDnc": true
  }
}