# 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](/de/docs/migrate/) für die allgemeine Reihenfolge und den parallelen Betrieb beider Anbieter.

## Konzepte

| MailerSend | Emailit |
| --- | --- |
| Konto | Konto und [Workspaces](/de/docs/workspaces/). Jeder Workspace hat eigene Domains, Schlüssel, Mitglieder und Credits. |
| Domains | [Versanddomains](/de/docs/domains/) |
| Absenderidentitäten | Nicht verfügbar. Jede Absenderadresse muss auf einer verifizierten Domain liegen. |
| API-Tokens mit Scopes | [API-Schlüssel](/de/docs/developers/api-keys/): **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](/de/docs/workspaces/production-access/) und können nur an Mitglieder des Workspace senden. |
| Vorlagen | [Vorlagen](/de/docs/templates/) mit Alias und Versionen, gerendert mit [Temple](/de/docs/templates/temple/) |
| Webhooks pro Domain | [Webhooks](/de/docs/webhooks/) pro Workspace |
| Inbound-Routen | [Eingehende E-Mails](/de/docs/inbound/) mit dem Webhook `email.received` oder die [Automatisierung](/de/docs/inbound/forward-with-automations/) **Forward received email** |
| Sperrungen pro Domain: Hard Bounces, Spam-Beschwerden, Abmeldungen, Blocklist | Eine [Sperrliste](/de/docs/suppressions/) pro Workspace |
| On-Hold-Liste | Nicht nötig. Emailit wiederholt Soft Bounces und meldet jeden Versuch als `email.attempted`. |
| Activity | **Email API → Emails** und **Email API → Logs** |
| Tags | `meta` |
| E-Mail-Verifizierung | [E-Mail-Verifizierung](/de/docs/email-verification/) |
| Dedizierte IPs | [Dedizierte IPs](/de/docs/deliverability/dedicated-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:

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

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

| MailerSend | Emailit |
| --- | --- |
| `Authorization: Bearer <token>` | `Authorization: Bearer secret_…` |
| `from: { email, name }` | `from: "Name "` |
| `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](/de/docs/email-api/headers-and-metadata/). |
| `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](/de/docs/email-api/send-email/).

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

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

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](/de/docs/suppressions/manage/).

## Vorlagen umziehen

Kopieren Sie das HTML jeder Vorlage aus dem Editor von MailerSend und importieren Sie es dann unter **Email Marketing → Templates** oder erstellen Sie die Vorlage mit der [Vorlagen-API](/de/docs/api-reference/templates/create/). 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](/de/docs/templates/temple/) und [Vorlagen importieren und exportieren](/de/docs/templates/import-export/).

## 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 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](/de/docs/domains/dns-records/).

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

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](/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/mailersend/
