Übersicht
SMTP-Relay
Senden Sie E-Mails aus jeder App, jedem Framework und jedem Gerät, das SMTP spricht. Verbindungsdaten, wie weitergeleitete E-Mails in Emailit erscheinen und wie sich SMTP von der API unterscheidet.
Das SMTP-Relay von Emailit nimmt E-Mails von allem an, was per SMTP senden kann, etwa einem CMS, dem Mailer eines Frameworks, einem Monitoring-Tool oder einem Scanner, und stellt sie über dieselbe Pipeline zu wie die E-Mail-API. Nutzen Sie es, wenn das Ändern von SMTP-Einstellungen einfacher ist als API-Code zu schreiben.
Wann Sie SMTP nutzen
SMTP passt gut, wenn:
- Ihre Software nur SMTP unterstützt, etwa WordPress-Plugins, Helpdesks und Netzwerkgeräte.
- Sie von einem anderen Anbieter wechseln und nur Host und Zugangsdaten ändern möchten.
- Ihr Framework bereits einen SMTP-Mailer hat, wie Laravel, Django, Rails und Nodemailer.
Wählen Sie die API, wenn Sie Vorlagen mit Variablen, Planung, Metadaten, Idempotenzschlüssel oder Tracking-Einstellungen pro E-Mail brauchen. Einen vollständigen Vergleich finden Sie unter API oder SMTP?.
So funktioniert es
- Ihre Anwendung verbindet sich mit
smtp.emailit.com, stuft die Verbindung auf TLS hoch und meldet sich mit einem API-Schlüssel an. - Sie sendet den Envelope-Absender, einen Empfängerbefehl pro Empfänger und die Nachricht.
- Emailit prüft den Workspace, die Rate Limits, die Nachrichtengröße und die Domain im From-Header und antwortet dann mit
250 2.0.0 OK: queued as em_…. - Jeder Empfänger wird zu einer eigenen E-Mail mit eigener
em_-ID. Emailit signiert sie mit DKIM, führt Spam-Prüfungen durch, stellt sie zu und wiederholt vorübergehende Fehlschläge, genau wie bei E-Mails per API.
Verbindungsdaten
| Einstellung | Wert |
|---|---|
| Host | smtp.emailit.com |
| Port | 587 mit STARTTLS. Außerdem 465 (implizites TLS) sowie 2525 oder 2587 (STARTTLS) für Netzwerke, die 587 blockieren. |
| Benutzername | emailit |
| Passwort | Ein API-Schlüssel, beginnend mit secret_ |
| Authentifizierung | PLAIN oder LOGIN |
Die Seite jedes API-Schlüssels unter Email APIAPI Keys zeigt dieselben Angaben in der Karte SMTP Info. SMTP-Einstellungen behandelt alle Ports, die Regeln für die Absenderadresse und die Limits.
Testnachricht senden
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();Neue Workspaces sind im Sandbox-Modus und können nur an die Konto-E-Mail-Adressen der Workspace-Mitglieder senden. Beantragen Sie den Produktionszugang, bevor Sie an andere Personen senden.
Wie E-Mails per SMTP in Emailit erscheinen
- Eine E-Mail pro Empfänger. Eine Nachricht mit drei Empfängern erzeugt drei E-Mails, jede mit eigener
em_-ID, eigenem Status und eigenen Events. - IDs in der Antwort. Die Antwort
250nach der Nachricht listet die neuen IDs auf, zum Beispiel250 2.0.0 OK: queued as em_33VtK8mRq1xZp7LwN4cY2bHsDfa. Es sind dieselben IDs, die API, Weboberfläche und Webhooks verwenden. Siehe SMTP-Header und -Antworten. - E-Mail-Liste. Die E-Mails erscheinen unter Email APIEmails. Filtern Sie nach API key, um die E-Mails einer einzelnen Anwendung zu sehen.
- Logs. Jede eingereichte Nachricht erscheint unter Email APILogs mit der Quelle SMTP und ihrem Antwortcode, zusammen mit Ablehnungen wegen Rate Limits und fehlgeschlagenen Anmeldungen. Siehe Anfrage-Logs.
- Webhooks. E-Mails per SMTP lösen dieselben Zustell- und Engagement-Events aus wie E-Mails per API, aber nicht
email.accepted. Das erste Event ist meistemail.delivered.
Wie sich SMTP von der E-Mail-API unterscheidet
| Funktion | E-Mail-API | SMTP-Relay |
|---|---|---|
| Vorlagen und Temple-Variablen | Ja | Nein. Die Nachricht wird so gesendet, wie Sie sie erstellt haben. |
| Geplanter Versand | Ja, mit scheduled_at |
Nein |
| Metadaten | Ja, mit meta |
Nein |
| Öffnungs- und Klick-Tracking | Domaineinstellungen oder pro E-Mail mit tracking |
Nur die Einstellungen Track loads und Track clicks der Versanddomain |
| Idempotenzschlüssel | Ja | Nein |
Event email.accepted |
Ja | Nein |
| Empfänger pro Nachricht | Jeweils bis zu 50 in to, cc und bcc |
Kein festes Limit |
| Wann Credits berechnet werden | Wenn die Anfrage angenommen wird. Bei zu wenigen Credits wird 402 zurückgegeben. |
Wenn jede E-Mail verarbeitet wird. Bei zu wenigen Credits wird die E-Mail zurückgehalten. |
| Was ein Rate Limit zählt | Jeden Empfänger | Jede SMTP-Transaktion (eine Nachricht) |
| Maximale Nachrichtengröße | 40 MB | 40 MB |
Emailit liest in SMTP-Nachrichten keine Steuer-Header X-Emailit-*. Siehe SMTP-Header.
Limits
| Limit | Wert |
|---|---|
| Nachrichtengröße | 40 MB |
| Senderate (Standard) | 2 Nachrichten pro Sekunde und 5.000 Nachrichten pro Tag pro Workspace, gemeinsam mit der API |
| Tägliches Zurücksetzen | Mitternacht UTC |
| Credits | 1 pro Empfänger |
Workspaces mit Pro oder Business erhalten automatische Limiterhöhungen auf Basis der Versandgesundheit, und jeder Workspace kann über die Karte Sending Limits auf der Startseite der Weboberfläche mehr beantragen. Siehe Limits.