Zum Inhalt springen
Doku

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.

Aktualisiert am 23. Okt. 2026

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:

Before: MailerSend
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>"
  }'
After: Emailit
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 in data.object: Verwenden Sie data.object.id, die em_-ID aus der Antwort auf den Versand, statt data.message_id (data.email.message.id bei Webhooks der Version 1) und data.object.to statt data.recipient. Ihre meta-Werte stehen in data.object.meta.
  • Bei email.loaded und email.clicked ist data.object der Ladevorgang oder der Klick. Verwenden Sie data.object.email_id für die ID der E-Mail sowie data.object.email.rcpt_to und data.object.email.meta für den Empfänger und Ihre meta-Werte.
  • Der Header Signature von MailerSend ist ein HMAC-SHA256 des unveränderten Bodys. X-Emailit-Signature von Emailit ist ein HMAC-SHA256 von <timestamp>.<raw body> mit Ihrem whsec_-Secret als Schlüssel. Lesen Sie daher auch X-Emailit-Timestamp aus. Siehe Anfragesignatur.
JavaScript
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

  1. 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, /unsubscribes und /blocklist). Die On-Hold-Liste ist vorübergehend, Sie können sie also weglassen.

  2. Erstellen Sie eine CSV-Datei mit den Spalten email,type,reason:

    CSV
    email,type,reason
    old-address@example.com,recipient,mailersend hard bounce
    angry@example.com,recipient,mailersend spam complaint

    Verwenden Sie den Typ recipient fü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 Typ unsubscribe, der Kampagnen stoppt, transaktionale E-Mails aber weiter durchlässt.

  3. 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

War diese Seite hilfreich?

Danke für Ihr Feedback.

Danke, wir lesen jede Nachricht.