Enviar tu primer email por SMTP

Este inicio rápido te muestra cómo enviar un email de prueba a través del SMTP relay de Emailit desde tu terminal y cómo conectar después tu propia aplicación. Usa SMTP cuando tu software ya tenga ajustes SMTP. Para código nuevo, la API ofrece más posibilidades.

Antes de empezar

• Un dominio de envío verificado. Si aún no tienes uno, sigue la primera sección del inicio rápido de la API o Añadir un dominio.
• Una clave de API. Crea una en Email API›API Keys con Add API key. Tu clave de API es tu contraseña SMTP.

Tus credenciales SMTP

También puedes ver estos ajustes en la tarjeta SMTP Info al abrir una clave en Email API›API Keys.

El relay ofrece TLS en todos los puertos, pero no lo impone. Activa siempre TLS en tu cliente para que tu clave de API no se envíe en texto plano.

Enviar un email de prueba

Elige una de estas herramientas. Sustituye hello@acme.com por una dirección de tu dominio verificado y ada@example.com por la dirección de email con la que te registraste.

swaks

swaks es una herramienta de línea de comandos para probar SMTP. Instálala con brew install swaks o apt install swaks y después ejecuta:

swaks --server smtp.emailit.com:587 --tls \
  --auth-user emailit --auth-password "$EMAILIT_API_KEY" \
  --from hello@acme.com --to ada@example.com \
  --header "Subject: Hello from Emailit SMTP" \
  --body "This is my first email sent through the Emailit SMTP relay."

swaks muestra toda la conversación SMTP. La última respuesta del servidor contiene el ID del email:

<~  250 2.0.0 OK: queued as em_2pX7cN4kQ9vLm3RtB8yWd1Zs

OpenSSL

OpenSSL viene preinstalado en la mayoría de los sistemas y te permite escribir tú mismo los comandos SMTP. Primero, codifica tus credenciales para AUTH PLAIN:

printf '\0emailit\0%s' "$EMAILIT_API_KEY" | base64

Después, abre una conexión y escribe los comandos siguientes, pegando la cadena codificada después de AUTH PLAIN:

openssl s_client -connect smtp.emailit.com:587 -starttls smtp -crlf -quiet

EHLO localhost
AUTH PLAIN AGVtYWlsaXQAc2VjcmV0X...
MAIL FROM:<hello@acme.com>
RCPT TO:<ada@example.com>
DATA
From: Acme <hello@acme.com>
To: ada@example.com
Subject: Hello from Emailit SMTP

This is my first email sent through the Emailit SMTP relay.
.
QUIT

Después de AUTH PLAIN, el servidor responde 235. Después de la línea con un solo ., responde 250 2.0.0 OK: queued as em_….

Python

El smtplib integrado de Python no necesita paquetes adicionales:

import os
import smtplib
from email.message import EmailMessage

msg = EmailMessage()
msg["From"] = "Acme <hello@acme.com>"
msg["To"] = "ada@example.com"
msg["Subject"] = "Hello from Emailit SMTP"
msg.set_content("This is my first email sent through the Emailit SMTP relay.")
msg.add_alternative("<p>This is my first email sent through the Emailit SMTP relay.</p>", subtype="html")

with smtplib.SMTP("smtp.emailit.com", 587) as smtp:
    smtp.starttls()
    smtp.login("emailit", os.environ["EMAILIT_API_KEY"])
    smtp.send_message(msg)

print("Accepted by Emailit")

Si el script termina sin ninguna excepción, Emailit ha aceptado el email.

Comprobarlo en el panel

Ve a Email API›Emails. Tu email aparece arriba del todo en la pestaña Outgoing, y su estado cambia de accepted a delivered cuando el servidor del destinatario lo acepta. Cada sesión SMTP aparece también en Email API›Logs con el origen SMTP, así que también puedes ver los inicios de sesión fallidos y los mensajes rechazados.

Respuestas habituales

Para ver todos los códigos de respuesta, consulta Solución de problemas de SMTP.

Conectar tu aplicación

Introduce los mismos ajustes en tu aplicación o tu framework. Estas guías muestran la configuración exacta:

Próximos pasos