Guía
Elegir entre la API y SMTP
Compara la API REST de Emailit con el SMTP relay función por función, desde las plantillas y la programación hasta la idempotencia y los webhooks, y elige la opción adecuada.
Emailit acepta emails transaccionales de dos formas: la API REST y el SMTP relay. Esta guía los compara para que puedas elegir uno, o usar los dos en el mismo espacio de trabajo.
La respuesta corta
- Usa la API para el código nuevo. Hace más cosas: plantillas, programación, reintentos idempotentes, metadatos, configuración de seguimiento por email y una respuesta JSON con un ID para cada destinatario.
- Usa SMTP cuando el software que utilizas ya tiene configuración SMTP, como un CMS, el sistema de correo de un framework, una herramienta de soporte, un dispositivo o una aplicación heredada. Cambias cuatro ajustes y listo.
Los dos usan las mismas claves de API, los mismos dominios verificados, la misma lista de direcciones bloqueadas, los mismos límites de envío, los mismos registros y los mismos webhooks. Puedes cambiar más adelante sin tocar los DNS.
Comparación de funciones
| Función | API REST | SMTP relay |
|---|---|---|
| Endpoint | POST https://api.emailit.com/v2/emails |
smtp.emailit.com, puertos 587, 465, 2525, 2587 y 25 |
| Autenticación | Authorization: Bearer secret_… |
AUTH PLAIN o LOGIN, usuario emailit, contraseña = clave de API |
| Contenido | html, text o una plantilla guardada |
Un mensaje MIME completo, que se envía tal cual |
| Plantillas y variables | template (ID o alias) más variables, renderizadas con Temple |
No disponible. Renderiza el mensaje antes de enviarlo. |
| Programación | scheduled_at en ISO 8601, como marca de tiempo Unix o en lenguaje natural en inglés, como tomorrow at 9am |
No disponible. El email se pone en cola de inmediato. |
| Adjuntos | content en base64 o una url que Emailit descarga (hasta 25 MB cada uno). content_id convierte una imagen en imagen en línea. |
Partes MIME estándar |
| Tamaño del mensaje | 40 MB | 40 MB |
| Destinatarios por mensaje | Hasta 50 en cada uno de to, cc y bcc |
Sin límite fijo por transacción |
| Idempotencia | Cabecera Idempotency-Key, que se respeta durante 24 horas |
No disponible. Una transacción reintentada puede enviarse dos veces. |
| Metadatos | Objeto meta, que se devuelve en los payloads de los webhooks |
No disponible |
| Cabeceras personalizadas | Objeto headers |
Cualquier cabecera del mensaje |
| Seguimiento de aperturas y clics | Por email con tracking, o el valor por defecto del dominio |
Solo el valor por defecto del dominio |
Webhooks email.accepted y email.scheduled |
Sí | No. Los eventos posteriores, como email.delivered y email.bounced, funcionan igual. |
| ID de los emails | La respuesta tiene id, e ids con un ID por destinatario |
Respuesta final 250 2.0.0 OK: queued as em_… |
| Errores | Códigos de estado HTTP con un cuerpo JSON | Códigos de respuesta SMTP, por ejemplo 535 o 550 |
| Límites de envío | Compartidos por espacio de trabajo. 429 con las cabeceras ratelimit-* y retry-after. |
Compartidos por espacio de trabajo. Respuestas 452. |
| Créditos | 1 por destinatario | 1 por destinatario |
| Registro de peticiones | Email APILogs, origen API | Email APILogs, origen SMTP |
Una vez aceptado un email, los dos canales se comportan igual. Cada destinatario recibe un ID em_, aparece en Email APIEmails y se puede cancelar, reintentar o reenviar desde el panel o con la API.
Cuándo usar la API
Elige la API cuando escribas tú el código de envío, sobre todo si necesitas algo de esto:
- Plantillas. Los diseñadores editan una plantilla en el panel y tu código la envía por alias con
variables. Consulta Plantillas. - Reintentos seguros. Envía una
Idempotency-Keycon cada petición y reintenta cuando haya errores de red sin enviar dos veces. Consulta Peticiones idempotentes. - Programación. Envía un recordatorio para mañana por la mañana sin tu propia cola de tareas, y reprográmalo o cancélalo hasta 3 minutos antes de que salga. Consulta Programar y cancelar emails.
- Correlación. Adjunta tus propios ID en
metay asocia los eventos de webhook con tus registros. Consulta Cabeceras y metadatos. - Errores claros. Un
422por un dominio sin verificar o un402por falta de créditos es más fácil de gestionar que una cadena de respuesta SMTP.
Cuándo usar SMTP
Elige SMTP cuando no puedas o no quieras cambiar código:
- Software estándar como WordPress, una herramienta de soporte o una herramienta de monitorización con una página de configuración SMTP.
- Sistemas de correo de frameworks que ya funcionan por SMTP, como Laravel, Rails, Django o Nodemailer. Puedes pasar a la API más adelante.
- Migraciones rápidas desde otro proveedor. Cambia el host, el puerto, el usuario y la contraseña, y haz pruebas.
- Dispositivos y scripts que solo usan SMTP, como impresoras, escáneres o tareas cron.
Lo que debes saber antes de depender de SMTP:
- Emailit no lee por SMTP las cabeceras específicas de otros proveedores. El seguimiento sigue la configuración Track loads y Track clicks del dominio de envío.
- Emailit sustituye tu cabecera
Message-IDpor la suya y elimina la cabeceraReply-Tocuando es igual queFrom. - Usa siempre TLS. Se recomienda el puerto 587 con STARTTLS, y el 465 usa TLS desde el primer byte. Consulta Configuración SMTP.
Usar los dos
Muchos equipos usan los dos: la API para los emails de la aplicación y SMTP para un CMS o herramientas internas. Usa una clave de API distinta para cada uno, para distinguirlos en los registros y poder regenerar una sin romper la otra. Una clave Sending Only limitada a un dominio es una buena opción para las credenciales SMTP guardadas en software de terceros. Consulta Claves de API.