Zum Inhalt springen
Doku

Leitfaden

Von Mandrill migrieren

Wechseln Sie von Mandrill (Mailchimp Transactional) zu Emailit. API-Schlüssel und Subaccounts zuordnen, Aufrufe von messages/send umwandeln, SMTP und X-MC-Header austauschen, Webhooks verifizieren und die Rejection Denylist umziehen.

Aktualisiert am 23. Okt. 2026

Diese Anleitung ordnet Konzepte, API-Aufrufe, Webhooks, die Rejection Denylist und Vorlagen von Mandrill (Mailchimp Transactional Email) ihren Entsprechungen in Emailit zu. Lesen Sie zuerst Zu Emailit migrieren für die allgemeine Reihenfolge und den parallelen Betrieb beider Anbieter. Wenn Sie auch Kampagnen über Mailchimp senden, lesen Sie Von Mailchimp migrieren.

Konzepte

Mandrill Emailit
Ein Mailchimp-Tarif Standard oder Premium mit Transactional-Blöcken Ein Emailit-Konto. Für transaktionale E-Mails brauchen Sie keinen Marketing-Tarif.
Subaccounts Workspaces, jeder mit eigenen Domains, Schlüsseln, Limits und Credits
API-Schlüssel API-Schlüssel: Full Access oder Sending Only, optional auf eine Domain beschränkt
Test-API-Schlüssel Kein Testmodus. Neue Workspaces sind im Sandbox-Modus und können nur an Mitglieder des Workspace senden.
Versanddomains und Verifizierung von DKIM/SPF Versanddomains
Tracking-Domains Tracking-Subdomain wie go.acme.com
Vorlagen mit mc:edit-Bereichen Vorlagen mit Alias und Versionen, gerendert mit Temple
Webhooks Webhooks
Inbound-Domains und Routes Eingehende E-Mails
Rejection Denylist Sperrungen
Rejection Allowlist Nicht verfügbar
Merge-Sprachen: Mailchimp und Handlebars Temple
Tags und Metadaten meta
Outbound Activity Email APIEmails und Email APILogs
Dedizierte IPs und IP-Pools Dedizierte IPs auf Anfrage

API-Aufrufe anpassen

POST /messages/send von Mandrill nimmt den API-Schlüssel im JSON-Body an und verschachtelt die E-Mail in message. POST /v2/emails von Emailit nimmt ein Bearer-Token und einen flachen Body an:

Before: Mandrill
curl https://mandrillapp.com/api/1.0/messages/send \
  -H "Content-Type: application/json" \
  -d '{
    "key": "'"$MANDRILL_API_KEY"'",
    "message": {
      "from_email": "hello@acme.com",
      "from_name": "Acme",
      "to": [{ "email": "ada@example.com", "type": "to" }],
      "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>"
  }'
Mandrill Emailit
key im Anfrage-Body Header Authorization: Bearer secret_…
message.from_email und from_name from: "Name <email>"
message.to[] mit type to, cc oder bcc to, cc, bcc, jeweils bis zu 50
message.headers["Reply-To"] reply_to
message.subject, html, text subject, html, text
message.headers headers
message.attachments[] mit type, name, content attachments[] mit content_type, filename, content
message.images[] für eingebettete Bilder attachments[] mit einer content_id, im HTML als cid: referenziert
message.metadata, message.tags meta, ein Objekt aus String-Werten, das in Webhook-Events zurückgegeben wird
message.track_opens, track_clicks tracking: { "loads": true, "clicks": true }
message.global_merge_vars variables
message.merge_vars (pro Empfänger) Eine Anfrage pro Empfänger, jede mit eigenen variables
message.subaccount Verwenden Sie einen API-Schlüssel aus dem passenden Workspace
send_at scheduled_at (ISO 8601 oder englischer Klartext)
async Nicht nötig. Emailit stellt jede E-Mail zur Zustellung in die Warteschlange und antwortet, ohne darauf zu warten.
POST /messages/send-template mit template_name Dasselbe POST /v2/emails mit template (ein Alias oder eine ID) und variables
Antwort: ein Array mit email, status und _id für jeden Empfänger 200 mit id (em_…), status: "accepted" und, bei mehreren Empfängern, ids mit einer ID pro Empfänger

Mandrill meldet Probleme pro Empfänger in der Antwort, mit Status wie rejected oder invalid. Emailit validiert die gesamte Anfrage und gibt bei ungültigen Eingaben einen HTTP-Fehler zurück. Empfänger mit einer Sperrung vom Typ recipient werden angenommen und erhalten dann den Status suppressed. Fügen Sie einen Header Idempotency-Key hinzu, damit Wiederholungen sicher sind. Siehe E-Mail senden.

SMTP-Einstellungen umstellen

Einstellung Mandrill Emailit
Host smtp.mandrillapp.com smtp.emailit.com
Port 587, 2525 oder 25 (STARTTLS), 465 (TLS) 587, 2587, 2525 oder 25 (STARTTLS), 465 (TLS)
Benutzername Ein beliebiger Wert emailit
Passwort Ein Mandrill-API-Schlüssel Ihr Emailit-API-Schlüssel

Emailit liest keine X-MC-*-Header wie X-MC-Template, X-MC-MergeVars, X-MC-Tags, X-MC-Metadata oder X-MC-Track. Entfernen Sie sie. Legen Sie das Tracking bei der Domain fest und nutzen Sie die API, wenn Sie Vorlagen oder Metadaten brauchen. Siehe SMTP-Einstellungen.

Webhook-Events zuordnen

Mandrill-Event Emailit-Event
send email.accepted (nur API)
delivered email.delivered
deferral email.attempted
hard_bounce email.bounced
soft_bounce email.attempted, während Emailit es erneut versucht, dann email.bounced, wenn alle Wiederholungen fehlschlagen
open email.loaded
click email.clicked
spam email.complained
unsub email.unsubscribed, nur für Kampagnen-E-Mails
reject email.suppressed, wenn die Adresse eine Sperrung vom Typ recipient hat. Andere Gründe für Rejects, etwa unsigned, sind in Emailit API-Fehler.
Sync-Events der Rejection Denylist suppression.created, suppression.deleted, für Sperrungen, die Sie hinzufügen oder entfernen
inbound email.received, dann den Inhalt mit GET /emails/{id} abrufen

Das Anfrageformat ändert sich:

  • Mandrill sendet ein Formularfeld, mandrill_events, das ein JSON-Array mit bis zu 1.000 Events enthält. Emailit sendet das JSON-Array als Anfrage-Body, mit bis zu 100 Events.
  • Der Event-Name steht in type und die E-Mail in data.object. Verwenden Sie data.object.id, die em_-ID aus der Antwort auf den Versand, statt _id und data.object.to statt msg.email. 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.
  • Mandrill signiert die URL und die Formularfelder mit HMAC-SHA1, Base64-kodiert, in X-Mandrill-Signature. Emailit signiert <timestamp>.<raw body> mit HMAC-SHA256: Verifizieren Sie X-Emailit-Signature anhand von X-Emailit-Timestamp und Ihrem whsec_-Secret. 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 die gesamte Rejection Denylist mit Export Full Denylist auf der Seite Rejection Denylist von Mandrill oder mit dem API-Aufruf /exports/rejects. /rejects/list gibt höchstens 1.000 Einträge zurück, verwenden Sie ihn also nicht dafür. Der Export ist eine ZIP-Datei mit rejects.csv und umfasst alle Subaccounts.

  2. Erstellen Sie eine CSV-Datei mit den Spalten email,type,reason. Überspringen Sie Einträge, die bereits abgelaufen sind, und wählen Sie den Typ anhand der Spalte reason:

    Grund in Mandrill Typ in Emailit
    hard-bounce, spam, custom recipient
    unsub unsubscribe, der Kampagnen stoppt, transaktionale E-Mails aber weiter durchlässt. Verwenden Sie recipient, um alle E-Mails zu blockieren, wie Mandrill es getan hat.
    soft-bounce Lassen Sie den Eintrag weg. Diese Einträge laufen nach einem Tag ab.
    CSV
    email,type,reason
    old-address@example.com,recipient,mandrill hard-bounce
    angry@example.com,recipient,mandrill spam

    Der Typ recipient blockiert Versände per API, SMTP und Kampagne. Wenn Sie Subaccounts genutzt haben, teilen Sie die Datei anhand ihrer Spalte für den Subaccount auf und importieren Sie jeden Teil in den passenden Workspace.

  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.

Für die Rejection Allowlist von Mandrill gibt es keine Entsprechung. Siehe Sperrungen verwalten.

Vorlagen umziehen

Holen Sie den Code Ihrer Vorlagen aus Mandrill: Ein einziger Aufruf von /templates/list gibt jede Vorlage mit ihrem slug und ihrem veröffentlichten HTML in publish_code zurück. Importieren Sie dann jede unter Email MarketingTemplates oder erstellen Sie sie mit der Vorlagen-API. Verwenden Sie den Slug aus Mandrill als Alias, sofern er dem Alias-Format aus Kleinbuchstaben, Ziffern, - und _ entspricht.

Vorlagen mit mc:edit-Bereichen, die über template_content gefüllt wurden, brauchen statt dieser Bereiche Variablen. Bei den Namen von Merge-Variablen in Mandrill spielt die Groß-/Kleinschreibung keine Rolle, bei Temple schon: {{FNAME}} passt nur zu einer Variablen namens FNAME. Wandeln Sie Merge-Tags in Temple um:

Mandrill Emailit (Temple)
*|FNAME|* (Merge-Sprache Mailchimp) {{FNAME}}, oder benennen Sie es in {{first_name}} um
{{fname}} (Merge-Sprache Handlebars) {{fname}}
*|IF:FNAME|*…*|ELSE:|*…*|END:IF|* {{#if FNAME}}…{{else}}…{{/if}}
*|IF:PLAN=pro|* oder ein Vergleich in einem {{#if}} von Handlebars Nicht unterstützt. Übergeben Sie einen Boolean wie is_pro und verwenden Sie {{#if is_pro}}.
*|DATE:d/m/y|*, *|CURRENT_YEAR|*, Helper wie {{upper name}} Nicht unterstützt. Formatieren Sie den Wert in Ihrem Code und übergeben Sie ihn.
*|UNSUB:https://…|*, {{unsub "…"}} Ihr eigener Abmeldelink. Siehe Abmeldungen.
{{#if plan}}…{{else}}…{{/if}} Identisch
{{#each items}}…{{/each}} Nicht unterstützt. Rendern Sie die Liste in Ihrem Code und übergeben Sie sie als eine Variable.
<div mc:edit="body">…</div> mit template_content {{body}}, übergeben in variables
global_merge_vars variables

Temple maskiert HTML nie. Maskieren Sie Benutzereingaben daher, bevor Sie sie übergeben. Ein fehlender Wert wird als leerer String dargestellt, sofern Sie keinen Standardwert hinzufügen, etwa {{name|"there"}}. Siehe Temple.

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 CNAMEs mte1._domainkey und mte2._domainkey von Mandrill noch mit dessen TXT-Eintrag mandrill_verify. Behalten Sie Ihren DMARC-Eintrag. Siehe DNS-Einträge.

Entfernen Sie nach der Umstellung die DKIM- und Verifizierungseinträge von Mandrill, alle eigenen CNAMEs für Tracking oder Return-Path und include:spf.mandrillapp.com, falls Ihr SPF-Eintrag es enthält. Wenn Sie E-Mails mit Inbound-Routes von Mandrill empfangen, verlagern Sie das zuerst auf eine Inbound-Subdomain von Emailit.

Nächste Schritte

War diese Seite hilfreich?

Danke für Ihr Feedback.

Danke, wir lesen jede Nachricht.