# Von Mailjet migrieren

> Wechseln Sie von Mailjet zu Emailit. API-Schlüsselpaare und Absender zuordnen, Aufrufe der Send API v3.1 und die Template-Sprache umwandeln, SMTP umstellen und Webhooks, Ausschlüsse und Kontaktlisten umziehen.

Diese Anleitung ordnet Konzepte, API-Aufrufe, Webhooks, Sperrungen, Vorlagen und Kontakte von Mailjet 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

| Mailjet | Emailit |
| --- | --- |
| Primärer API-Schlüssel und API-Schlüssel von Unterkonten | Konto und [Workspaces](/de/docs/workspaces/). Jeder Workspace hat eigene Domains, Schlüssel, Mitglieder und Credits. |
| API-Schlüsselpaar (öffentlicher und geheimer Schlüssel) | [API-Schlüssel](/de/docs/developers/api-keys/): **Full Access** oder **Sending Only**, optional auf eine Domain beschränkt |
| Absender: einzelne Adressen und ganze Domains | [Versanddomains](/de/docs/domains/). Einzelne Absenderadressen sind nicht verfügbar. |
| `SandboxMode` | Kein Testmodus. Neue Workspaces sind im [Sandbox-Modus](/de/docs/workspaces/production-access/) und stellen nur an Mitglieder des Workspace zu. |
| Vorlagen und die Template-Sprache von Mailjet | [Vorlagen](/de/docs/templates/) mit Alias und Versionen, gerendert mit [Temple](/de/docs/templates/temple/) |
| Event API, eine URL pro Event-Typ | [Webhooks](/de/docs/webhooks/): Ein Endpunkt kann jeden Event-Typ empfangen |
| Parse API | [Eingehende E-Mails](/de/docs/inbound/) |
| Ausschlussliste, Adressen mit Spam-Beschwerden und blockierte Adressen | [Sperrungen](/de/docs/suppressions/) |
| Kontakte, Kontaktlisten und Kontakteigenschaften | [Kontakte](/de/docs/contacts/), [Kontaktlisten](/de/docs/audiences/) und [eigene Felder](/de/docs/contacts/custom-fields/) |
| Segmente | Wählen Sie in jeder Kampagne die einzuschließenden und auszuschließenden Kontaktlisten. [Segmente](/de/docs/segments/) sind in der Alpha und stehen nur dem Emailit-Team offen. |
| Kampagnen und Automatisierungen | [Kampagnen](/de/docs/campaigns/) und [Automatisierungen](/de/docs/automations/) (Beta) |
| `CustomID`, `EventPayload`, `CustomCampaign` | `meta` |
| Statistiken und Nachrichtenverlauf | **Email API → Emails**, **Email API → Logs** und [Kampagnenberichte](/de/docs/campaigns/reports/) |

## API-Aufrufe anpassen

`POST /v3.1/send` von Mailjet nimmt Basic Authentication und eine Liste `Messages` mit Feldern in PascalCase an. `POST /v2/emails` von Emailit nimmt ein Bearer-Token und eine einzelne Nachricht mit kleingeschriebenen Feldern an:

```bash title="Before: Mailjet"
curl https://api.mailjet.com/v3.1/send \
  --user "$MJ_APIKEY_PUBLIC:$MJ_APIKEY_PRIVATE" \
  -H "Content-Type: application/json" \
  -d '{
    "Messages": [{
      "From": { "Email": "hello@acme.com", "Name": "Acme" },
      "To": [{ "Email": "ada@example.com" }],
      "Subject": "Your receipt",
      "TextPart": "Thanks for your order.",
      "HTMLPart": "<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>"
  }'
```

| Mailjet (Send API v3.1) | Emailit |
| --- | --- |
| Basic Authentication mit öffentlichem und geheimem Schlüssel | `Authorization: Bearer secret_…` |
| `api.mailjet.com` oder `api.us.mailjet.com` für US-Konten | Ein Host, `api.emailit.com` |
| `Messages[]`, bis zu 50 pro Aufruf | Eine Nachricht pro Anfrage |
| `From: { Email, Name }` | `from: "Name "` |
| `To`, `Cc`, `Bcc` mit `Email` und `Name` | `to`, `cc`, `bcc` als String oder Array mit jeweils bis zu 50 |
| `ReplyTo` | `reply_to` |
| `Subject`, `TextPart`, `HTMLPart` | `subject`, `text`, `html` |
| `Headers` | `headers` |
| `Attachments[]` mit `ContentType`, `Filename`, `Base64Content` | `attachments[]` mit `content_type`, `filename`, `content` |
| `InlinedAttachments[]` mit `ContentID` | `attachments[]` mit einer `content_id`, im HTML als `cid:` referenziert |
| `CustomID`, `EventPayload`, `CustomCampaign` | `meta`, etwa `meta: { "custom_id": "order-123" }`, in Webhook-Events zurückgegeben |
| `TemplateID`, `TemplateLanguage: true` und `Variables` | `template` (ein Alias oder eine ID) und `variables` |
| `TrackOpens`, `TrackClicks` | `tracking: { "loads": true, "clicks": true }` |
| `URLTags` | Fügen Sie Ihren Links UTM-Parameter hinzu. Kampagnen fügen sie für Sie hinzu. |
| `Globals` | Nicht verfügbar. Wiederholen Sie die gemeinsamen Felder in jeder Anfrage. |
| Antwort mit `MessageUUID` und `MessageID` für jeden Empfänger | `200` mit `id` (`em_…`), `status: "accepted"` und, bei mehreren Empfängern, `ids` mit einer ID pro Empfänger |

IDs von Emailit sind Strings, Sie müssen also nicht mehr mit den großen Integer-Werten in `MessageID` von Mailjet umgehen. Emailit unterstützt außerdem Planung mit `scheduled_at` und sichere Wiederholungen mit einem Header `Idempotency-Key`. Siehe [E-Mail senden](/de/docs/email-api/send-email/).

## SMTP-Einstellungen umstellen

| Einstellung | Mailjet | Emailit |
| --- | --- | --- |
| Host | `in-v3.mailjet.com` | `smtp.emailit.com` |
| Port | `587`, `588`, `2525`, `25` oder `80` (STARTTLS), `465` (TLS) | `587`, `2587`, `2525` oder `25` (STARTTLS), `465` (TLS) |
| Benutzername | Ihr öffentlicher API-Schlüssel | `emailit` |
| Passwort | Ihr geheimer API-Schlüssel | Ihr Emailit-API-Schlüssel |

Emailit liest die Header von Mailjet nicht, etwa `X-Mailjet-Campaign`, `X-MJ-CustomID`, `X-MJ-EventPayload`, `X-Mailjet-TrackOpen`, `X-Mailjet-TrackClick`, `X-MJ-TemplateID` oder `X-MJ-Vars`. Entfernen Sie sie. Legen Sie das Tracking bei der Domain fest und nutzen Sie die API, wenn Sie Vorlagen oder Metadaten benötigen. Siehe [SMTP-Einstellungen](/de/docs/smtp/settings/).

## Webhook-Events zuordnen

| Mailjet-Event | Emailit-Event |
| --- | --- |
| `sent` | `email.delivered` |
| `bounce` | `email.bounced`. Emailit sendet außerdem `email.attempted` für jeden fehlgeschlagenen Versuch, den es wiederholt. |
| `blocked` | `email.suppressed`, wenn die Adresse eine Sperrung vom Typ `recipient` hat |
| `spam` | `email.complained` |
| `open` | `email.loaded` |
| `click` | `email.clicked` |
| `unsub` | `email.unsubscribed`, nur für Kampagnen-E-Mails |
| Route der Parse API | `email.received`, dann den Inhalt mit [`GET /emails/{id}`](/de/docs/api-reference/emails/get/) abrufen |

Emailit sendet außerdem `email.accepted`, wenn die API eine E-Mail annimmt. Siehe [Event-Typen](/de/docs/webhooks/event-types/).

Das Anfrageformat ändert sich:

- Mailjet braucht eine URL pro Event-Typ und sendet ein Event pro Anfrage, sofern Sie Events nicht gruppieren. Ein Webhook von Emailit kann viele Event-Typen abonnieren und sendet ein JSON-Array mit bis zu 100 Events. Iterieren Sie also über den Body.
- Der Event-Name wandert von `event` nach `type`, und die E-Mail steht in `data.object`. Verwenden Sie `data.object.id`, die `em_`-ID aus der Antwort auf den Versand, statt `MessageID` oder `Message_GUID` und `data.object.to` statt `email`. Ihre `meta`-Werte, die `CustomID` und `Payload` ersetzen, 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.
- Mailjet signiert seine Anfragen nicht. Emailit signiert jede: Verifizieren Sie `X-Emailit-Signature` anhand von `X-Emailit-Timestamp` und Ihrem `whsec_`-Secret und entfernen Sie die Basic-Authentication-Zugangsdaten aus Ihrer URL, wenn Sie möchten. 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

Mailjet hat keine einheitliche Sperrliste. Sammeln Sie die Adressen daher an mehreren Stellen:

1. Sammeln Sie die Adressen, die Mailjet blockiert:

   | Mailjet | Export | Typ in Emailit |
   | --- | --- | --- |
   | Ausschlussliste | Der Download der Ausschlussliste im Dashboard oder `GET /v3/REST/contact?IsExcludedFromCampaigns=true` | `unsubscribe`, der Kampagnen stoppt, transaktionale E-Mails aber weiter durchlässt, wie die Ausschlussliste von Mailjet |
   | Adressen mit Spam-Beschwerden | Kontakte mit gesetztem `IsSpamComplaining`, aus `GET /v3/REST/contact` | `recipient` |
   | Hard Bounces | Die `bounce`-Events, die Ihre Webhooks gespeichert haben, oder Ihre Kampagnenberichte | `recipient` |

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

```csv
email,type,reason
excluded@example.com,unsubscribe,mailjet exclusion list
angry@example.com,recipient,mailjet spam complaint
```

   Der Typ `recipient` blockiert Versände per API, SMTP und Kampagne.

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.

Wenn Sie mehrere API-Schlüssel von Mailjet genutzt haben, wiederholen Sie das für jeden. Siehe [Sperrungen verwalten](/de/docs/suppressions/manage/).

## Kontakte umziehen

Exportieren Sie jede Kontaktliste unter **Contacts** in Mailjet oder mit `GET /v3/REST/listrecipient?ContactsList={id}`, das für jedes Mitglied das Flag `IsUnsubscribed` enthält. Kontakteigenschaften liefert `GET /v3/REST/contactdata`.

1. **Emailit vorbereiten.** Erstellen Sie ein [eigenes Feld](/de/docs/contacts/custom-fields/) für jede Kontakteigenschaft, die Sie nutzen, und eine [Kontaktliste](/de/docs/audiences/) für jede Liste.

2. **Angemeldete Mitglieder importieren.** Wählen Sie unter **Email Marketing → Contacts** die Option **Import**, ordnen Sie die Spalten zu und wählen Sie die passende Kontaktliste. Teilen Sie Dateien in Teile mit bis zu 2.500 Zeilen auf. Siehe [Kontakte importieren und exportieren](/de/docs/contacts/import-export/).

3. **Den Rest sperren.** Der Import fügt alle Personen in der Datei als angemeldet hinzu. Lassen Sie abgemeldete Mitglieder daher aus der Datei heraus. Fügen Sie sie stattdessen mit dem Typ `unsubscribe` Ihrer CSV-Datei mit Sperrungen hinzu und lassen Sie Kontakte weg, deren Opt-in noch aussteht. Eine Sperrung vom Typ `unsubscribe` stoppt jede Kampagne. Fügen Sie daher keine für Personen hinzu, die noch eine andere Liste abonniert haben, die Sie umziehen.

Legen Sie Ihre Kampagnen und Automatisierungen unter **Email Marketing → Campaigns** und **Automations** neu an, ausgehend von Ihren importierten Vorlagen.

## Vorlagen umziehen

Rufen Sie das HTML jeder Vorlage mit `GET /v3/REST/template/{id}/detailcontent` ab, das `Html-part` und `Text-part` zurückgibt, oder kopieren Sie es aus dem Editor von Mailjet. Importieren Sie es unter **Email Marketing → Templates** oder erstellen Sie die Vorlage mit der [Vorlagen-API](/de/docs/api-reference/templates/create/) und geben Sie ihr einen Alias, etwa `receipt`.

Wandeln Sie die Template-Sprache von Mailjet in Temple um:

| Mailjet | Emailit (Temple) |
| --- | --- |
| `{{var:name}}`, `{{var:order.total}}` | `{{name}}`, `{{order.total}}` |
| `{{var:name:"there"}}` | `{{name\|"there"}}` |
| `{{data:firstname}}` (eine Kontakteigenschaft) | `{{first_name}}` oder `{{cf.<key>}}` in Kampagnen. Bei Versänden per API übergeben Sie den Wert in `variables`. |
| `{% if var:plan %}…{% else %}…{% endif %}` | `{{#if plan}}…{{else}}…{{/if}}` |
| `{% if var:plan == "pro" %}`, `{% elseif %}` | Nicht unterstützt. Übergeben Sie einen Boolean wie `is_pro` und verwenden Sie `{{#if is_pro}}`. |
| `{% for item in var:items %}…{% endfor %}` | Nicht unterstützt. Rendern Sie die Liste in Ihrem Code und übergeben Sie sie als eine Variable. |
| Funktionen wie `Upper()` oder `FormatNumber()` | Nicht unterstützt. Formatieren Sie den Wert in Ihrem Code. |
| `{{mj:unsub_link}}` | `{{unsubscribe_url}}` in Kampagnen |
| `Variables` | `variables` |

Temple maskiert 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 dem DKIM-Eintrag `mailjet._domainkey` von Mailjet noch mit dessen TXT-Eintrag für den Inhabernachweis. Behalten Sie Ihren DMARC-Eintrag. Siehe [DNS-Einträge](/de/docs/domains/dns-records/).

Wenn Ihr eigener Tracking-Host bei Mailjet bereits `go` heißt, wählen Sie mit `tracking_key` einen anderen Namen für den Tracking-Host von Emailit. Siehe [Eigene Tracking-Domain einrichten](/de/docs/tracking/custom-tracking-domain/).

Entfernen Sie nach der Umstellung die Einträge von Mailjet für DKIM, Inhabernachweis, Tracking und Return-Path sowie `include:spf.mailjet.com` aus Ihrem SPF-Eintrag. Wenn Sie E-Mails mit der Parse API auf Ihrer eigenen Domain 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/mailjet/
