Geschiedenis en probleemoplossing
Bekijk de geschiedenis van elke e-mail en elk HTTP-verzoek in Shopify Flow, filter op status of type en los mislukte verzendingen snel op.
Elke actie die deze app uitvoert, wordt geregistreerd. De geschiedenis is de eerste plaats waar u moet kijken wanneer een e-mail niet is aangekomen of er onjuist uitzag.
De lijst
Kolommen: ID, Naam, Type, Status, Duur en Uitgevoerd op.
Filteren op:
- Type actie - HTTP-verzoek of e-mail
- Status - Geslaagd, Mislukt, In behandeling of Overgeslagen (afgemeld)
De zoekfunctie zoekt op de naam van de lay-out of het verzoek. Als u hier terechtkomt via de knop ‘Verzoekgeschiedenis’ van een HTTP-verzoek, wordt de weergave vooraf gefilterd op dat ene verzoek; met de knop ‘Alle gebeurtenissen weergeven’ kunt u deze filtering opheffen.
Exporteren als CSV
Als u bovenaan de pagina ‘Geschiedenis’ op** ‘CSV exporteren’** klikt, wordt de lijst precies zo gedownload als deze op dit moment is gefilterd: de zoekopdracht en alle filters die u hebt ingesteld, zijn ook van toepassing op de export. Het bestand krijgt de naam history-<date>.csv en bevat maximaal de 50.000 meest recente gebeurtenissen. Als uw filters meer dan dat aantal resultaten opleveren, zal de app u dit na het downloaden melden; verscherp de filters (bijvoorbeeld tot één lay-out of één status) om oudere gebeurtenissen te kunnen bekijken.
Kolommen: Datum (UTC), ID, Type, Status, Lay-out of verzoek, Ontvangers, CC, BCC, Onderwerp, Fout en Duur (ms). Kolomnamen en statuslabels worden weergegeven in de taal van uw beheerdersinterface. De velden Ontvangers, CC, BCC en Onderwerp worden alleen ingevuld voor e-mails. De export bevat de gegevens die in de lijst ‘Geschiedenis’ worden weergegeven: flowvariabelen, verzoekteksten en antwoorden worden hierin niet opgenomen.
De drie zaken waarop u moet letten
Een rode ‘Mislukt’-badge geeft aan dat de verzending of het verzoek niet is uitgevoerd. Open de badge om de foutmelding van de aanbieder te bekijken.
Een oranje ‘Lege variabelen’-badge geeft aan dat de e-mail is afgeleverd, maar dat een of meer {{ variables.x }}-plaatshouders niet zijn weergegeven - waardoor de ontvanger een bericht heeft ontvangen met een leeg gedeelte erin. Dit is de fout die voorheen onzichtbaar was: de rij is groen, de provider heeft het bericht geaccepteerd en alleen de ontvanger ziet het probleem.
Een grijze ‘Skipped’-badge betekent dat een marketing-e-mail niet is verzonden omdat alle ontvangers in het veld ‘Aan’ zich hadden afgemeld voor uw marketing-e-mails. Dit is geen fout, het telt niet mee voor uw abonnementen en wordt niet meegenomen in het slagingspercentage. Zie Marketingmails en afmeldingen.
Het detailoverzicht
Wanneer u een item opent, wordt het volgende weergegeven:
| Kaart | Inhoudsopgave |
|---|---|
| Waarschuwing inzake lege variabelen | Welke plaatshouders leverden geen resultaten op, en of Shopify Flow deze leeg of helemaal niet heeft verzonden |
| Niet verzonden: de ontvanger heeft zich afgemeld | Wordt weergegeven bij een overgeslagen gebeurtenis in plaats van bij een fout, met een link naar ‘Afmelden’ |
| Details van het evenement | Gebeurtenis-ID, actietype, status, duur, uitvoeringstijd en de Shopify Flow-uitvoerings-ID |
| Foutmelding | De daadwerkelijke foutmelding van de provider of API, wanneer de actie is mislukt |
| Gegevens opvragen | Wat er is verzonden - ontvangers, afzender, verwerkte onderwerpregel, variabelen of het verwerkte HTTP-verzoek. Bij een marketing-e-mail is to de lijst met ontvangers nadat de afgemelde adressen zijn verwijderd, en geeft suppressed aan hoeveel er zijn verwijderd. Bij een e-mail met een bijlage uit een metaveld wordt via orderId of customerId bijgehouden welke bestelling of welke klant is bekeken. |
| Responsgegevens | Wat werd teruggestuurd: het bericht-ID van de provider, of de HTTP-status en de inhoud? Bij een marketing-e-mail vermeldt recipients elke ontvanger in het veld „Aan“ met sent, failed of skipped, samen met het eigen bericht-ID of de foutmelding |
Uit de titel blijkt welke afzender is gebruikt, bijvoorbeeld Order email via support@acme.com (MICROSOFT).
Een marketing-e-mail wordt verzonden als één bericht per ontvanger in het veld „Aan“, maar vormt één gebeurtenis in de geschiedenis. De gebeurtenis wordt als „Geslaagd“ aangemerkt wanneer elke ontvanger zijn bericht heeft ontvangen. De gebeurtenis wordt als „Mislukt“ aangemerkt zodra één bericht niet is afgeleverd nadat een ander bericht al was verzonden; in het foutbericht wordt dan vermeld wie niet is bereikt, en het veld recipients in de responsgegevens geeft aan wie het bericht wel heeft ontvangen.
Een actie opnieuw verzenden
Op de detailpagina bevindt zich een knop ‘Opnieuw verzenden’. Hiermee wordt de lay-out opnieuw weergegeven met de oorspronkelijke variabelen en wordt het bericht via dezelfde afzender opnieuw naar de oorspronkelijke ontvangers verzonden, of wordt het HTTP-verzoek precies zo opnieuw uitgevoerd als het oorspronkelijk was verzonden.
De actie wordt onmiddellijk uitgevoerd en telt als één actie binnen uw abonnement. Opnieuw verzenden is niet mogelijk voor acties die via de standaardvervangende afzender zijn verzonden.
Een overgeslagen gebeurtenis heeft geen knop ‘Opnieuw verzenden’: er is niets verzonden, dus er valt ook niets opnieuw te verzenden. Voer de workflow opnieuw uit zodra de klant zich opnieuw heeft aangemeld. Bij het opnieuw verzenden van een marketing-e-mail wordt de lijst met afgemelde ontvangers opnieuw gecontroleerd en worden alle personen weggelaten die zich sinds de oorspronkelijke verzending hebben afgemeld; indien er dan niemand meer overblijft, wordt het opnieuw verzenden geweigerd.
Veelvoorkomende problemen
De e-mail is nooit aangekomen en er is helemaal geen vermelding in de geschiedenis. De actie is nooit uitgevoerd. Het probleem zit in Shopify Flow, niet hier: controleer of de workflow is ingeschakeld, of de trigger is geactiveerd en of er daadwerkelijk aan een voorwaarde is voldaan. De tagvoorwaarden komen exact overeen, dus VIP en vip zijn verschillend.
Het invoerveld is voorzien van een badge ‘Lege variabelen’. Uw lay-out vraagt om een variabele die de Shopify Flow-actie niet heeft geleverd, of die leeg is geleverd. Open het invoerveld om te zien welke. Een volledige handleiding vindt u op Gegevens doorgeven vanuit Shopify Flow.
Het bericht is overgeslagen. Het gaat om een marketinglay-out en alle ontvangers staan op uw lijst met afmeldingen, waardoor de app het bericht niet heeft verzonden. Dit betekent dat de afmeldfunctie naar behoren werkt. Als het om een e-mail gaat die de klant moet ontvangen, zoals een bestelbevestiging of een verzendupdate, hoort deze thuis in een transactionele lay-out. Zie Marketingmails en afmeldingen.
Een test-e-mail zag er prima uit, maar de daadwerkelijke e-mail is leeg. Testvariabelen in de lay-outeditor zijn uitsluitend van invloed op voorbeelden en testverzendingen. Bij een daadwerkelijke verzending wordt gebruikgemaakt van het veld ‘Variabelen (JSON)’ van de Shopify Flow-actie, wat iets geheel anders is. Dit is de meest voorkomende bron van verwarring.
De status is ‘Mislukt’ met een authenticatiefout. Voor SMTP zijn de inloggegevens of de poort onjuist - open de SMTP-server en klik op ‘Verbinding testen’. Voor Microsoft 365 of Google moet de verbinding mogelijk opnieuw worden geautoriseerd: controleer onder ‘E-mailafzenders’ → ‘Gekoppelde accounts’ of er een badge met de tekst ‘Opnieuw verbinden vereist’ staat.
In de tekst van een e-mail staat [object Object]. U hebt een volledig object geïnterpoleerd. In e-mails moet u er toegang toe verkrijgen ({{ variables.customer.firstName }}) of er een lus over uitvoeren. Alleen HTTP-verzoeken serialiseren objecten automatisch naar JSON.
Het bericht is geweigerd vanwege de grootte. Bijlagen met een totale grootte van meer dan 20 MB worden geblokkeerd, en Microsoft 365 weigert inline-bijlagen die groter zijn dan 4 MB. Schakel voor grote bestanden over naar de linkmodus. Zie Bijlagen en afbeeldingen.
Een HTTP-verzoek mislukt met de foutmelding SSRF blocked. Het bestemmingsadres verwijst naar een privé- of intern netwerkadres, wat om veiligheidsredenen wordt geweigerd. Gebruik een openbaar bereikbaar eindpunt.
Alles valt in één keer uit en er verschijnt een melding over de limiet van uw abonnement. U hebt uw 30-dagenquotum opgebruikt. Zie Abonnementen en gebruik.
Vraag aan Sidekick
Shopify Sidekick kan deze app rechtstreeks raadplegen, uitsluitend in leesmodus. Dit gaat vaak sneller dan het handmatig filteren van de geschiedenis:
- "Zijn er deze week e-mails mislukt?"
- "Waarom is het verzenden van mijn laatste e-mail mislukt?"
- "Welke e-mailafzenders zijn ingesteld?"
- "Heb ik een HTTP-verzoek voor Airtable?"
Sidekick geeft nooit geheime waarden, SMTP-wachtwoorden, OAuth-tokens, HTTP-headerwaarden of onbewerkte payloads weer - daarvoor wordt u doorgestuurd naar de app.
Nog steeds vast
Dien een bugrapport in met het domein van uw winkel, de naam van de lay-out of het verzoek, en de tijdstempel van de uitvoering. Zie „Een bug melden“ in het Helpcentrum.