Retour à l'aperçuPour tester une intégration e-mail, on envoie souvent quelques messages à sa propre adresse ou à une adresse jetable. Une ou deux fois, ce n'est pas un problème. Mais si vous le faites à chaque modification, les bounces et les envois répétés peuvent nuire à la réputation de votre domaine.
Le mode sandbox règle ce problème. Vous continuez d'envoyer vos e-mails transactionnels via l'API ou SMTP comme avant, mais aucun n'arrive dans une boîte de réception.
Qu'est-ce que le mode sandbox ?
Le mode sandbox est un réglage propre à chaque projet. Lettermint accepte et traite chaque e-mail normalement, puis s'arrête juste avant de le transmettre au serveur de messagerie du destinataire. Les validations s'appliquent toujours, donc une adresse invalide renvoie la même erreur qu'en production. Chaque e-mail apparaît ensuite dans votre tableau de bord.
Les e-mails d'un projet sandbox ne sont pas décomptés de votre volume mensuel. Ils n'apparaissent pas dans vos statistiques, et un hard bounce simulé n'ajoute jamais d'adresse à votre suppression list.
Comment ça marche
Activer le mode sandbox
Lors de la création d'un projet, choisissez Sandbox comme delivery mode. Pour un projet existant, utilisez l'interrupteur sous Delivery mode dans les Settings. Vos tokens API et vos identifiants SMTP restent les mêmes, vous n'avez donc rien à modifier dans votre code.
Simuler un résultat
Par défaut, chaque e-mail sandbox est marqué comme distribué. Pour voir comment votre application réagit à un hard bounce ou à une spam complaint, ajoutez sandbox_result à votre requête API. Vous envoyez via SMTP ? Utilisez plutôt l'en-tête 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
Les webhooks continuent de fonctionner en mode sandbox, ce qui vous permet de tester vos handlers de bout en bout. Attention toutefois au réglage de chaque webhook. Les nouveaux webhooks sont sur Live par défaut et ne transmettent donc pas les events sandbox. Passez-les sur Sandbox ou Both pour les recevoir pendant vos tests.
Passer en production
Une fois vos tests terminés, passez le projet sur Live et vos e-mails partent vers les vrais destinataires. Assurez-vous d'abord que votre domaine est vérifié, car le mode Live n'envoie que depuis un domaine vérifié.
Disponible avec Starter, Growth et Pro
Le mode sandbox est inclus dans les formules Starter, Growth et Pro. Vous l'activez pour n'importe quel projet depuis votre tableau de bord (ouvre dans une nouvelle fenêtre). La documentation sur le mode sandbox détaille tous les résultats que vous pouvez simuler et explique comment distinguer les events sandbox des events live.