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

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](/de/docs/migrate/) für die allgemeine Reihenfolge und den parallelen Betrieb beider Anbieter. Wenn Sie auch Kampagnen über Mailchimp senden, lesen Sie [Von Mailchimp migrieren](/de/docs/migrate/mailchimp/).

## 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](/de/docs/workspaces/), jeder mit eigenen Domains, Schlüsseln, Limits und Credits |
| API-Schlüssel | [API-Schlüssel](/de/docs/developers/api-keys/): **Full Access** oder **Sending Only**, optional auf eine Domain beschränkt |
| Test-API-Schlüssel | Kein Testmodus. Neue Workspaces sind im [Sandbox-Modus](/de/docs/workspaces/production-access/) und können nur an Mitglieder des Workspace senden. |
| Versanddomains und Verifizierung von DKIM/SPF | [Versanddomains](/de/docs/domains/) |
| Tracking-Domains | [Tracking-Subdomain](/de/docs/tracking/) wie `go.acme.com` |
| Vorlagen mit `mc:edit`-Bereichen | [Vorlagen](/de/docs/templates/) mit Alias und Versionen, gerendert mit [Temple](/de/docs/templates/temple/) |
| Webhooks | [Webhooks](/de/docs/webhooks/) |
| Inbound-Domains und Routes | [Eingehende E-Mails](/de/docs/inbound/) |
| Rejection Denylist | [Sperrungen](/de/docs/suppressions/) |
| Rejection Allowlist | Nicht verfügbar |
| Merge-Sprachen: Mailchimp und Handlebars | [Temple](/de/docs/templates/temple/) |
| Tags und Metadaten | `meta` |
| Outbound Activity | **Email API → Emails** und **Email API → Logs** |
| Dedizierte IPs und IP-Pools | [Dedizierte IPs](/de/docs/deliverability/dedicated-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:

```bash title="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>"
    }
  }'
```

```bash title="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 "` |
| `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](/de/docs/email-api/send-email/).

## 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](/de/docs/smtp/settings/).

## 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}`](/de/docs/api-reference/emails/get/) 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](/de/docs/webhooks/request-signature/).

```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 API → Suppressions** 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](/de/docs/suppressions/manage/).

## 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 Marketing → Templates** oder erstellen Sie sie mit der [Vorlagen-API](/de/docs/api-reference/templates/create/). 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](/de/docs/audiences/unsubscribes/#transactional-email-and-unsubscribes). |
| `{{#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. |
| `…` 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](/de/docs/templates/temple/).

## DNS ändern

Fügen Sie Ihre Domain unter **Email API → Domains** 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](/de/docs/domains/dns-records/).

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](/de/docs/inbound/set-up/) von Emailit.

## Nächste Schritte

- [Go-live-Checkliste](/de/docs/get-started/go-live/)
- [Webhook einrichten](/de/docs/webhooks/set-up/)
- [Priority migration](/de/docs/programs/priority-migration/): Lassen Sie Engineers von Emailit den Umzug gemeinsam mit Ihnen erledigen

---
Quelle: https://emailit.com/de/docs/migrate/mandrill/
