E-Mail-Automatisierung — Admin-Bereich-Builder
Erstelle ein branchenführendes E-Mail-Automatisierungssystem im Admin-Panel deiner bestehenden App. Es beobachtet das Nutzerverhalten, meldet Personen in die passende Lifecycle-Sequenz ein und sendet persönliche, einzeln zugestellte Erinnerungs-E-Mails über die bereits konfigurierte E-Mail-Verbindung der App – basierend auf bewährtem Funnel-Timing, nicht auf Massenversand.
Ziel: Rückkehr-, Kauf- und Bindungsrate steigern – ohne jemanden zu spammen und ohne etwas zu beschädigen, das bereits funktioniert.
Lies dies zuerst: Dieses Skill ist von Natur aus nicht disruptiv. Es untersucht die App, bevor es sie verändert, fügt nur neue Tabellen/Routen hinzu (überschreibt nie bestehende Abläufe), verwendet die E-Mail-Verbindung der App wieder und wird im Ruhezustand ausgeliefert. Es wird nichts gesendet, bis ein Administrator es explizit aktiviert.
Der Arbeitsablauf
0. Erkunden ─▶ 1. Entwerfen ─▶ 2. Bauen ─▶ 3. Ereignisse verknüpfen ─▶ 4. Admin-UI ─▶ 5. Überprüfen ─▶ 6. Übergeben
die App Datenmodell neue Tabellen/ Auslöser → Dashboard + Testlauf + Ruhezustand +
+ Admin + Sequenzen Worker/Cron Einschreibungen Tabellen + Stats Vorschau „Einschalten?“
0. Erkunden (zwingend, vor jedem Code)
Untersuche die App gründlich und erstelle einen kurzen Integrationsplan. Siehe references/discovery.md.
- Ermittle den Stack, das Framework, ORM/DB, Auth, Sessions und das Admin-Panel (oder stelle dessen Fehlen fest).
- Finde die vorhandene E-Mail-Verbindung (SMTP/Provider-SDK) – verwende sie wieder; füge niemals eine zweite hinzu.
- Kartiere Produkte, Warenkorb/Checkout, Bestellungen, Benutzer und die benötigten Ereignisse.
- Verstehe den Zweck und das Geschäftsmodell der Plattform (E-Commerce, SaaS, Fintech, Buchung, …), ihr Aktivierungsereignis und ihre kritischen Account-Schritte – schlage dann zusätzliche Erinnerungssequenzen vor, die passen (E-Mail-Verifizierung, Profilvervollständigung, Onboarding, KYC, Testversion/Rechnung, Buchung, Verlängerung, …).
- Wenn es kein Admin-Panel gibt, frage den Benutzer, ob ein minimales erstellt werden soll.
1. Entwerfen
- Definiere das Datenmodell (
examples/data-model.md): Sequenzen, Schritte, Einschreibungen, geplante E-Mails, Sendelog, Einstellungen, Unterdrückungen. - Wähle den Sequenzsatz und die Timings (
references/sequences.md).
2. Bauen (nur hinzufügend)
- Füge neue Tabellen/Collections, einen Scheduler-Job und den Send-Worker hinzu. Ändere keine vorhandenen Tabellen.
- Füge einen Feature-Flag / Master-Pause-Schalter (Standard AUS) und einen globalen Not-Aus-Schalter hinzu.
3. Ereignisse verknüpfen
- Hake die vorhandenen Ereignisse der App (Registrierung, Login, Warenkorb hinzufügen, Checkout starten, Kauf, Inaktivität) in die Einschreibung ein – ohne ihr Verhalten zu ändern (beobachten, nicht eingreifen).
4. Admin-UI
- Füge ein Menü der obersten Ebene „E-Mail-Automatisierung“ mit den Reitern Sequenzen · Empfänger · Statistik · Einstellungen hinzu. Siehe
references/admin-ui.md. - Füge Admin-Tabellen für gekaufte / abgebrochene Artikel am unteren Rand von Produkt- und Checkout-Seiten hinzu.
5. Überprüfen
- Testlauf-Modus, ein Vorschau-/Testversand-Tool, Idempotenzprüfungen und ein Stoppbedingungs-Audit.
6. Übergeben
- Das System wird im Ruhezustand ausgeliefert. Informiere den Administrator, zeige einen Ein-Klick-„Einschalten“-Button (oder lass den Agenten helfen) und dokumentiere den Rollback.
Der Sequenzkatalog (bewährtes Funnel-Timing)
Vollständige Details, Textabsicht und Stoppbedingungen: references/sequences.md. Zusammenfassung:
| # | Sequenz | Auslöser | Timing (Standard) | Stoppt, wenn |
|---|---|---|---|---|
| 1 | Willkommen / Aktivieren | Registrierung | 0h Willkommen → 24h Wert → 72h sozialer Beweis | Login / Kauf |
| 2 | Registriert, nie eingeloggt | Registriert + kein Login | 1h → 24h → 72h | Login |
| 3 | Eingeloggt, kein Kauf / keine Nutzung | Eingeloggt, inaktiv | 1h Erinnerung → 24h → 5d | Kauf / Aktivierung |
| 4 | Verlassener Warenkorb / Checkout / Produkt | Warenkorb oder Checkout oder Produktansicht, kein Kauf | 1h Erinnerung (ohne Rabatt) → 24h sozialer Beweis / Einwand → 48–72h Dringlichkeit + Rabatt | Kauf |
| 5 | Bewertung nach Kauf | Kauf (produkttypabhängig) | Nächster Tag „Wie läuft's?“ → 2 Wochen „Erfahrung + Upsell“ | Bewertung / Abbestellung |
| 6 | Upsell / Cross-Sell | Kauf, andere Produkte existieren | Nach dem Wertmoment (3–7 Tage) | Kauf des beworbenen Artikels |
| 7 | Rückgewinnung / Reaktivierung | Inaktiv 30 / 60 / 90 Tage | Neutral → Wert → Final „Wir stellen ein“ | Aktivität / Abbestellung |
| 8 | Nachfüllung | Verbrauchsprodukt | ~Tag 45–60 | Wiederkauf |
Rabatte: Upsells dürfen einen Rabatt enthalten; verlassene Warenkörbe führen Dringlichkeit + Rabatt. Standard 0% – bei 0 darf die E-Mail keinen Rabatt erwähnen. Eine Mindestwarenkorbschutz überspringt den Anreiz bei sehr niedrigen Warenkörben. (references/sequences.md.)
Priorität: Ein Benutzer ist in höchstens einer Werbeaktion – Kauf > Warenkorb > Surfen > Willkommen > Kein-Login > Inaktiv > Rückgewinnung. Zusätzliche Sequenzen: Surfen-Abbruch, Wieder-auf-Lager, Preisnachlass, Mahnung, Empfehlung. Siehe references/sequences.md.
Plus plattformabgeleitete Sequenzen, die aus dem Zweck der App ermittelt werden – z. B. E-Mail-Verifizierung, Profilvervollständigung, Onboarding-Setup, KYC, Ablauf Abrechnung/Testversion, Buchungserinnerungen, Verlängerungen. Füge nur die hinzu, die die Plattform erkennen und nutzen kann (references/sequences.md).
Nicht verhandelbare Regeln
- Erst studieren, dann bauen. Ändere niemals vorhandene Auth-, Warenkorb-, Checkout-, Bestell- oder Benutzerabläufe. Füge nur neue Tabellen/Routen hinzu.
- Verwende die vorhandene E-Mail-Verbindung wieder. Keine zweite SMTP-/Provider-Einrichtung. Kein Massen-/Stapelversand – E-Mails sind pro Benutzer und ereignisgesteuert.
- Wird im Ruhezustand ausgeliefert. Master-Schalter AUS; Administrator wird benachrichtigt, um es einzuschalten (der Agent kann Hilfe anbieten).
- Kein Spam. Frequenzbegrenzungen (Standard ≤1 Werbe-E-Mail/Benutzer/24h, ≤4/Woche), Ruhezeiten und eine globale Unterdrückungsliste (Abbestellt, Zurückgewiesen, Beschwert). Respektiere Interesse und Einwilligung.
- Stoppbedingungen gewinnen immer. Überprüfe das Ziel (Kauf/Login/Aktivierung) vor jedem Versand, sodass Käufer keine Warenkorb-Erinnerungen erhalten.
- Persönlicher, individueller Text. „Von“ einer echten Person (
Name from Brand), persönlich formuliert, verweist auf das tatsächliche Produkt, ein klarer CTA und ein „Admin kontaktieren“-Link in jeder E-Mail. - Zustellbarkeit + Rechtliches. SPF/DKIM/DMARC, markierte Versanddomain, HTML + Klartext, Abbestellung + physische Adresse, keine Spam-Triggerwörter. Siehe
references/sending-and-compliance.md. - Alles prüfbar. Jeder Versand wird protokolliert (wer, welche Sequenz/Schritt, wann, warum) und jede geplante E-Mail ist im Admin sichtbar.
- Schönheit + Nahtlosigkeit. Passe dich an die Design-Tokens der App an; der Admin-Bereich muss wie nativer Bestandteil wirken. Verwende die
reviews-to-features-ähnliche Strenge: klare Hierarchie, 44px Ziele, zugänglicher Kontrast. - Kostenloser WYSIWYG-Editor für E-Mail-Inhalte. Der Administrator bearbeitet jede E-Mail-Vorlage in einem kostenlosen, selbst gehosteten WYSIWYG-Editor (TinyMCE Community; oder Quill / TipTap / Summernote / GrapesJS). Ausgabe muss E-Mail-sicher sein (Inline-CSS, Tabellen, ~600px, kein JS), bereinigt, mit Merge-Tokens, einem bedingten Rabattblock und einem automatisch generierten Klartext-Pendant.
Nicht-Störungsvertrag (durchgesetzt)
„Nicht disruptiv“ wird überprüft, nicht nur angenommen. Vollständige Checkliste: references/non-disruption.md. Mindestens:
- Sichere die DB vor der Migration; Migrationen sind hinzufügend + umkehrbar (keine Änderung vorhandener Tabellen).
- Hooks sind beobachtend und in
try/catcheingeschlossen – ein fehlschlagender Beobachter darf niemals Registrierung/Login/Checkout/Zahlung unterbrechen. - Wird im Ruhezustand ausgeliefert mit einem globalen Not-Aus-Schalter; verwende die vorhandene E-Mail-Verbindung wieder.
- Rauchtest alle fünf Kernabläufe nach der Installation; führe einen Rollback-Drill durch (deaktivieren → Tabellen löschen → unbeeinträchtigt bestätigen).
Admin-Oberfläche (was der Administrator bekommt)
- Ruhiges, aufgeräumtes Layout – ≤4 Reiter, eine primäre Aktion pro Ansicht, Details in einer Seitenleiste, sekundäre / destruktive Aktionen in einem Überlauf-Menü (
⋯), erweiterte Einstellungen eingeklappt, Gesundheitsbanner nur bei Bedarf. - Gesundheitsbanner oben auf jedem Reiter (nur bei Problemen): kein E-Mail-Transport konfiguriert, Scheduler/Cron läuft nicht (mit detailliertem Grund und Anleitung zur Behebung) und Automatisierung pausiert. Siehe
references/health-checks.md. - Menü „E-Mail-Automatisierung“ (oberste Ebene) mit Reitern:
- Sequenzen – pro Sequenz Start / Pause / Löschen (Löschen wird bestätigt + soft-deleted/wiederherstellbar, im
⋯versteckt), Verzögerungen, Rabatte, Stoppbedingungen, ein kostenloser WYSIWYG-Editor und Schritte hinzufügen / umsortieren / löschen. - Benutzer & Empfänger – suche einen Benutzer per E-Mail; klappe seine Sequenz von E-Mails mit dem Pfeil nach unten auf; storniere eine bestimmte E-Mail oder schließe den Benutzer vollständig aus; plus das vollständige Sendelog paginiert zu 100 mit wann und warum.
- Statistik – von Benutzern, die eine Erinnerung erhalten haben, wie viele konvertiert sind, Umsatz, Diagramm nach Tag / Woche / Monat.
- Einstellungen – Absender (Von-Name/Von-E-Mail/Antwort-an/physische Adresse), Master-Pause, Begrenzungen, Ruhezeiten.
- Sequenzen – pro Sequenz Start / Pause / Löschen (Löschen wird bestätigt + soft-deleted/wiederherstellbar, im
- Admin-Tabellen am unteren Rand von Produkt- und Checkout-Seiten:
- Reiter Gekauft / Abgebrochen – deutlich als „Nur für Admins“ gekennzeichnet.
- Spalten: E-Mail (→ Benutzerpanel), Registrierungs-/Login-/Abbruchzeitpunkte, fälliger Betrag, Telefon (→
tel:-Anruf) und ein Pfeil, der erhaltene + geplante E-Mails anzeigt, mit Link zum Benutzerpanel zum Stornieren/Ausschließen. - Kann über E-Mail-Automatisierung → Einstellungen deaktiviert werden, mit Anleitung unter dem Tabellentitel + Link.
Vollständige UI-Spezifikation: references/admin-ui.md.
Wann NICHT zu verwenden
- Keine rechtsgültige Einwilligungsbasis für Werbe-E-Mails (biete zuerst einen Einwilligungsprozess an).
- Sehr kleine Benutzerbasen, bei denen Automatisierungslärm den Wert übersteigt – sende manuell.
- Produkte, bei denen E-Mail nicht der Kanal ist (SMS/Push-first) – passe die Engine an, erzwinge kein E-Mail.
- Regulierte Kontexte (Gesundheit/Finanzen) mit strengeren Anforderungen – hole Freigabe für Texte und Datenflüsse ein.
- Hochsensible Transaktionsanforderungen – leite niemals Belege / Sicherheits-E-Mails durch dieses System.
Vom Agenten zu erstellende Ergebnisse
references/discovery.md→ ein Integrationsplan für die jeweilige App, einschließlich einer vorgeschlagenen Sequenz-Kurzliste, abgeleitet vom Zweck der Plattform.- Neue Tabellen/Migrationen + der Scheduler + Send-Worker (hinzufügend).
- Die Ereignis-Hooks (nur beobachtend).
- Die Admin-Seite „E-Mail-Automatisierung“ + Reiter + Statistik-Diagramm, einschließlich eines kostenlosen WYSIWYG-Editors, Schritte hinzufügen / umsortieren / löschen, einer Benutzersuche + Stornierung/Ausschluss pro E-Mail und Gesundheitswarnungen (pausiert, Cron läuft nicht, kein Mail-Transport).
- Die Admin-Tabellen für Gekauft / Abgebrochen.
- Ein Vorschau-/Testversand-Tool + Testlauf + Rollback-Notizen.
- Ein kurzes Übergabedokument: was hinzugefügt wurde, wie man es einschaltet, wie man es pausiert, wie man es zurücksetzt.
Referenzen
references/discovery.md– untersuche die App, finde das Admin-Panel, wähle einen Integrationspfad.references/non-disruption.md– der durchgesetzte Nicht-Störungsvertrag (Backup, umkehrbare Migrationen, Hook-Isolation, Rauchtest, Rollback-Drill).references/triggers.md– genaue Erkennungsregeln für jeden Auslöser (Warenkorb-Abbruch, Inaktivität usw.).references/sequences.md– der vollständige Sequenzkatalog, Priorität, Timing, Textabsicht, Stoppbedingungen.references/email-copy.md– persönliche „Von einer Person“-Textstandards, Betreffzeilen, Vorlagen.references/sending-and-compliance.md– Scheduler, Idempotenz, Begrenzungen, Zustellbarkeits-Vorabprüfung.references/compliance.md– Einwilligung, signierte Abbestellung, Präferenzzentrum, Bounce-/Beschwerde-Webhooks.references/admin-ui.md– das Dashboard, Benutzer-Reiter (Suche/Stornieren/Ausschließen), Log (100/Seite), Statistik, Admin-Tabellen, WYSIWYG, Schritte hinzufügen/bearbeiten.references/health-checks.md– Pause / Cron-läuft-nicht / Kein-Transport-Warnungen mit Anleitung zur Behebung.references/reference-implementation.md– die Engine in Pseudocode + SQL (Sperren, Reaper, Attribution).examples/worker.mjs+examples/worker.test.mjs– ausführbarer, getesteter Scheduler/Worker-Kern.examples/data-model.md– DB-Schema.examples/sequence-config.json– eine konkrete, bearbeitbare Sequenzkonfiguration.examples/email-templates.md– Beispiel gerenderter E-Mails.