Kampagnen

Listet die Kampagnen in dieser Organisation auf, neueste zuerst. MARKETING-Kampagnen sind Massenversände an Segmente oder alle Kontakte; TRANSACTIONAL-Kampagnen sind Einzelempfänger-Sendungen, die durch Trigger oder die API ausgelöst werden.

Liest eine einzelne Kampagne vollständig aus: Status, Zeitplan, Zielgruppe (Segmente oder alle Kontakte), Kanalvorlagen und Versandzähler (gesendet, zugestellt, geöffnet, fehlgeschlagen).

Erstellt eine Kampagne als ENTWURF: eine Massen-Marketingkampagne (z. B. ein WhatsApp-Template-Blast) für Segmente oder alle Kontakte oder einen transaktionalen Versand an einen einzelnen Empfänger.

Aktualisiert den Namen, die geplante Zeit oder die Zielgruppe einer Kampagne. Zielgruppe und Zeitplan können nur geändert werden, solange die Kampagne bearbeitbar ist (Marketing: ENTWURF, ABGEBROCHEN oder FEHLGESCHLAGEN; transaktional: ENTWURF, AKTIV oder PAUSIERT).

Kopiert eine Kampagne einschließlich ihrer Segmente und Kanalvorlagen. Die Kopie wird als ENTWURF erstellt und sendet nichts.

Löscht eine Kampagne und ihren Versandverlauf dauerhaft. Marketing-Kampagnen können nicht gelöscht werden, solange sie geplant sind oder senden; transaktionale Kampagnen müssen vorher pausiert werden.

Bewegt eine Kampagne durch ihren Lebenszyklus: 'schedule' stellt eine MARKETING-Kampagne für ihr gesamtes Publikum in die Warteschlange (der echte Massenversand — sofort oder zum geplanten Zeitpunkt; erfordert eine Kanalvorlage); 'cancel' stoppt eine geplante/sendende Marketing-Kampagne und setzt sie auf Entwurf zurück; 'activate' schaltet eine TRANSACTIONAL-Kampagne ein; 'pause' pausiert sie.

Hänge die Kanalnachricht einer Kampagne an oder aktualisiere sie — also das, was tatsächlich gesendet wird.

Fügt bestimmte Kontakte zur Zielgruppe einer MARKETING-Kampagne hinzu (zusätzlich zu Segmenten / An alle senden), z. B. eine aus einer Datei importierte Liste oder in Code gefiltert. Erfordert eine bearbeitbare Kampagne mit mindestens einer Kanalvorlage.

Zeigt eine Vorschau, wie viele Empfänger eine MARKETING-Kampagne pro Kanal erreicht, basierend auf ihrer aktuellen Zielgruppe — prüfe das vor dem Planen des Versands.

Versucht die fehlgeschlagenen Empfänger einer Kampagne erneut (bis zu 1000 pro Aufruf). Lass recipient_ids weg, um alle fehlgeschlagenen erneut zu versuchen.

Entfernt ausstehende (noch nicht gesendete) Empfänger aus einer bearbeitbaren MARKETING-Kampagne. Lass contact_ids weg, um alle ausstehenden zu entfernen.

Listet die Personalisierungsfelder ({{variable}}-Platzhalter) einer Kampagne mit ihren Standardwerten auf.

Erstellt oder aktualisiert ein Personalisierungsfeld ({{variable}}) in einer Kampagne mit seinem Standardwert. Reservierte Schlüssel wie first_name/last_name werden vom Kontakt aufgelöst; andere Schlüssel verwenden den Standardwert, sofern kein eintragsspezifischer Wert ihn überschreibt.

Setze Personalisierungswerte pro Empfänger für eine MARKETING-Kampagne. Übergib einen Eintrag pro Empfänger, identifiziert über E-Mail, Telefon oder user_id. Übergib dry_run, um eine Vorschau der passenden Empfänger zu sehen, ohne etwas zu schreiben.

Plane eine MARKETING-Kampagne zur Zustellung an ihre gesamte Zielgruppe ein. Wird sofort gesendet, wenn für die Kampagne keine Zeit geplant ist, andernfalls wartet sie bis dahin. Das ist der echte Massenversand: Bestätige das mit dem Nutzer, bevor du ihn ausführst. Erfordert den Status DRAFT, CANCELLED oder FAILED und mindestens eine Kanalvorlage.

Bricht eine MARKETING-Kampagne mit Status SCHEDULED oder SENDING ab: Sie kehrt zu DRAFT zurück und kann bearbeitet und erneut geplant werden. Bereits gesendete Empfänger bleiben gesendet.

Aktiviert eine TRANSACTIONAL-Kampagne, damit sie Trigger akzeptiert und mit dem Versand an einzelne Empfänger beginnt. Zulässig aus ENTWURF oder PAUSIERT; erfordert mindestens eine Kanalvorlage.

Pausiert eine AKTIVE transaktionale Kampagne. Trigger werden abgelehnt, bis sie erneut aktiviert wird; die Konfiguration bleibt erhalten.

Sendet einen Test einer Kampagne an eine einzelne E-Mail-Adresse oder Telefonnummer, damit ihr Inhalt vor dem echten Versand geprüft werden kann. Funktioniert nur, solange die Kampagne testbar ist (Marketing: ENTWURF, ABGEBROCHEN oder FEHLGESCHLAGEN; transaktional: ENTWURF, AKTIV oder PAUSIERT).

Aggregierte Zustell- und Interaktionsstatistiken pro Kampagne: Gesamtzahlen, Zustellrate und Öffnungsrate, optional auf einen Datumsbereich begrenzt.

Listet einzelne Kampagnenzustellungen mit ihrem Status auf (gesendet, zugestellt, geöffnet, fehlgeschlagen, zurückgewiesen). Beantwortet „Haben wir X an diesen Kontakt gesendet?“: nach Kampagne, nach Kontakt filtern oder über alle Kampagnen hinweg nach Name, E-Mail oder Telefonnummer suchen.