Leitfaden
Von MailerSend migrieren
Wechseln Sie von MailerSend zu Emailit. Domains, Tokens und SMTP-Benutzer zuordnen, API-Aufrufe und Personalisierung umwandeln, SMTP umstellen und Webhooks, Sperrungen und Vorlagen umziehen.
Diese Anleitung ordnet Konzepte, API-Aufrufe, Webhooks, Sperrungen und Vorlagen von MailerSend ihren Entsprechungen in Emailit zu. Lesen Sie zuerst Zu Emailit migrieren für die allgemeine Reihenfolge und den parallelen Betrieb beider Anbieter.
Konzepte
| MailerSend | Emailit |
|---|---|
| Konto | Konto und Workspaces. Jeder Workspace hat eigene Domains, Schlüssel, Mitglieder und Credits. |
| Domains | Versanddomains |
| Absenderidentitäten | Nicht verfügbar. Jede Absenderadresse muss auf einer verifizierten Domain liegen. |
| API-Tokens mit Scopes | API-Schlüssel: Full Access oder Sending Only, optional auf eine Domain beschränkt |
| SMTP-Benutzer | Ihr API-Schlüssel, als SMTP-Passwort verwendet |
| Testdomain und Sandbox-Modus | Keine gemeinsame Testdomain. Neue Workspaces sind im Sandbox-Modus und können nur an Mitglieder des Workspace senden. |
| Vorlagen | Vorlagen mit Alias und Versionen, gerendert mit Temple |
| Webhooks pro Domain | Webhooks pro Workspace |
| Inbound-Routen | Eingehende E-Mails mit dem Webhook email.received oder die Automatisierung Forward received email |
| Sperrungen pro Domain: Hard Bounces, Spam-Beschwerden, Abmeldungen, Blocklist | Eine Sperrliste pro Workspace |
| On-Hold-Liste | Nicht nötig. Emailit wiederholt Soft Bounces und meldet jeden Versuch als email.attempted. |
| Activity | Email APIEmails und Email APILogs |
| Tags | meta |
| E-Mail-Verifizierung | E-Mail-Verifizierung |
| Dedizierte IPs | Dedizierte IPs auf Anfrage |
API-Aufrufe anpassen
Aus POST /v1/email von MailerSend wird POST /v2/emails. Beide nehmen ein Bearer-Token und JSON an, aber Adressen sind bei Emailit einfache Strings statt Objekte:
curl https://api.mailersend.com/v1/email \
-H "Authorization: Bearer $MAILERSEND_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"from": { "email": "hello@acme.com", "name": "Acme" },
"to": [{ "email": "ada@example.com" }],
"subject": "Your receipt",
"text": "Thanks for your order.",
"html": "<p>Thanks for your order.</p>"
}'curl https://api.emailit.com/v2/emails \
-H "Authorization: Bearer $EMAILIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"from": "Acme <hello@acme.com>",
"to": "ada@example.com",
"subject": "Your receipt",
"text": "Thanks for your order.",
"html": "<p>Thanks for your order.</p>"
}'| MailerSend | Emailit |
|---|---|
Authorization: Bearer <token> |
Authorization: Bearer secret_… |
from: { email, name } |
from: "Name <email>" |
to[], cc[], bcc[] mit email und name |
to, cc, bcc als String oder Array mit jeweils bis zu 50 |
reply_to: { email, name } |
reply_to |
subject, text, html |
Identisch |
headers: [{ "name": "…", "value": "…" }] |
headers: { "Name": "Value" } |
list_unsubscribe |
headers mit List-Unsubscribe und List-Unsubscribe-Post. Siehe Header und Metadaten. |
attachments[] mit content, filename, disposition und id |
attachments[] mit content, filename und content_type oder einer url statt content. Verwenden Sie content_id für eingebettete Bilder. |
template_id |
template, eine Vorlagen-ID oder ein Alias |
personalization: [{ "email": "…", "data": { … } }] |
variables, mit einer Anfrage pro Empfänger, wenn sich die Werte unterscheiden |
tags |
meta, in Webhook-Events zurückgegeben |
send_at (Unix-Zeit oder ISO 8601) |
scheduled_at (ISO 8601 oder englischer Klartext). Wandeln Sie Unix-Zeiten zuerst in ISO 8601 um. |
settings.track_opens, settings.track_clicks |
tracking: { "loads": true, "clicks": true } |
POST /v1/bulk-email |
Nicht verfügbar. Senden Sie eine Anfrage pro Nachricht. |
202 Accepted mit einem Header x-message-id und leerem Body |
200 mit einem JSON-Body: id (em_…), status: "accepted" und, bei mehreren Empfängern, ids mit einer ID pro Empfänger |
Jeder Empfänger in einer Anfrage an Emailit wird zu einer eigenen E-Mail mit eigener ID. MailerSend antwortet auch dann mit 202, wenn alle Empfänger gesperrt sind, mit einer Warnung im Body. Emailit nimmt Empfänger mit einer Sperrung vom Typ recipient ebenfalls an und gibt jedem den Status suppressed. Fügen Sie einen Header Idempotency-Key hinzu, damit Wiederholungen sicher sind. Siehe E-Mail senden.
SMTP-Einstellungen umstellen
| Einstellung | MailerSend | Emailit |
|---|---|---|
| Host | smtp.mailersend.net |
smtp.emailit.com |
| Port | 587 (STARTTLS) |
587, 2587, 2525 oder 25 (STARTTLS), 465 (TLS) |
| Benutzername | Der generierte Benutzername des SMTP-Benutzers | emailit |
| Passwort | Das Passwort des SMTP-Benutzers | Ihr Emailit-API-Schlüssel |
Emailit liest den Header X-MailerSend-Tags nicht. Entfernen Sie ihn. Anders als MailerSend stellt Emailit Ihre übrigen eigenen Header unverändert zu. Siehe SMTP-Einstellungen.
Webhook-Events zuordnen
| MailerSend-Event | Emailit-Event |
|---|---|
activity.sent |
email.accepted (nur API) |
activity.delivered |
email.delivered |
activity.deferred |
email.attempted |
activity.soft_bounced |
email.attempted, während Emailit es erneut versucht, dann email.bounced, wenn alle Wiederholungen fehlschlagen |
activity.hard_bounced |
email.bounced |
activity.suppressed |
email.suppressed |
activity.opened, activity.opened_unique |
email.loaded, für jeden Ladevorgang gesendet |
activity.clicked, activity.clicked_unique |
email.clicked, für jeden Klick gesendet |
activity.spam_complaint |
email.complained |
activity.unsubscribed |
email.unsubscribed, nur für Kampagnen-E-Mails |
| Inbound-Route, die an einen Webhook weiterleitet | email.received, dann den Inhalt mit GET /emails/{id} abrufen |
Das Anfrageformat ändert sich:
- MailerSend sendet ein Event pro Anfrage. Emailit sendet ein JSON-Array mit bis zu 100 Events. Iterieren Sie also über den Body.
- Der Event-Name steht bei beiden in
type. Bei Emailit steht die E-Mail indata.object: Verwenden Siedata.object.id, dieem_-ID aus der Antwort auf den Versand, stattdata.message_id(data.email.message.idbei Webhooks der Version 1) unddata.object.tostattdata.recipient. Ihremeta-Werte stehen indata.object.meta. - Bei
email.loadedundemail.clickedistdata.objectder Ladevorgang oder der Klick. Verwenden Siedata.object.email_idfür die ID der E-Mail sowiedata.object.email.rcpt_tounddata.object.email.metafür den Empfänger und Ihremeta-Werte. - Der Header
Signaturevon MailerSend ist ein HMAC-SHA256 des unveränderten Bodys.X-Emailit-Signaturevon Emailit ist ein HMAC-SHA256 von<timestamp>.<raw body>mit Ihremwhsec_-Secret als Schlüssel. Lesen Sie daher auchX-Emailit-Timestampaus. Siehe Anfragesignatur.
for (const event of req.body) {
const email = event.data.object;
if (event.type === 'email.bounced') markBounced(email.to, email.id);
if (event.type === 'email.complained') unsubscribe(email.to);
}Sperrungen umziehen
-
Exportieren Sie in MailerSend die Listen Hard bounces, Spam complaints, Unsubscribes und Blocklist jeder Domain, über die Suppression-Seiten oder per API (
/v1/suppressions/hard-bounces,/spam-complaints,/unsubscribesund/blocklist). Die On-Hold-Liste ist vorübergehend, Sie können sie also weglassen. -
Erstellen Sie eine CSV-Datei mit den Spalten
email,type,reason:email,type,reason old-address@example.com,recipient,mailersend hard bounce angry@example.com,recipient,mailersend spam complaintVerwenden Sie den Typ
recipientfür Adressen, die nie E-Mails erhalten dürfen. Er blockiert Versände per API, SMTP und Kampagne. Für Personen, die sich nur von Marketing-E-Mails abgemeldet haben, verwenden Sie den Typunsubscribe, der Kampagnen stoppt, transaktionale E-Mails aber weiter durchlässt. -
Wählen Sie unter Email APISuppressions die Option Import und laden Sie die Datei hoch. Jede Datei darf bis zu 10.000 Zeilen haben und höchstens 8 MB groß sein. Duplikate werden übersprungen.
Emailit hat eine Sperrliste pro Workspace, daher kommen die Adressen aller Ihrer MailerSend-Domains in dieselbe Liste. Sperrungen gelten für genaue Adressen: Für Blocklist-Muster wie .*@example.com gibt es keine Entsprechung. Siehe Sperrungen verwalten.
Vorlagen umziehen
Kopieren Sie das HTML jeder Vorlage aus dem Editor von MailerSend und importieren Sie es dann unter Email MarketingTemplates oder erstellen Sie die Vorlage mit der Vorlagen-API. Geben Sie ihr einen Alias, etwa receipt, und senden Sie sie mit "template": "receipt" und variables.
Die Personalisierung von MailerSend ist eine eingeschränkte Version von Twig. Temple deckt die üblichen Teile ab:
| MailerSend | Emailit (Temple) |
|---|---|
{{ name }}, {{ user.name }} |
{{name}}, {{user.name}} |
{{ name|default('there') }} |
{{name|"there"}} |
{% if plan %}…{% else %}…{% endif %} |
{{#if plan}}…{{else}}…{{/if}} |
{% if plan == "pro" %}, {% elseif %} |
Nicht unterstützt. Übergeben Sie einen Boolean wie is_pro und verwenden Sie {{#if is_pro}}. |
{% for item in items %}…{% endfor %} |
Nicht unterstützt. Rendern Sie die Liste in Ihrem Code und übergeben Sie sie als eine Variable. |
{{ name|upper }} und andere Filter |
Nicht unterstützt. Formatieren Sie den Wert in Ihrem Code. |
personalization[].data |
variables |
MailerSend entfernt den Großteil des HTML aus Personalisierungswerten. Temple maskiert oder entfernt HTML nie. Maskieren Sie Benutzereingaben daher, bevor Sie sie übergeben. Siehe Temple und Vorlagen importieren und exportieren.
DNS ändern
Fügen Sie Ihre Domain unter Email APIDomains hinzu und legen Sie die Einträge von Emailit an. Sie verwenden eigene Namen (emailit._domainkey, emailit.<domain> und optional go und inbound) und kollidieren daher weder mit den DKIM-Einträgen ms1._domainkey und ms2._domainkey von MailerSend noch mit dessen Return-Path-CNAME mta oder Tracking-CNAME email. Behalten Sie Ihren DMARC-Eintrag. Siehe DNS-Einträge.
Auch das Inbound-Routing von MailerSend verwendet standardmäßig eine Subdomain inbound. Wenn das bei Ihnen der Fall ist, geben Sie den eingehenden E-Mails bei Emailit mit inbound_key eine andere Subdomain oder stellen Sie den MX-Eintrag um, wenn Sie die eingehenden E-Mails umziehen. Siehe Eingehende E-Mails einrichten.
Entfernen Sie nach der Umstellung die DKIM-, Return-Path- und Tracking-Einträge von MailerSend und entfernen Sie include:_spf.mailersend.net aus Ihrem SPF-Eintrag.
Nächste Schritte
- Go-live-Checkliste
- Webhook einrichten
- Priority migration: Lassen Sie Engineers von Emailit den Umzug gemeinsam mit Ihnen erledigen