Zurück zur ÜbersichtWer eine E-Mail-Integration testet, schickt meist ein paar E-Mails an die eigene Adresse oder an eine Wegwerfadresse. Ein- oder zweimal ist das kein Problem. Passiert das aber bei jeder Änderung, können Bounces und wiederholte Sendungen dem Ruf Ihrer Domain schaden.
Mit dem Sandbox-Modus fällt dieses Risiko weg. Sie versenden Ihre Transactional E-Mails wie bisher über die API oder SMTP, nur landet keine davon in einem Postfach.
Was ist der Sandbox-Modus?
Der Sandbox-Modus ist eine Einstellung pro Projekt. Lettermint nimmt jede E-Mail an und verarbeitet sie wie gewohnt, übergibt sie aber nicht an den Mailserver des Empfängers. Die Validierung läuft trotzdem, eine ungültige Adresse liefert also dieselbe Fehlermeldung wie im Live-Betrieb. Jede E-Mail sehen Sie anschließend in Ihrem Dashboard.
E-Mails aus einem Sandbox-Projekt zählen nicht zu Ihrem monatlichen Kontingent. Sie tauchen nicht in Ihren Statistiken auf, und ein simulierter Hard Bounce landet nie auf Ihrer Suppression List.
So funktioniert es
Sandbox-Modus aktivieren
Wählen Sie beim Anlegen eines Projekts Sandbox als Delivery Mode. Bei einem bestehenden Projekt finden Sie den Schalter unter Delivery mode in den Settings. Ihre API-Tokens und SMTP-Zugangsdaten bleiben gleich, an Ihrem Code ändert sich also nichts.
Ergebnis simulieren
Standardmäßig wird jede Sandbox-E-Mail als zugestellt markiert. Möchten Sie sehen, wie Ihre Anwendung mit einem Hard Bounce oder einer Spam Complaint umgeht, setzen Sie sandbox_result in der API-Anfrage. Beim Versand über SMTP nutzen Sie stattdessen den Header X-Lettermint-Sandbox-Result.
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
Webhooks werden auch im Sandbox-Modus ausgelöst. So testen Sie Ihre Handler von Anfang bis Ende. Achten Sie dabei auf die Einstellung des Webhooks. Neue Webhooks stehen standardmäßig auf Live und leiten Sandbox-Events nicht weiter. Stellen Sie sie auf Sandbox oder Both, um sie beim Testen zu empfangen.
Live gehen
Sind Sie mit dem Testen fertig, stellen Sie das Projekt auf Live. Ab dann gehen Ihre E-Mails an echte Empfänger. Prüfen Sie vorher, ob Ihre Domain verifiziert ist, denn im Live-Modus versenden Sie nur von verifizierten Domains.
Verfügbar in Starter, Growth und Pro
Der Sandbox-Modus ist in den Tarifen Starter, Growth und Pro enthalten. Sie aktivieren ihn für jedes Projekt in Ihrem Dashboard (wird in einem neuen Fenster geöffnet). In der Dokumentation zum Sandbox-Modus finden Sie alle Ergebnisse, die Sie simulieren können, und wie Sie Sandbox-Events von Live-Events unterscheiden.