Met sandbox mode test je e-mails zonder ze te versturen

Ontwikkel je een nieuwe applicatie of koppel je Lettermint aan een bestaand project, dan wil je testen of je e-mails goed aankomen. Vaak gaat zo'n testmail naar je eigen adres of naar een testadres. Een paar keer kan dat geen kwaad. Doe je het vaak, dan kan de reputatie van je domein eronder lijden.

Daarom hebben we sandbox mode toegevoegd. Je verstuurt je transactional e-mails zoals je gewend bent, alleen komen ze nergens aan.

Wat is sandbox mode?

Sandbox mode is een instelling per project. Lettermint verwerkt je e-mails dan op dezelfde manier als altijd, maar stuurt ze niet door naar de mailserver van de ontvanger. Gaat er iets mis, zoals een ongeldig adres, dan krijg je dezelfde foutmelding als in productie. De e-mail zelf vind je terug in je dashboard.

E-mails uit een sandbox-project tellen niet mee in je maandelijkse verbruik. Ze komen ook niet in je statistieken terecht, en een gesimuleerde hard bounce zet niemand op je suppression list.

Hoe werkt het?

Sandbox mode aanzetten

Bij het aanmaken van een project kies je Sandbox als delivery mode. Heb je al een project, dan vind je de toggle onder Delivery mode in de Settings. Je API-tokens en SMTP-gegevens veranderen niet mee, dus in je code hoef je niets aan te passen.

Een resultaat simuleren

Zonder extra instellingen krijgt elke e-mail de status bezorgd. Wil je weten hoe je applicatie omgaat met een hard bounce of een spam complaint? Geef dat resultaat dan mee met sandbox_result in de API, of met de header X-Lettermint-Sandbox-Result als je via SMTP verstuurt.

          curl -X POST "https://api.lettermint.co/v1/send" \
  -H "Content-Type: application/json" \
  -H "x-lettermint-token: lm_project_token" \
  -d '{
    "from": "sender@acme.com",
    "to": ["recipient@acme.com"],
    "subject": "Welcome to Acme",
    "text": "Thanks for signing up.",
    "sandbox_result": "hard_bounced"
  }'

        

Webhooks

Ook in sandbox mode krijgt je applicatie webhooks voor elk event. Let wel op de instelling per webhook. Nieuwe webhooks staan op Live en sturen sandbox-events dus niet door. Zet ze op Sandbox of Both als je ze tijdens het testen wilt ontvangen.

Van sandbox naar live

Klaar met testen? Zet het project op Live en je e-mails gaan naar de echte ontvangers. Verifieer wel eerst je domein, want zonder geverifieerd domein verstuur je in Live mode niets.

Beschikbaar op Starter, Growth en Pro

Sandbox mode zit in de Starter, Growth en Pro abonnementen. Je zet het aan voor een nieuw of bestaand project in je dashboard (opent in een nieuw venster). Welke resultaten je allemaal kunt simuleren en hoe je events uit sandbox mode herkent, lees je in de documentatie over sandbox mode.