Geavanceerde verzendopties
Door speciale properties toe te voegen aan de JSON-input kun je verschillende verzendopties van SMTPeter instellen. Zo kun je bijvoorbeeld clicks, opens en bounces bijhouden, CSS inline laten zetten, afbeeldingen laten hosten of een uiterste aflevertijd instellen.
{
"recipient": "john@doe.com",
"mime": "MIME-Version: 1.0\r\nFrom: <info@example.com>\r\n....",
"inlinecss": true,
"trackclicks": true,
"trackopens": false,
"trackbounces": true,
"preventscam": true,
"tags": [
"tag1",
"tag2"
],
"maxdelivertime": "YYYY-MM-DD hh:mm:ss"
}CSS inline zetten
Door de property inlinecss op true te zetten, zet SMTPeter CSS uit
stylesheets in de header om naar inline attributen in de HTML-code.
Clicks, opens en bounces bijhouden
SMTPeter kan clicks, opens en bounces van verzonden e-mails bijhouden. Hiervoor kan SMTPeter onder andere hyperlinks aanpassen voor clicktracking en informatie aan het bericht toevoegen waarmee opens kunnen worden geregistreerd.
Het envelope-adres van e-mails kan worden aangepast zodat SMTPeter ook bounces kan verwerken.
Je kunt deze vormen van tracking per verzending aan- of uitzetten met de
properties trackclicks, trackopens en trackbounces:
{
"recipient": "john@doe.com",
"mime": "MIME-Version: 1.0\r\nFrom: <info@example.com>\r\n....",
"trackclicks": false,
"trackopens": false,
"trackbounces": false
}Pay attention to tracking and consent
Het bijhouden van clicks en opens kan onder privacy- en cookieregelgeving vallen. Controleer daarom voordat je tracking gebruikt of je hiervoor toestemming of een andere geldige rechtsgrond hebt.
Met
trackclicks,trackopensentrackbounceskun je tracking per verzending uitschakelen. Dit kan bijvoorbeeld handig zijn wanneer je voor bepaalde landen, doelgroepen of ontvangers e-mails zonder tracking wilt versturen.Welke regels precies van toepassing zijn, hangt af van je situatie en de ontvangers van je e-mails. Deze documentatie is alleen bedoeld om je te wijzen op de mogelijke gevolgen van het gebruik van tracking en is geen juridisch advies.
Clicktracking zorgt ervoor dat hyperlinks in een e-mail via SMTPeter lopen, zodat geregistreerd kan worden wanneer een ontvanger erop klikt.
Sommige e-mailclients kunnen een waarschuwing tonen wanneer een link is aangepast. Dit komt met name voor wanneer de zichtbare URL in een e-mail niet overeenkomt met de daadwerkelijke hyperlink.
In dat geval kun je de property preventscam gebruiken. SMTPeter past
dergelijke links dan niet aan:
{
"recipient": "john@doe.com",
"mime": "MIME-Version: 1.0\r\nFrom: <info@example.com>\r\n....",
"trackclicks": true,
"preventscam": true
}De property preventscam voorkomt bijvoorbeeld dat SMTPeter een zichtbare
hyperlink zoals deze aanpast:
<a href="http://www.example.com">www.example.com</a>Instellingen voor Delivery Status Notifications
SMTPeter kan bounces voor je bijhouden. Deze worden normaal verwerkt via het envelope-adres van het bericht.
Wanneer je bouncetracking uitschakelt, kun je zelf een envelope-adres opgeven:
{
"envelope": "your@address.com",
"recipient": "john@doe.com",
"mime": "MIME-Version: 1.0\r\nFrom: <info@example.com>\r\n....",
"trackbounces": false
}In het bovenstaande voorbeeld houdt SMTPeter de bounces niet bij. Niet-aflevermeldingen worden in plaats daarvan naar het opgegeven envelope-adres gestuurd.
Met de optionele property dsn kun je verder instellen welke Delivery Status
Notification-berichten je wilt ontvangen. De property accepteert een
JSON-object met vier optionele velden:
{
"recipient": "john@doe.com",
"mime": "MIME-Version: 1.0\r\nFrom: <info@example.com>\r\n....",
"trackclicks": true,
"preventscam": true,
"dsn": {
"notify": "FAILURE",
"ret": "FULL",
"envid": "your-identifier",
"orcpt": "original@recipient.address.com"
}
}Met notify geef je aan voor welke gebeurtenissen een notificatie moet worden
verstuurd. Mogelijke waarden zijn NEVER, FAILURE, SUCCESS en DELAY. Je
kunt ook een kommagescheiden combinatie van waarden gebruiken.
Met ret bepaal je hoeveel informatie in de notificatie wordt opgenomen. De
mogelijke waarden zijn FULL, voor de volledige e-mail, en HDRS, voor alleen
de headers.
De properties envid en orcpt kun je gebruiken wanneer je meer controle wilt
over de gegevens in de notificatie. De waarde van envid wordt opgenomen in de
property original-envelope-id van het teruggestuurde statusbericht. De waarde
van orcpt wordt opgenomen in de property original-recipient.
Embedded images hosten
Embedded afbeeldingen in MIME-data kunnen soms problemen opleveren. SMTPeter kan deze afbeeldingen uit de MIME halen, hosten en de verwijzingen in het HTML-gedeelte van de MIME aanpassen.
Gebruik hiervoor de property images met de waarde hosted:
{
"images": "hosted"
}Met de waarde default wordt er niets aangepast:
{
"images": "default"
}Een e-mail taggen
Je kunt één of meerdere tags aan een e-mail toevoegen. Deze tags kun je vervolgens gebruiken om bijvoorbeeld clicks en opens te filteren.
Wanneer je bijvoorbeeld een e-mail verstuurt voor een specifieke zomeractie, kun je alle berichten van die actie dezelfde tag geven. Vervolgens kun je de geregistreerde opens en clicks op basis van deze tag filteren.
Tags voeg je als array toe via de property tags:
{
"tags": [
"tag1",
"tag2"
]
}Een tag mag geen whitespace of puntkomma's bevatten.
Een uiterste aflevertijd instellen
E-mails kunnen niet altijd direct worden afgeleverd. De mailserver van een ontvanger kan bijvoorbeeld tijdelijk niet bereikbaar zijn.
Als je niet wilt dat een e-mail na een bepaald moment nog wordt afgeleverd, kun
je de property maxdelivertime toevoegen:
{
"maxdelivertime": "YYYY-MM-DD hh:mm:ss"
}De datum en tijd moeten in UTC worden opgegeven en moeten exact het bovenstaande formaat gebruiken.
Wanneer maxdelivertime is verstreken, probeert SMTPeter het bericht niet meer
af te leveren. Je kunt deze berichten terugvinden in de failure logs.
Standaard probeert SMTPeter een bericht maximaal één dag af te leveren.
Een bericht opnieuw versturen
Wanneer je een bericht via een van de API’s hebt aangeboden en daarvoor een message ID hebt ontvangen, kun je het bericht op basis van dit ID opnieuw versturen.
Dit doe je met een HTTP POST naar www.smtpeter.com/v1/resend, waarbij je
alleen message als parameter meegeeft:
{
"message": "aaabbbcccxxxzzz"
}SMTPeter bouwt het bericht opnieuw op aan de hand van de waarden van het oorspronkelijke bericht. De inhoud en headers blijven gelijk.
Als het oorspronkelijke bericht een template gebruikt, verandert de inhoud niet als je dat template na de eerste verzending aanpast.
Een opnieuw verstuurd bericht krijgt een nieuw message ID. Events voor de nieuwe verzending worden aan dit nieuwe message ID gekoppeld.
