Fehlerbehebung

Diese Seite ist die erste Anlaufstelle für Engage-Probleme.

Sendungen gehen nicht raus

Kampagne hängt in queued

Diagnoseweg:

1. Diagnose öffnen, engage-dispatch-Status prüfen.
2. Letzter Lauf >5 Min her? Cron pausiert/fehlerhaft. Support kontaktieren.
3. Cron okay? Segment-Zähler prüfen.
4. Alle Empfänger gesperrt? Audience-Zahl hoch, Zustellbar-Zahl null.

Probelauf zeigt null Sendungen

Fast immer Consent- oder Sperrproblem.

• Segment enthält marketing_email_consent = true?
• Zielgruppe massenhaft abgemeldet?
• Einstellungen > Sperrliste prüfen.

Kampagne versendet, aber keine Empfänger

Analytik-Funnel prüfen:

• Suppressed > 0
• Bounced > 0
• Delivered = 0 ohne Bounces - Anbieter pausiert

Journey-Probleme

Veröffentlicht, aber keine Runs

Eintrittsauslöser passt nicht:

• Filterausdruck zu restriktiv?
• Re-Entry-Regel never und Fahrer war schon mal drin?
• Auslöser-Ereignis selbst - feuert engage-event-ingest?

Test: Journey mit customer.created ohne Filter, Test-Kunde anmelden. Run innerhalb 5 Min sichtbar.

Run hängt an wait

next_step_due_at auf der Zeile:

• Vergangenheit? engage-journey-Cron stockt.
• Zukunft? Wait noch in Effekt.
• until_event und Ereignis kommt nie? Fallback-Dauer als Sicherheit hinzufügen.

Gleiche Vorlage zweimal für gleichen Fahrer

1. Re-Entry-Regel. every_trigger + häufiges Ereignis → wechseln zu after_cooldown.
2. 24-Stunden-Dedup abgelaufen.

Branch evaluierte falschen Pfad

• Prädikat-Syntax passt zu echtem Feldnamen?
• Operator korrekt?
• Werttyp passt?

Zustellbarkeit

E-Mails landen im Spam

In Reihenfolge:

1. DKIM/SPF/DMARC falsch konfiguriert.
2. DMARC-Policy ist p=none.
3. Hohe Beschwerderate hat Reputation versenkt.
4. Subject/Body sieht nach Spam aus.
5. Listenqualitäts-Problem.

Siehe Absender-Domain einrichten und Sperrliste.

Hohe Bounce-Rate

Spike >2 % bedeutet dreckige Daten:

• Frische Imports ohne Verifizierung?
• Altes Segment lange nicht gereinigt?
• Test-Daten in Prod?

Spam-Beschwerden über 0,1 %

Engage pausiert Stream bei 0,3 %. Darunter Alarm. Ursache vor Wiederaufnahme adressieren.

Variablen-Substitution

Variablen erscheinen wörtlich

Vorlage-Payload ohne Variablen-Wrapper. Vorlage neu öffnen, Doppelklammern bestätigen, speichern.

Variable löst leer/null auf

Feld ist null. Immer default-Filter:

{{customer.first_name | default:"Sie"}}

{{ride.last_at}} zeigt Zeitstempel statt Datum

date-Filter:

{{ride.last_at | date:"D. MMM"}}

{{wallet.balance}} zeigt Zahl, nicht Währung

currency-Filter:

{{wallet.balance | currency}}

Webhook-Probleme

Analytik eingefroren

Anbieter-Webhook-Ingest im Rückstau. Diagnose > Webhook-Lag prüfen.

Postmark-Webhooks feuern nicht

URL in Postmark = https://[ihre-domain]/api/engage/webhooks/postmark. Ereignisse Delivery, Bounce, SpamComplaint, Open, Click, SubscriptionChange aktiv.

Telnyx-STOP wird nicht honoriert

Webhook-URL = https://[ihre-domain]/api/engage/webhooks/telnyx. Messaging-Profil mit eingehenden Ereignissen.

Compliance-Validierungen

"Veröffentlichen nicht möglich: Vorlage ohne Abmeldevariable"

Body braucht {{unsubscribe.url}} im Footer.

"Veröffentlichen nicht möglich: Rechtsanschrift fehlt"

Einstellungen > Geschäftsdetails > Rechtsanschrift ausfüllen.

"Veröffentlichen nicht möglich: SMS-Vorlage ohne STOP-Hinweis"

Vorgefertigte SMS-Vorlagen enthalten "Reply STOP to unsubscribe". Eigene müssen ähnlich enthalten.

Performance

Segment-Vorschau über 10 Sekunden

Komplexe Definition oder Rollup-View langsam. Support kontaktieren.

Sende-Pipeline mit Tausenden gestaut

Ratenlimits in Einstellungen > Ratenlimits. Standards: 1000 E-Mails / 5 Min, 100 SMS / Min, 5000 Push / Min.

Account / Provisionierung

Engage-Tab nicht in Seitenleiste

Engage nur in Pro- und Enterprise-Tarifen. Einstellungen > Abrechnung prüfen.

Vorlagen > Levy-Recommended-Tab leer

Seed nicht gelaufen. Vorlagen laden klicken.

Eigene Absender-Domain hängt in pending

DNS propagiert nicht. dig TXT nutzen.

Logs und Diagnose

1. Diagnose zeigt Live-System-Gesundheit.
2. Analytik > Audit-Log exportieren gibt Compliance-Trail.
3. Browser-Devtools-Konsole zeigt API-Fehler.

Bei Support-Kontakt mitschicken:

• Kampagnen-ID oder Journey-ID
• Zeitstempel
• Screenshot

---