Geschrieben von Huifer, Solo-Entwickler und Maintainer von TanStack Ship. Seit 2022 betreibe ich E-Mail-Automatisierung mit TanStack Start + Cloudflare Workers + D1. Push-Benachrichtigungen ergänze ich zuletzt – denn Trigger und Datenmodell funktionieren ähnlich, aber bei der Zustellung gelten strenge Regeln. Dieser Beitrag beschreibt das Schema und das Workflow-Design, mit denen ich heute starte. Wo mir verlässliche Messwerte fehlen, sage ich das offen, statt Zahlen zu nennen.
Verifizierte Quellen: TanStack Start-Dokumentation · Web-Push-Benachrichtigungen auf web.dev · Cloudflare Workers-Dokumentation · MDN Push API · RFC 8030 — Web-Push-Protokoll · RFC 8292 — VAPID
Zuletzt aktualisiert: 2026-10-26 · Änderungsprotokoll
Push Notification Automation: Trigger-Workflows + Datenmodell
Push-Notification-Automatisierung ist das System, das ein Ereignis – eine Anmeldung, eine Zustandsänderung, einen Zeitplan oder eine Phase der Inaktivität – in eine eingereihte, deduplizierte und auf Berechtigungen geprüfte Web-Push-Nachricht umwandelt. Es besteht aus drei Ebenen: einem Triggermodell, einer Workflow-Sequenz-Engine und einem Benachrichtigungsdatenmodell. Dieser Leitfaden definiert jede Ebene und zeigt das D1-Schema sowie den Workers-Code, mit dem sie umgesetzt werden. Er richtet sich an Solo-Gründer und Full-Stack-Entwickler, die entscheiden, welche Funktionen ihr SaaS-Stack nativ unterstützen muss. Wenn Sie statt eines Neubaus Boilerplates vergleichen, sehen Sie hier, welche SaaS-Templates diese Funktionen enthalten.
Wenn Sie nach einer „push notification automation trigger workflow sequence“ gesucht haben, suchen Sie eigentlich nach der Verbindung zwischen diesen drei Ebenen. Benennen wir sie also genau.
Kurzfassung
- Push-Notification-Automatisierung besteht aus Triggern + Sequenzen + einem Datenmodell. Fehlt eine Ebene, werden Benachrichtigungen doppelt oder unbemerkt gar nicht zugestellt.
- Entwerfen Sie zuerst die Trigger-Klassen (Nutzeraktion, Zustandsänderung, Zeitplan, Inaktivität) und bilden Sie sie anschließend als deduplizierte Ereignisse ab.
- Entscheidend ist Idempotenz: Ein Unique Constraint pro (Anmeldung, Schritt) verhindert mehr Retry-Fehler, als ich zählen kann.
- Web Push selbst ist standardisiert und kostenlos zu versenden. Die eigentlichen Kosten entstehen durch Zustandsverwaltung, nicht durch Anbietergebühren.
Definition (zum Zitieren): Push-Notification-Automatisierung bezeichnet den Versand von Web-Push-Nachrichten anhand festgelegter Trigger über einen sequenzierten Workflow. Ein zugrunde liegendes Datenmodell erfasst Abonnements, Anmeldungen und Zustellergebnisse, sodass jede Benachrichtigung genau einmal ausgelöst wird.
Ein Hinweis zur Herkunft der Daten: In unseren Search-Console-Daten (vom Nutzer bereitgestellt, Zeitraum: 28 Tage) erscheint für diese Suchanfragen-Gruppe derzeit unser Leitfaden zur E-Mail-Marketing-Automatisierung auf einer durchschnittlichen Position von 5,4 bei 32 Impressionen. Das bedeutet: Leser landen beim E-Mail-Beitrag, obwohl sie nach einer Antwort zu Push suchen. Dieser Artikel liefert diese Antwort. Beide Kanäle nutzen dieselben Trigger- und Datenmodell-Ebenen; nur die Zustellung unterscheidet sich.
Das Triggermodell: fünf Ereignisklassen, die Push auslösen
Ein Trigger ist alles, was festlegt: „Dieser Nutzer soll jetzt eine Benachrichtigung erhalten.“ In der Praxis habe ich gelernt, dass Trigger nicht direkt mit dem Sender kommunizieren sollten. Jeder Trigger sollte zunächst ein Ereignis mit einem Deduplizierungsschlüssel schreiben. Alle nachgelagerten Prozesse lesen dann Ereignisse – niemals rohe Webhooks oder unverarbeitete Cron-Ticks. Bei Push ist das besonders wichtig, weil die Zustellung sofort erfolgt und für den Nutzer sichtbar ist. Eine doppelte Benachrichtigung ist ein UX-Fehler im Benachrichtigungscenter Ihrer Nutzer.
| Trigger-Klasse | Wird ausgelöst, wenn | Beispiel | Deduplizierungsschlüssel | Typischer Fehlerfall |
|---|---|---|---|---|
| Nutzeraktion | Ein explizites Ereignis im Produkt eintritt | Ein Release veröffentlichen, eine Aufgabe abschließen | event_id | Erneute Anmeldung, wenn ein Webhook wiederholt wird |
| Zustandsänderung | Eine Zeile einen Schwellenwert überschreitet | Rechnung überfällig, Kontingent überschritten | entity_id + Zustand | Ein schwankender Zustand löst täglich erneut aus |
| Zeitplan | Ein Cron-Tick eintritt | Wochenübersicht am Montag um 09:00 | Cron-Zeitfenster + Nutzer | Doppelte Zustellung bei überlappenden Cron-Läufen |
| Inaktivität | Ein Ereignis ausbleibt | 14 Tage ohne Sitzung | user_id + Zeitfenster der Lücke | Auslösung, obwohl der Nutzer bereits zurückgekehrt ist |
| Verspätet/Nachlieferung | Ein Ereignis verspätet eintrifft | Abonnement verlängert, während der Nutzer offline war | Deduplizierungs-ID des Anbieters | Unbemerkter Ausfall oder doppelte Zustellung |
Die Fehlerfälle in der rechten Spalte sind strukturell, keine gemessenen Benchmarks. Meine Sequenz-Tabellen sind so ausgelegt, dass diese Zustände gar nicht erst möglich sind. Doppelte Webhooks sind keine theoretische Möglichkeit: In der Webhook-Dokumentation von Stripe steht ausdrücklich, dass Endpunkte dasselbe Ereignis mehrfach empfangen können müssen. Ihre Trigger-Ebene muss also deduplizieren, bevor sie jemanden anmeldet.
Die Workflow-Sequenz-Engine: Schritte, Verzögerungen und Idempotenz
Eine Sequenz (in der E-Mail-Welt auch Drip-Kampagne genannt) ist eine geordnete Liste von Schritten mit Verzögerungen. Ein Workflow ist das übergeordnete System: Trigger → Bedingungen → eine oder mehrere Sequenzen. Eine Anmeldung ist der Zustand eines einzelnen Nutzers innerhalb dieses Workflows: welche Sequenz, welcher Schritt und wann der nächste Schritt fällig ist.
Ich definiere Sequenzen als Daten statt als Code, weil ich sie wöchentlich bearbeite. Einen Worker für eine Textänderung neu bereitzustellen, ist ein Warnsignal:
// sequences.ts — Definition einer Push-Notification-Sequenz
export type SequenceStep = {
index: number
offsetMinutes: number // Verzögerung ab dem Zeitpunkt der Anmeldung
templateId: string
requireAll: string[] // Bedingungen, die beim Auslösen des Schritts weiterhin gelten müssen
}
export const trialEndingSequence: SequenceStep[] = [
{ index: 0, offsetMinutes: 0, templateId: "trial-day-2", requireAll: ["trial_active"] },
{ index: 1, offsetMinutes: 60 * 48, templateId: "trial-last-day", requireAll: ["trial_active"] },
{ index: 2, offsetMinutes: 60 * 24, templateId: "trial-expired", requireAll: ["trial_expired"] },
]
Warum Sequenzen bei Wiederholungsversuchen scheitern
Der Runner selbst ist simpel: Anmeldungen abfragen, für die next_due_at <= now gilt, die Bedingungen in requireAll prüfen, senden und den Cursor weiterstellen. Kompliziert wird es bei Wiederholungsversuchen der Plattform. Cloudflare Cron Triggers können Ihren Handler erneut aufrufen. Außerdem kann eine HTTP-Anfrage nach dem Senden in einem Timeout enden, obwohl der Push-Dienst die Nachricht bereits angenommen hat. Ohne eine feste Schutzmaßnahme senden Sie die Push-Nachricht „Ihre Testphase endet heute“ zweimal – und im Benachrichtigungsbereich gibt es keine Rückgängig-Funktion.
Meine Regel: Die Zustellungszeile ist die Sperre. Fügen Sie eine Zeile in notification_deliveries mit dem Primärschlüssel (enrollment_id, step_index, endpoint) ein und stellen Sie den Cursor im selben D1-Batch weiter. D1-Batches laufen als eine Transaktion ab: Beide Schreibvorgänge werden übernommen oder keiner von beiden. Trifft ein Wiederholungsversuch ein, schlägt das Einfügen des Primärschlüssels fehl. Der Code behandelt das als „bereits gesendet“ und stellt den Cursor weiter. Ein Constraint ersetzt eine ganze Klasse verteilter-Systeme-Bedenken.
Das Benachrichtigungsdatenmodell: ein D1-Schema, das Wiederholungen übersteht
Diese Ebene wird häufig übersprungen und anschließend zweimal neu aufgebaut. Fünf Tabellen tragen das gesamte System:
-- SQLite/D1-Schema für Push-Notification-Automatisierung
CREATE TABLE push_subscriptions (
user_id TEXT NOT NULL,
endpoint TEXT PRIMARY KEY,
p256dh TEXT NOT NULL,
auth TEXT NOT NULL,
user_agent TEXT,
created_at INTEGER NOT NULL,
last_seen_at INTEGER
);
CREATE TABLE sequences (
id TEXT PRIMARY KEY,
name TEXT NOT NULL,
trigger_event TEXT NOT NULL, -- z. B. 'trial.started'
active INTEGER NOT NULL DEFAULT 1
);
CREATE TABLE sequence_steps (
sequence_id TEXT NOT NULL,
"index" INTEGER NOT NULL, -- 'index' ist in SQLite ein reserviertes Wort: in Anführungszeichen setzen
offset_minutes INTEGER NOT NULL,
template_id TEXT NOT NULL,
require_all TEXT NOT NULL, -- JSON-Array mit Bedingungsschlüsseln
PRIMARY KEY (sequence_id, "index")
);
CREATE TABLE sequence_enrollments (
id TEXT PRIMARY KEY,
user_id TEXT NOT NULL,
sequence_id TEXT NOT NULL,
cursor INTEGER NOT NULL DEFAULT 0,
next_due_at INTEGER NOT NULL,
status TEXT NOT NULL, -- active | done | exited
UNIQUE (user_id, sequence_id) -- eine Anmeldung pro Nutzer und Sequenz
);
CREATE TABLE notification_deliveries (
enrollment_id TEXT NOT NULL,
step_index INTEGER NOT NULL,
endpoint TEXT NOT NULL,
sent_at INTEGER NOT NULL,
push_status INTEGER, -- vom Push-Dienst zurückgegebener HTTP-Status
PRIMARY KEY (enrollment_id, step_index, endpoint) -- Idempotenzsperre
);
Was Ihnen die einzelnen Tabellen bieten:
push_subscriptions– der vom Browser gewährte Endpunkt samt Verschlüsselungsschlüsseln (Payload des Abonnements der Push API). Ein Nutzer kann mehrere Zeilen haben – Laptop und Smartphone sind unterschiedliche Endpunkte.sequences/sequence_steps– Workflow-Definitionen als Daten, sodass sich eine Drip-Kampagne ohne Deployment bearbeiten lässt.sequence_enrollments– die Zustandsmaschine pro Nutzer. Der ConstraintUNIQUE (user_id, sequence_id)sorgt dafür, dass ein wiederholtes Trigger-Ereignis keine zweite Anmeldung erzeugt, sondern wirkungslos bleibt.notification_deliveries– Audit-Log und Idempotenzsperre in einem. Wenn Sie fragen: „Haben wir das gesendet?“, erhalten Sie eine Datenbankabfrage statt einer Vermutung.
Beachten Sie die Anführungszeichen um "index" in sequence_steps: index ist ein reserviertes Wort in SQLite. Ohne Anführungszeichen schlägt Ihre Migration fehl. Das habe ich auf die unangenehme Art gelernt.
Zustellung: VAPID, der Service Worker und ein Workers-Cron-Runner
Die Zustellung ist der am stärksten standardisierte Teil des gesamten Systems – eine gute Nachricht: Das Web-Push-Protokoll (RFC 8030) legt fest, wie ein Server eine Nachricht an einen Push-Dienst übergibt. VAPID (RFC 8292) definiert, wie sich Ihr Server identifiziert. Die Payload-Verschlüsselung ist in einem eigenen RFC geregelt, damit Zwischenstellen niemals Klartext sehen. Die Web-Push-Übersicht von web.dev beschreibt die Browser-Seite: Ein Service Worker empfängt den Push und zeigt die Benachrichtigung an. Eine erfolgreiche Übermittlung gibt HTTP 201 zurück. Push-Dienste können bei überschrittenen Rate Limits HTTP 429 zurückgeben. Deshalb verarbeitet mein Runner 100 Anmeldungen pro Minute in Batches, statt die Queue auf einmal abzuarbeiten.
Zwei dokumentierte Plattformgegebenheiten sollten Sie bei der Planung berücksichtigen: Unter iOS und iPadOS 16.4 und neuer funktioniert Web Push laut Apples Web-Push-Dokumentation nur für Websites, die der Nutzer zum Home-Bildschirm hinzugefügt hat. Rechnen Sie also mit deutlich weniger iOS-Anmeldungen als auf dem Desktop und betrachten Sie das nicht als Fehler. Außerdem laufen Abonnements ab: Antwortet ein Push-Dienst mit 404 oder 410, gilt das Abonnement laut Push-API-Spezifikation als nicht mehr vorhanden. Löschen Sie dann die Zeile und ermöglichen Sie eine natürliche erneute Anmeldung.
// worker/cron.ts — Cloudflare Workers Cron Trigger (läuft jede Minute)
import { sendNotification } from "web-push"; // VAPID-signiert gemäß RFC 8292
export default {
async scheduled(_controller: unknown, env: Env): Promise<void> {
const now = Date.now();
const due = await env.DB.prepare(`
SELECT e.id, e.user_id, e.sequence_id, e.cursor,
s.template_id, s.require_all
FROM sequence_enrollments e
JOIN sequence_steps s
ON s.sequence_id = e.sequence_id AND s."index" = e.cursor
WHERE e.status = 'active' AND e.next_due_at <= ?
LIMIT 100
`).bind(now).all();
for (const row of due.results) {
const sub = await env.DB.prepare(
"SELECT endpoint, p256dh, auth FROM push_subscriptions WHERE user_id = ?"
).bind(row.user_id).first();
if (!sub) { await markExited(env, row.id); continue; }
try {
await sendNotification(
{ endpoint: sub.endpoint, keys: { p256dh: sub.p256dh, auth: sub.auth } },
JSON.stringify({ templateId: row.template_id, seq: row.sequence_id }),
{ vapidDetails: {
subject: "mailto:you@example.com",
publicKey: env.VAPID_PUBLIC_KEY,
privateKey: env.VAPID_PRIVATE_KEY,
}},
);
await recordDeliveryAndAdvance(env, row.id, row.cursor, sub.endpoint, 201);
} catch (err: any) {
if (err?.statusCode === 404 || err?.statusCode === 410) {
// Abonnement nicht mehr vorhanden — entfernen; der Nutzer meldet sich bei seiner Rückkehr erneut an
await env.DB.prepare("DELETE FROM push_subscriptions WHERE endpoint = ?")
.bind(sub.endpoint).run();
}
// Bei allen anderen Fehlern den Cursor nicht verschieben; der nächste Cron-Lauf versucht es erneut
}
}
},
};
Ein ehrlicher Hinweis zum Deployment: Das beliebte Paket web-push ist auf Node.js ausgerichtet. Auf Workers nutze ich es mit nodejs_compat; alternativ gibt es eine kleinere Hilfsbibliothek für VAPID und Verschlüsselung. Planen Sie für dieses Detail einen Abend ein – es ist der einzige Teil des Stacks, bei dem die Dokumentationen einander widersprechen.
Ist das in Ihrem Stack enthalten? Checkliste für die Kaufentscheidung
Dieser Artikel unterstützt folgende Kaufentscheidung: Der größte Teil der Push-Automatisierung betrifft Zustandsverwaltung, nicht den Versand. Der Versand selbst umfasst etwa 40 Zeilen standardisierten Code. Alles andere – Berechtigungsablauf, Ereignis-Deduplizierung, Anmeldestatus, Wiederholungsversuche und Bereinigung – sind Funktionen, die ein SaaS-Boilerplate entweder mitbringt oder die Sie selbst entwickeln müssen. Prüfen Sie vor der Wahl eines Stacks, ob er Folgendes bietet:
- Einen Ablauf für die Berechtigungsabfrage, der die Benachrichtigungsberechtigung erst durch eine Nutzeraktion anfordert, nicht beim Laden der Seite
- VAPID-Schlüsselverwaltung als Umgebungsvariablen statt fest codierter Werte
- Trigger-Ereignisse, die in eine deduplizierte Ereignistabelle geschrieben werden (nicht nur in den Arbeitsspeicher)
- Einen Sequenz-Runner mit idempotenter Zustellung und Wiederholungslogik
- Ein abfragbares Zustellungsprotokoll sowie eine Bereinigung abgelaufener Abonnements
- Cron-/geplante Ausführung auf dem Server, damit Sequenzen auch nach dem Schließen des Browsers weiterlaufen
Wenn Ihr aktueller Stack drei oder mehr dieser Punkte nicht erfüllt, fehlt Ihnen nur noch eine Integration, um dieses System selbst nachzubauen. Genau diesen Kompromiss sollten Sie vor einer Entscheidung abwägen: Durchsuchen Sie TanStack-Templates, um zu sehen, welche Starter Notification-Infrastruktur enthalten, und sehen Sie sich Preise und Lizenzbedingungen der Templates an, sobald Sie wissen, dass die Funktion vorhanden ist. Der Lizenzpreis ist zweitrangig gegenüber der Frage, ob die Zustandsverwaltung bereits enthalten ist.
Einschränkungen, Offenlegung und was ich nicht gemessen habe
Offenlegung: Ich pflege TanStack Ship. Links zu meinen eigenen Templates stellen daher eine geschäftliche Verbindung dar, die ich hier offenlege. An den hier erwähnten Diensten Dritter verdiene ich nichts. Dieser Beitrag enthält keine Affiliate-Links.
Einschränkungen, offen gekennzeichnet:
- Gemessen: nichts in diesem Beitrag. Ich nenne bewusst keine Öffnungsraten, Klickraten oder Zustellungsquoten meiner eigenen Produkte – ich habe kein Mess-Setup, dessen Ergebnisse ich öffentlich vertreten würde. Eine erfundene Zahl wäre schlechter als gar keine. Wo Sie einen Benchmark erwarten würden, gilt [Quelle erforderlich].
- Vom Nutzer bereitgestellt: Die Search-Console-Zahlen (32 Impressionen, durchschnittliche Position 5,4 über 28 Tage) stammen aus unserem eigenen Produkt und beschreiben das Suchverhalten, nicht die Leistung der Benachrichtigungen.
- Dokumentiert/strukturell: Die RFC-Verhaltensweisen, die Home-Bildschirm-Anforderung unter iOS, die Bedeutung der Statuscodes 201/429/404/410 und die D1-Transaktionsgarantien sind oben anhand von Primärquellen belegt.
- Geschätzt: Die Aussage, dass die Zahl der iOS-Anmeldungen voraussichtlich deutlich unter der Desktop-Zahl liegt, ist eine Designannahme aufgrund der Installationsanforderung für den Home-Bildschirm, kein gemessenes Verhältnis.
- Dieses Schema ist für die SQLite-/D1-Semantik ausgelegt. Bei einer Portierung zu Postgres ändern sich die Regeln für Anführungszeichen und die Transaktionshülle, nicht aber das Datenmodell.
FAQ: Push-Notification-Automatisierung
Was ist Push-Notification-Automatisierung?
Ein ereignisgesteuertes System, das Web-Push-Nachrichten ohne manuellen Versand verschickt: Ein Trigger (Nutzeraktion, Zustandsänderung, Zeitplan oder Inaktivität) erzeugt ein dedupliziertes Ereignis, ein Workflow meldet den Nutzer für eine Sequenz an und ein Datenmodell protokolliert jede Anmeldung und Zustellung, sodass jede Benachrichtigung genau einmal ausgelöst wird.
Worin unterscheidet sich eine Push-Drip-Kampagne von einer E-Mail-Drip-Kampagne?
Die Trigger- und Datenmodell-Ebenen sind nahezu identisch, die Zustellung unterscheidet sich. Push ist an eine Berechtigung gebunden, kurzlebig und eignet sich besonders für zeitkritische Zustände wie das Ende einer Testphase oder ein überschrittenes Kontingent. E-Mail bietet Platz für längere Inhalte und funktioniert auch ohne aktive Browser-Sitzung. Die meisten Produkte betreiben beide Kanäle über denselben Event-Bus.
Funktionieren Web-Push-Benachrichtigungen unter iOS?
Ja, seit iOS und iPadOS 16.4 – aber nur für Web-Apps, die der Nutzer zum Home-Bildschirm hinzugefügt hat. Außerdem muss der Nutzer nach der Installation die Benachrichtigungsberechtigung erteilen. Desktop-Versionen von Chrome, Edge und Firefox unterstützen Web Push für normale Websites. Die Einschränkung betrifft also iOS, nicht den Standard.
Die Entscheidung in einem Satz
Push-Notification-Automatisierung ist ein Problem der Zustandsverwaltung: Modellieren Sie Trigger als deduplizierte Ereignisse, speichern Sie den Anmeldestatus in Ihrer Datenbank und machen Sie die Zustellung mit einer Sperre pro Schritt idempotent. Der nächste konkrete Schritt: Sehen Sie sich die Templates an, die auf TanStack Start + Cloudflare Workers + D1 basieren, und entscheiden Sie, ob Sie diese Benachrichtigungsebene selbst entwickeln oder mit einem Starter beginnen, der sie bereits enthält.