Zum Inhalt springen
WeZend

Kampagnen & Inhalte

API-getriggerte Kampagnen: eine gespeicherte Kampagne senden

POST /v1/campaigns/:id/trigger sendet eine gespeicherte Kampagne an benannte Personen mit eigenen Daten oder an Listen und Segmente.

POST /v1/campaigns/{id}/trigger sendet eine gespeicherte Kampagne aus Ihrem eigenen System: Eine Bestellung geht ein, ein Formular wird ausgefüllt, eine Automatisierung feuert. In der Nachricht stehen die Daten als {{ trigger.order_id }} (Liquid). Nötig ist ein API-Schlüssel mit dem Scope send oder ein Dashboard-Nutzer, der starten darf.

{
  "recipients": [
    { "email": "ann@example.com", "data": { "order_id": "1001", "total": "99 EUR" } },
    { "contact_id": "…", "data": { "order_id": "1002" } }
  ],
  "data": { "shop": "Acme" },
  "idempotency_key": "order-1001"
}

Die Antwort ist 202 { campaign_id, accepted, unmatched, opted_out }. Pro Aufruf sind 1 bis 1.000 Empfänger möglich; Daten höchstens 50 Schlüssel und 8.000 Zeichen je Empfänger. Gemeinsame data gelten für alle, die eigenen Daten eines Empfängers haben Vorrang.

Stattdessen eine Zielgruppe ansprechen

Statt recipients nennen Sie list_ids und/oder segment_ids (bis zu 20 IDs; die des Kontos, sonst list_not_found oder segment_not_found). Die Zielgruppe wird beim Senden gelesen, die Antwort ist 202 { campaign_id, audience }.

Regeln

  • Die gespeicherte Kampagne ist die Vorlage. Jeder Trigger kopiert sie in eine eigene Kampagne namens „<Name> (API trigger)“; die gespeicherte bleibt unberührt. Nur eine Kampagne mit Status draft, sent oder active lässt sich triggern (409 campaign_not_triggerable).
  • Empfänger müssen bereits Kontakte sein. Unbekannte Personen kommen in unmatched zurück und werden nie angelegt. Abgemeldete Personen bleiben außen vor und werden in opted_out gezählt.
  • Alles, was ein Kampagnenversand durchsetzt, läuft weiter: Double-Opt-in, Suppression, Frequenzlimits und Ruhezeiten, Kontingent, Guthaben, Holdout, A/B, Rabattcode-Pools. Werte werden in E-Mails HTML-escaped.
  • idempotency_key: Derselbe Schlüssel bei derselben gespeicherten Kampagne antwortet 200 { duplicate: true, campaign_id } und sendet nichts erneut, auch bei parallelen Aufrufen. Setzen Sie einen, wenn Ihr Aufrufer Wiederholungen macht.
  • Die erste E-Mail-Kampagne eines neuen Kontos wartet auf die Prüfung durch einen Menschen, daher antwortet ein Trigger mit 409 first_campaign_needs_review, bevor etwas kopiert wird. Senden Sie die Kampagne zuvor einmal aus dem Dashboard.
  • Ein fehlerhafter Body, die Kampagne eines anderen Kontos (404), ein Nur-Lese-Schlüssel (403) und kein Schlüssel (401) werden vor dem Versand abgelehnt.

Um den Kontakt zuerst anzulegen, rufen Sie POST /v1/contacts/upsert auf.

Eine Plattform. Jede Kundeninteraktion.

Ersetzen Sie Ihren Flickenteppich aus Messaging-APIs, CDP und Automatisierungstools durch eine Engagement-Plattform, die für Skalierung gebaut ist.

Keine Kreditkarte · EU-Datenhaltung · 99,99 % Uptime-SLA