Volver al resumenPara probar una integración de correo, lo habitual es enviar algunos mensajes a tu propia dirección o a una dirección desechable. Una o dos veces no pasa nada. Pero si lo haces cada vez que cambias algo, los bounces y los envíos repetidos pueden perjudicar la reputación de tu dominio.
El modo sandbox resuelve eso. Sigues enviando tus correos transaccionales por la API o SMTP igual que antes, pero ninguno llega a una bandeja de entrada.
¿Qué es el modo sandbox?
El modo sandbox es un ajuste de cada proyecto. Lettermint acepta y procesa cada correo de forma normal, y se detiene justo antes de entregarlo al servidor de correo del destinatario. Las validaciones siguen activas, así que una dirección no válida devuelve el mismo error que en producción. Cada correo aparece después en tu panel.
Los correos de un proyecto sandbox no cuentan para tu volumen mensual. Tampoco aparecen en tus estadísticas, y un hard bounce simulado nunca añade una dirección a tu suppression list.
Cómo funciona
Activar el modo sandbox
Al crear un proyecto, elige Sandbox como delivery mode. En un proyecto existente, encontrarás el interruptor en Delivery mode, dentro de Settings. Tus tokens de API y tus credenciales SMTP no cambian, así que no tienes que tocar tu código.
Simular un resultado
Por defecto, cada correo sandbox se marca como entregado. Para ver cómo responde tu aplicación ante un hard bounce o una spam complaint, añade sandbox_result a tu solicitud de API. ¿Envías por SMTP? Usa la cabecera 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
Los webhooks siguen funcionando en modo sandbox, así que puedes probar tus handlers de principio a fin. Eso sí, revisa el ajuste de cada webhook. Los nuevos webhooks vienen configurados en Live y no reenvían los events de sandbox. Cámbialos a Sandbox o Both para recibirlos mientras pruebas.
Pasar a producción
Cuando termines de probar, cambia el proyecto a Live y tus correos empezarán a llegar a destinatarios reales. Antes, asegúrate de que tu dominio esté verificado, porque el modo Live solo envía desde dominios verificados.
Disponible en Starter, Growth y Pro
El modo sandbox está incluido en los planes Starter, Growth y Pro. Puedes activarlo para cualquier proyecto desde tu panel (se abre en una ventana nueva). En la documentación sobre el modo sandbox encontrarás todos los resultados que puedes simular y cómo distinguir los events de sandbox de los de producción.