SMTP-Integration

Nutzen Sie einen beliebigen SMTP-Client, eine Anwendung oder ein Gerät. Kopieren Sie die Verbindungswerte aus Ihrem Dashboard und aktivieren Sie TLS.

Verbindungsdetails

Verwenden Sie immer eine verschlüsselte Verbindung. Authentifizieren Sie sich mit Ihrem SMTP-Benutzernamen und einem API-Key als Passwort. Kopieren Sie Host und Benutzernamen exakt von der SMTP-Seite Ihres Dashboards; die Werte unten zeigen nur die Form.

Host:     YOUR_SMTP_HOST
Port:     587 (STARTTLS) or 465 (implicit TLS)
Username: YOUR_SMTP_USERNAME
Password: YOUR_API_KEY

Welchen Port verwenden

Port 587 mit STARTTLS ist der Standard-Submission-Port und die beste Voreinstellung. Port 465 nutzt TLS ab dem ersten Byte und passt zu Clients, die das erwarten. Meiden Sie Port 25 für die Einlieferung: Er ist für den Mailverkehr zwischen Servern gedacht und wird von vielen Hostern blockiert.

Test über die Kommandozeile

Prüfen Sie die Authentifizierung, bevor Sie Ihre Anwendung anbinden. swaks sendet eine Testnachricht; openssl zeigt den TLS-Handshake, falls etwas fehlschlägt.

swaks --to you@example.com --from hello@example.com \
  --server YOUR_SMTP_HOST:587 --tls \
  --auth LOGIN --auth-user YOUR_SMTP_USERNAME

openssl s_client -starttls smtp -connect YOUR_SMTP_HOST:587

Beispiel: Node.js (Nodemailer)

Nodemailer funktioniert mit jedem SMTP-Dienst. Halten Sie Zugangsdaten in Umgebungsvariablen.

const nodemailer = require("nodemailer");
const transport = nodemailer.createTransport({
  host: process.env.SMTP_HOST,
  port: 587,
  secure: false, // STARTTLS
  auth: { user: process.env.SMTP_USER, pass: process.env.MIGOSMTP_KEY },
});
await transport.sendMail({ from, to, subject, text });

Beispiel: Python (smtplib)

Für einen einfachen Versand genügt die Standardbibliothek.

import os, smtplib
from email.message import EmailMessage

msg = EmailMessage()
msg["From"], msg["To"], msg["Subject"] = "hello@example.com", "you@example.com", "Hello"
msg.set_content("It works.")
with smtplib.SMTP(os.environ["SMTP_HOST"], 587) as s:
    s.starttls()
    s.login(os.environ["SMTP_USER"], os.environ["MIGOSMTP_KEY"])
    s.send_message(msg)

Sinnvolle Header

Setzen Sie einen Reply-To, wenn Antworten an eine andere Adresse als die From-Adresse gehen sollen. Fügen Sie bei Massen- oder Marketingmails einen List-Unsubscribe-Header hinzu, auf den Mailbox-Anbieter achten. Verwenden Sie eine From-Adresse einer verifizierten Domain, sonst kann die Nachricht abgelehnt werden.

Zustellergebnisse

SMTP sagt Ihnen nur, dass die Nachricht angenommen wurde. Ob sie zugestellt wurde, gebounct ist oder als Spam gemeldet wurde, erfahren Sie über Webhooks oder die Aktivitätsansicht im Dashboard.