Descripción general
SMTP relay
Envía emails desde cualquier aplicación, framework o dispositivo compatible con SMTP. Datos de conexión, cómo aparece en Emailit el correo que pasa por el relay y en qué se diferencia el SMTP de la API.
El SMTP relay de Emailit acepta correo de cualquier cosa capaz de enviar por SMTP, como un CMS, el mailer de un framework, una herramienta de monitorización o un escáner, y lo entrega por el mismo circuito que la API de email. Úsalo cuando cambiar la configuración SMTP sea más fácil que escribir código para la API.
Cuándo usar SMTP
SMTP encaja bien cuando:
- Tu software solo admite SMTP, como los plugins de WordPress, las herramientas de soporte al cliente y los dispositivos de red.
- Te cambias desde otro proveedor y solo quieres cambiar el host y las credenciales.
- Tu framework ya tiene un mailer SMTP, como Laravel, Django, Rails y Nodemailer.
Elige la API cuando necesites plantillas con variables, envíos programados, metadatos, claves de idempotencia o ajustes de seguimiento por email. Para una comparación completa, consulta ¿API o SMTP?.
Cómo funciona
- Tu aplicación se conecta a
smtp.emailit.com, cambia la conexión a TLS e inicia sesión con una clave de API. - Envía el remitente del sobre, un comando de destinatario por cada destinatario y el mensaje.
- Emailit comprueba el espacio de trabajo, los límites de velocidad, el tamaño del mensaje y el dominio de la cabecera From, y responde
250 2.0.0 OK: queued as em_…. - Cada destinatario se convierte en un email independiente con su propio ID
em_. Emailit lo firma con DKIM, ejecuta las comprobaciones de spam, lo entrega y reintenta los fallos temporales, exactamente igual que con el correo de la API.
Datos de conexión
| Ajuste | Valor |
|---|---|
| Host | smtp.emailit.com |
| Puerto | 587 con STARTTLS. También 465 (TLS implícito), y 2525 o 2587 (STARTTLS) para las redes que bloquean el 587. |
| Usuario | emailit |
| Contraseña | Una clave de API, que empieza por secret_ |
| Autenticación | PLAIN o LOGIN |
La página de cada clave de API en Email APIAPI Keys muestra los mismos datos en su tarjeta SMTP Info. Configuración SMTP cubre todos los puertos, las reglas de la dirección del remitente y los límites.
Enviar un mensaje de prueba
cat > message.txt <<'EOF'
From: Acme <hello@acme.com>
To: ada@example.com
Subject: SMTP test from Acme
It works.
EOF
curl --url "smtp://smtp.emailit.com:587" --ssl-reqd --crlf \
--user "emailit:$EMAILIT_API_KEY" \
--mail-from hello@acme.com \
--mail-rcpt ada@example.com \
--upload-file message.txt -vimport nodemailer from 'nodemailer';
const transporter = nodemailer.createTransport({
host: 'smtp.emailit.com',
port: 587,
secure: false, // STARTTLS on 587
requireTLS: true,
auth: { user: 'emailit', pass: process.env.EMAILIT_API_KEY },
});
const info = await transporter.sendMail({
from: 'Acme <hello@acme.com>',
to: 'ada@example.com',
subject: 'SMTP test from Acme',
text: 'It works.',
});
console.log(info.response); // 250 2.0.0 OK: queued as em_…import os
import smtplib
from email.message import EmailMessage
msg = EmailMessage()
msg["From"] = "Acme <hello@acme.com>"
msg["To"] = "ada@example.com"
msg["Subject"] = "SMTP test from Acme"
msg.set_content("It works.")
with smtplib.SMTP("smtp.emailit.com", 587) as smtp:
smtp.starttls()
smtp.login("emailit", os.environ["EMAILIT_API_KEY"])
smtp.send_message(msg)use PHPMailer\PHPMailer\PHPMailer;
$mail = new PHPMailer(true);
$mail->isSMTP();
$mail->Host = 'smtp.emailit.com';
$mail->Port = 587;
$mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
$mail->SMTPAuth = true;
$mail->Username = 'emailit';
$mail->Password = getenv('EMAILIT_API_KEY');
$mail->setFrom('hello@acme.com', 'Acme');
$mail->addAddress('ada@example.com');
$mail->Subject = 'SMTP test from Acme';
$mail->Body = 'It works.';
$mail->send();Los espacios de trabajo nuevos están en modo sandbox y solo pueden enviar a las direcciones de email de las cuentas de sus miembros. Solicita el acceso de producción antes de enviar a cualquier otra persona.
Cómo aparece el correo SMTP en Emailit
- Un email por destinatario. Un mensaje con tres destinatarios crea tres emails, cada uno con su propio ID
em_, su estado y sus eventos. - Los ID en la respuesta. La respuesta
250que sigue al mensaje enumera los ID nuevos, por ejemplo250 2.0.0 OK: queued as em_33VtK8mRq1xZp7LwN4cY2bHsDfa. Son los mismos ID que usan la API, el panel y los webhooks. Consulta Cabeceras y respuestas SMTP. - Lista de emails. Los emails aparecen en Email APIEmails. Filtra por API key para ver el correo de una sola aplicación.
- Registros. Cada mensaje enviado aparece en Email APILogs con el origen SMTP y su código de respuesta, junto con los rechazos por límite de velocidad y los inicios de sesión fallidos. Consulta Registros de peticiones.
- Webhooks. El correo SMTP emite los mismos eventos de entrega e interacción que el correo de la API, salvo
email.accepted. El primer evento suele seremail.delivered.
En qué se diferencia el SMTP de la API de email
| Función | API de email | SMTP relay |
|---|---|---|
| Plantillas y variables de Temple | Sí | No. El mensaje se envía tal como lo has creado. |
| Envío programado | Sí, con scheduled_at |
No |
| Metadatos | Sí, con meta |
No |
| Seguimiento de aperturas y clics | Configuración del dominio, o por email con tracking |
Solo los ajustes Track loads y Track clicks del dominio de envío |
| Claves de idempotencia | Sí | No |
Evento email.accepted |
Sí | No |
| Destinatarios por mensaje | Hasta 50 en cada uno de to, cc y bcc |
Sin límite fijo |
| Cuándo se cobran los créditos | Cuando se acepta la petición. Si no hay créditos suficientes, devuelve 402. |
Cuando se procesa cada email. Si no hay créditos suficientes, el email se retiene. |
| Qué cuenta el límite de velocidad | Cada destinatario | Cada transacción SMTP (un mensaje) |
| Tamaño máximo del mensaje | 40 MB | 40 MB |
Emailit no lee las cabeceras de control X-Emailit-* en los mensajes SMTP. Consulta Cabeceras SMTP.
Límites
| Límite | Valor |
|---|---|
| Tamaño del mensaje | 40 MB |
| Velocidad de envío (por defecto) | 2 mensajes por segundo y 5000 mensajes al día por espacio de trabajo, compartidos con la API |
| Renovación diaria | 00:00 UTC |
| Créditos | 1 por destinatario |
Los espacios de trabajo Pro y Business reciben aumentos automáticos de sus límites según su salud de envío, y cualquier espacio de trabajo puede solicitar más desde la tarjeta Sending Limits de la página de inicio del panel. Consulta Límites.