Triggersendungen

Triggersendungen sind Sendungen, die durch externe Ereignisse ausgelöst werden und direkt über die API versendet werden können. Typische Beispiele: Passwort‑Zurücksetzen, Buchungsbestätigungen oder Willkommens‑E-Mails.

Grundlagen

Triggersendungen müssen durch Redakteure vorab in mail2many erstellt und aktiviert werden. Sie werden dann über einen eindeutigen TriggerType identifiziert.

Wichtig:

• Absendername und Betreff werden durch den Redakteur vorgegeben
• Der Versand erfolgt über die API, nicht manuell im Account
• Ändert sich die Sendung in mail2many, muss der API‑Call nicht angepasst werden – der TriggerType bleibt gleich
• TriggerTypes können über mehrere Accounts hinweg verwendet werden – damit lassen sich verschiedene Accounts eines Kunden mit dem gleichen TriggerType auslösen
• Trigger‑Types sind abrufbar über: GET /triggerTypes
• Mehrsprachigkeit wird über den Language-Parameter gesteuert

Platzhalter

Triggersendungen sind ganz normale Sendungen, enthalten aber in der Regel mindestens einen Artikel mit einem Trigger-Template. Dieses Template beinhaltet befüllbare Platzhalter, die personalisierte Inhalte ermöglichen:

Beispiele:

• {resetLink} – Passwort‑Reset-Link
• {bookingId} – Buchungs-ID
• {productName} – Produkt- oder Servicename

hinweis

Die verfügbaren Platzhalter sind pro Template definiert. Es gibt aktuell keine API zum Auslesen der Platzhalter – sie müssen beim Entwickler der Triggersendung nachgefragt werden.

Beispiel: Single Trigger mit individuellen Platzhaltern

Trigger Template: "Passwort-Reset"
  Hallo {firstname},
  Klicken Sie hier: {resetLink}
  Üblicherweise gültig für: {validHours} Stunden

API-Call mit 3 Empfängern:

  Empfänger 1: max@example.com
    ├─ {firstname} = "Max"
    ├─ {resetLink} = "https://example.com/reset/abc123"
    └─ {validHours} = "24"
    └→ E-Mail: "Hallo Max, Klicken Sie hier: https://example.com/reset/abc123..."

  Empfänger 2: lisa@example.com
    ├─ {firstname} = "Lisa"
    ├─ {resetLink} = "https://example.com/reset/def456"
    └─ {validHours} = "24"
    └→ E-Mail: "Hallo Lisa, Klicken Sie hier: https://example.com/reset/def456..."

  Empfänger 3: john@example.com
    ├─ {firstname} = "John"
    ├─ {resetLink} = "https://example.com/reset/ghi789"
    └─ {validHours} = "24"
    └→ E-Mail: "Hallo John, Klicken Sie hier: https://example.com/reset/ghi789..."

Zwei Varianten

Beim Erstellen muss sich der Redakteur zwischen zwei Varianten von Triggersendungen entscheiden. Diese Entscheidung bestimmt auch, welche APIs für den Versand zur Verfügung stehen.

Single Trigger

Use-Case: Einzelne oder wenige Empfänger in Echtzeit und aggregierter Statistik

Bei Single‑Triggersendungen musst du nur eine API ansprechen. Die Triggersendungen werden sofort bei Aufruf der API an einen Empfänger gesendet.

Merkmale:

• Sofortiger Versand
• Aggregierte Statistiken (alle Versände zusammen)
• Zwei Endpoints verfügbar:
  • POST /mailings/singleTrigger – ein Empfänger pro Anfrage
  • POST /mailings/singleTrigger/batch – bis zu 100 Empfänger in einer Anfrage
• Platzhalter können pro Empfänger unterschiedlich befüllt werden (sinnvoll für z. B. Buchungsbestätigungen mit unterschiedlichen Daten)
• Absendername und Betreff können für den ganzen Request oder pro Empfänger überschrieben werden

Campaign Trigger

Use-Case: Große Empfängergruppen mit verzögertem Versand und Statistiken pro Versand

Beim Campaign‑Trigger musst du zunächst eine Kopie der Triggersendung erstellen, danach Empfänger in die Kopie übertragen und anschließend den Versand der Kopie einplanen. Geeignet für z. B. Newsletter an Kunden ohne Kauf in den letzten 6 Monaten.

Merkmale:

• Versand im Hintergrund (asynchron)
• Status abrufbar über: GET /mailings/trigger/{id}
• Statistiken pro Kampagne separat auswertbar (durch die Kopie)
• Ablauf mit mehreren Schritten:
  1. POST /mailings/trigger – Kopie erstellen
  2. POST /mailings/trigger/{id}/receivers – Empfänger übertragen
  3. POST /mailings/trigger/{id}/schedule – Versand planen
• Absendername und Betreff können global beim Erstellen der Kopie oder optional pro Empfänger überschrieben werden

Vergleich

Kriterium	Single Trigger	Campaign Trigger
Empfänger	Einzelne oder wenige	Größere Empfängermengen
Versand	Sofort	Im Hintergrund
Statistiken	Aggregiert	Pro Kampagne
Endpunkte	2 (einzeln + batch)	3 (erstellen, empfänger, planen)
Platzhalter	Pro Empfänger unterschiedlich	Pro Empfänger unterschiedlich
Typische Use-Cases	Passwort-Reset, Bestätigung	Zielgerichtete Newsletter, Kampagnen

API-Integration

Detaillierte Anfrage- und Antwort-Beispiele für beide Varianten findest du in der Endpoint‑Dokumentation.