Triggers | mail-error

Het mail-error event is een overkoepelend event dat wordt getriggerd wanneer een fout optreedt by de verzending. Het mail-error-event stelt je in staat om opvolgacties te maken naar aanleiding van een foutmelding, zonder dat je expliciet hoeft op te geven wat voor soort fout er eigenlijk is opgetreden.

Naast het mail-error event zijn er andere events die óók worden getriggerd bij fouten, maar alleen in een bepaalde fase van het proces. Bij het verzenden van een mail worden verschillende stappen doorlopen: er wordt een verbinding gemaakt met een mailserver, het bericht wordt overhandigd en de ontvangende mailserver accepteert of weigert het bericht. Nadat het bericht is geaccepteerd, kan de ontvanger (soms vele uren) later besluiten het bericht alsnog te weigeren en pas dan een bounce terug te sturen. Hier horen de volgende events bij:

  • mail-reject: Wordt getriggerd wanneer de ontvangende mailserver de mailing direct weigert tijdens de SMTP-verbinding met Copernica’s mailserver.
  • mail-bounce: Wordt getriggerd wanneer de ontvangende mailserver de mailing aanvankelijk accepteert, maar later een bounce-e-mail stuurt om de mailing alsnog af te wijzen.

Je kunt beide soorten events afzonderlijk afvangen en in opvolgacties gebruiken. Maar in beide gevallen wordt ook een mail-error getriggerd. Dit event fungeert als een soort overkoepelend event voor zowel mail-reject als mail-bounce, waardoor je geen dubbele opvolgacties hoeft te maken.

Een mailing kan om verschillende redenen worden afgewezen, zoals een volle mailbox of een niet-bestaand e-mailadres. Een volledige lijst met mogelijke redenen is te vinden op de IANA-website.

Beschikbare variabelen

  • {$trigger.error}: De foutmelding die is ontvangen van de mailserver, met de volgende structuur:
    • {$trigger.error.code}: De foutcode van de mailserver.
    • {$trigger.error.recoverable}: Een boolean die aangeeft of bij een volgende poging de mail alsnog geaccepteerd kan worden.
  • {$trigger.profile}: Het profiel van de ontvanger.
  • {$trigger.subprofile}: Het subprofiel van de ontvanger.
  • {$trigger.destination}: Het profiel of subprofiel van de ontvanger. Dit kan een profiel zijn als de mailing naar een hoofdprofiel is gestuurd, of een subprofiel als de mailing specifiek naar een subprofiel is verzonden.
  • {$trigger.senttime}: Het tijdstip waarop de mailing is verzonden.
  • {$trigger.mailing}: De mailing die is verstuurd.
  • {$trigger.template}: De template die is gebruikt voor de mailing.
  • {$trigger.snapshot}: Een snapshot van de template zoals verzonden naar de ontvanger.
  • {$trigger.document}: Voor HTML-mailings is ook het document beschikbaar.

Voorbeeld

Ontvanger: {$trigger.profile.email} heeft mail met onderwerp: {$trigger.snapshot.subject}
als spam gerapporteerd op {$trigger.timestamp}.