Verlauf und Fehlerbehebung
Jede Aktion, die diese App ausführt, wird protokolliert. Verlauf ist die erste Anlaufstelle, wenn eine E-Mail nicht angekommen ist oder falsch aussah.
Die Liste
Spalten: ID, Name, Typ, Status, Dauer und Ausgeführt am.
Filtern nach:
- Aktionstyp - HTTP-Anfrage oder E-Mail
- Status - Erfolgreich, Fehlgeschlagen oder Ausstehend
Die Suche gleicht mit dem Namen des Layouts oder der Anfrage ab. Wenn Sie über die Schaltfläche Anfrageverlauf einer HTTP-Anfrage hierher gelangen, wird die Liste vorab auf genau diese Anfrage gefiltert - mit einer Schaltfläche Alle Ereignisse anzeigen, um den Filter aufzuheben.
Die zwei Dinge, auf die Sie achten sollten
Ein rotes Badge „Fehlgeschlagen“ bedeutet, dass der Versand oder die Anfrage nicht stattgefunden hat. Öffnen Sie den Eintrag, um den Fehler des Anbieters zu sehen.
Ein gelb-oranges Badge „Leere Variablen“ bedeutet, dass die E-Mail zugestellt wurde, aber ein oder mehrere {{ variables.x }}-Platzhalter zu nichts aufgelöst wurden - der Empfänger hat also eine Nachricht mit einer Lücke erhalten. Das ist der Fehlertyp, der früher unsichtbar war: Die Zeile ist grün, der Anbieter hat die Nachricht angenommen, und nur der Empfänger sieht das Problem.
Die Detailansicht
Beim Öffnen eines Eintrags sehen Sie:
| Karte | Inhalt |
|---|---|
| Warnung Leere Variablen | Welche Platzhalter zu nichts geführt haben und ob Flow sie leer oder gar nicht gesendet hat |
| Ereignisdetails | Ereignis-ID, Aktionstyp, Status, Dauer, Ausführungszeit und die Flow-Ausführungs-ID |
| Fehlermeldung | Der tatsächliche Fehler des Anbieters oder der API, wenn die Aktion fehlgeschlagen ist |
| Anfragedaten | Was gesendet wurde - Empfänger, Absender, aufgelöster Betreff, Variablen oder die aufgelöste HTTP-Anfrage |
| Antwortdaten | Was zurückkam - die Nachrichten-ID des Anbieters oder der HTTP-Status und -Inhalt |
Der Titel zeigt Ihnen, welcher Absender verwendet wurde, zum Beispiel Order email via [email protected] (MICROSOFT).
Eine Aktion erneut senden
Die Detailseite verfügt über eine Schaltfläche Erneut senden. Sie rendert das Layout mit den ursprünglichen Variablen neu und sendet es erneut an die ursprünglichen Empfänger über denselben Absender, oder führt die HTTP-Anfrage genau so erneut aus, wie sie ursprünglich gesendet wurde.
Sie wird sofort ausgeführt und zählt als eine Aktion gegen Ihren Plan. „Erneut senden“ steht für Aktionen, die über den Standard-Fallback-Absender liefen, nicht zur Verfügung.
Häufige Probleme
Die E-Mail ist nie angekommen, und es gibt überhaupt keinen Verlaufseintrag.
Die Aktion wurde nie ausgeführt. Das Problem liegt in Shopify Flow, nicht hier: Prüfen Sie, ob der Workflow aktiviert ist, der Trigger ausgelöst wurde und eine Bedingung tatsächlich zutraf. Tag-Bedingungen stimmen exakt überein, VIP und vip sind also unterschiedlich.
Der Eintrag hat ein Badge „Leere Variablen“. Ihr Layout benötigt eine Variable, die die Flow-Aktion nicht geliefert oder leer geliefert hat. Öffnen Sie den Eintrag, um zu sehen, welche. Ausführliche Anleitung in Daten aus Shopify Flow übergeben.
Eine Test-E-Mail sah gut aus, die reale ist aber leer. Testvariablen im Layout-Editor steuern nur Vorschauen und Test-Sendungen. Ein realer Durchlauf verwendet das Feld „Variablen (JSON)“ der Flow-Aktion, das eine völlig separate Sache ist. Das ist die häufigste Ursache für Verwirrung.
Status ist „Fehlgeschlagen“ mit einem Authentifizierungsfehler. Bei SMTP sind die Zugangsdaten oder der Port falsch - öffnen Sie den SMTP-Server und klicken Sie auf Verbindung testen. Bei Microsoft 365 oder Google muss die Verbindung möglicherweise erneut autorisiert werden: Prüfen Sie unter E-Mail-Absender → Verbundene Konten auf ein Badge Erneute Verbindung erforderlich.
Ein E-Mail-Text zeigt [object Object].
Sie haben ein ganzes Objekt eingesetzt. In E-Mails müssen Sie gezielt darauf zugreifen ({{ variables.customer.firstName }}) oder darüber iterieren. Nur HTTP-Anfragen serialisieren Objekte automatisch zu JSON.
Die Nachricht wurde wegen ihrer Größe abgelehnt. Anhänge mit insgesamt mehr als 20 MB werden blockiert, und Microsoft 365 lehnt mehr als 4 MB an eingebetteten Anhängen ab. Stellen Sie die großen Dateien auf den Modus Link um. Siehe Anhänge und Bilder.
Eine HTTP-Anfrage schlägt mit SSRF blocked fehl.
Das Ziel löst sich zu einer privaten oder internen Netzwerkadresse auf, was aus Sicherheitsgründen verweigert wird. Verwenden Sie einen öffentlich erreichbaren Endpunkt.
Alles schlägt gleichzeitig mit einer Meldung zum Plan-Limit fehl. Sie haben Ihr 30-Tage-Kontingent aufgebraucht. Siehe Pläne und Nutzung.
Sidekick fragen
Shopify Sidekick kann diese App direkt abfragen, nur lesend. Das ist oft schneller, als den Verlauf manuell zu filtern:
- „Sind diese Woche E-Mails fehlgeschlagen?“
- „Warum ist meine letzte E-Mail-Sendung fehlgeschlagen?“
- „Welche E-Mail-Absender sind eingerichtet?“
- „Habe ich eine HTTP-Anfrage für Airtable?“
Sidekick gibt niemals geheime Werte, SMTP-Passwörter, OAuth-Tokens, HTTP-Header-Werte oder Rohdaten zurück - dafür verlinkt es Sie in die App.
Immer noch nicht weiter?
Erstellen Sie einen Fehlerbericht mit Ihrer Shop-Domain, dem Namen des Layouts oder der Anfrage und dem Zeitstempel des Durchlaufs. Siehe Einen Fehler melden im Help Center.