Las rutas API y SMTP de Mailjet pueden generar mensajes finales diferentes incluso cuando el borrador visible es el mismo. Compare el contenido MIME renderizado, las identidades del remitente y las referencias de mensaje disponibles antes de interpretar la ubicación en carpetas del buzón. Una respuesta exitosa de la API o la aceptación SMTP no establecen la carpeta elegida por el buzón receptor.
Definir entradas equivalentes de mensaje
Elija un mensaje de aplicación no sensible y guarde su asunto, remitente, Reply-To, parte HTML, texto plano, enlaces y comportamiento de los archivos adjuntos. Use los mismos datos de prueba para ambas rutas. Decida si está comparando dos envíos de transporte de un mensaje ya renderizado o dos implementaciones completas de la aplicación.
Esa distinción es importante porque una ruta de plantilla API puede renderizarse de forma diferente a una biblioteca SMTP que construye su propio MIME. Si la aplicación usa renderizadores separados, el experimento incluye esos renderizadores. No lo presente como una comparación solo de transporte a menos que se haya establecido la paridad de contenido.
Identificar versión y contexto de cuenta
Registre la versión de la API y el contexto de cuenta o clave API de Mailjet usado por cada ruta sin registrar secretos. El ejemplo actual de primer correo electrónico de Mailjet usa Send API v3.1, mientras que documentación separada cubre v3.0. No mezcle nombres de propiedades de diferentes versiones al investigar un problema de carga útil.
La visión general SMTP asigna la responsabilidad de encabezados, manejo MIME y personalización a la aplicación que envía. Verifique la salida real de la biblioteca SMTP en lugar de asumir que las rutas API y SMTP sintetizan automáticamente la misma alternativa de texto o codificación. Guarde mensajes generados representativos para una comparación significativa.
Controlar diferencias ocultas
Compare la identidad visible From y del sobre, codificación del asunto, nombres de archivos adjuntos, alternativas de texto y HTML, y encabezados de cancelación de suscripción requeridos para el tipo de mensaje. Inventaríe opciones de seguimiento o plantilla que puedan aplicarse de forma diferente. Una URL de destino compartida no establece el mismo comportamiento de reescritura de enlaces.
Use la misma configuración de remitente validada donde sea compatible. Verifique la autenticación real en las copias recibidas; un inicio de sesión exitoso o autorización API solo establece acceso al servicio de envío. No prueba que el mensaje resultante haya pasado la autenticación del lado del destinatario o haya llegado a la Inbox.
Enviar mensajes originales acotados
Cree pruebas LDM para el remitente previsto y obtenga los destinatarios actuales de cada ejecución. Envíe un caso de prueba claramente identificado mediante la implementación API relevante y otro mediante SMTP, manteniendo comparable la composición de destinatarios-proveedor y el tiempo de observación. Use la lógica real de la aplicación cuando esa lógica sea la cuestión.
Conserve los identificadores de respuesta API y las referencias de transacción SMTP junto con los identificadores de trabajo de su aplicación. No registre secretos API, contraseñas SMTP ni encabezados completos de autorización. Distinga una solicitud intentada de un envío exitoso al proveedor y un evento de entrega posterior.
Mantenga los destinatarios de prueba fuera de trabajos recurrentes y listas ordinarias de suscriptores. Detenga el flujo acotado después de los mensajes planificados. Esta guía no realiza solicitudes ni envíos y no asume conexión nativa de Mailjet con LDM.
Conciliar transporte y observación
Para cada copia recibida, registre su ruta, referencia de mensaje, carpeta y hora de observación. Si se observa la ruta API y falta la SMTP, primero inspeccione la evidencia de envío SMTP y cola. La ausencia por sí sola no establece que el destinatario haya clasificado el mensaje SMTP como Spam.
Si ambos llegan pero la ubicación en carpetas difiere, compare su contenido final y encabezados antes de afirmar que el protocolo en sí explica el resultado. Un panel de buzones de prueba pequeño no puede clasificar universalmente API versus SMTP. El comportamiento de la aplicación, enrutamiento, historial del remitente y contexto del destinatario siguen siendo limitaciones relevantes.
Preguntas frecuentes
¿El éxito en la API significa entrega en Inbox?
No. Es evidencia de envío. Use eventos de envío posteriores y una observación real del buzón para las siguientes capas.
¿Puedo comparar una plantilla API con un borrador SMTP diferente?
Sí, como comparación de dos configuraciones completas. No atribuya ninguna diferencia únicamente a API versus SMTP sin controlar el contenido.
¿Debo imprimir credenciales durante la depuración?
No. Las etiquetas de cuenta, estructura de solicitud saneada, marcas de tiempo y referencias de mensaje no secretas proporcionan evidencia útil sin exponer material de autenticación.
Referencias oficiales
Revisado 2026-11-05; no se reclama ningún estándar de protocolo.