Zum Inhalt springen
Doku

Leitfaden

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.

Aktualisiert am 23. Okt. 2026

Diese Anleitung ordnet Konzepte, API-Aufrufe, Webhooks, Sperrungen, Vorlagen und Kontakte von Mailjet ihren Entsprechungen in Emailit zu. Lesen Sie zuerst Zu Emailit migrieren 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. Jeder Workspace hat eigene Domains, Schlüssel, Mitglieder und Credits.
API-Schlüsselpaar (öffentlicher und geheimer Schlüssel) API-Schlüssel: Full Access oder Sending Only, optional auf eine Domain beschränkt
Absender: einzelne Adressen und ganze Domains Versanddomains. Einzelne Absenderadressen sind nicht verfügbar.
SandboxMode Kein Testmodus. Neue Workspaces sind im Sandbox-Modus und stellen nur an Mitglieder des Workspace zu.
Vorlagen und die Template-Sprache von Mailjet Vorlagen mit Alias und Versionen, gerendert mit Temple
Event API, eine URL pro Event-Typ Webhooks: Ein Endpunkt kann jeden Event-Typ empfangen
Parse API Eingehende E-Mails
Ausschlussliste, Adressen mit Spam-Beschwerden und blockierte Adressen Sperrungen
Kontakte, Kontaktlisten und Kontakteigenschaften Kontakte, Kontaktlisten und eigene Felder
Segmente Wählen Sie in jeder Kampagne die einzuschließenden und auszuschließenden Kontaktlisten. Segmente sind in der Alpha und stehen nur dem Emailit-Team offen.
Kampagnen und Automatisierungen Kampagnen und Automatisierungen (Beta)
CustomID, EventPayload, CustomCampaign meta
Statistiken und Nachrichtenverlauf Email APIEmails, Email APILogs und Kampagnenberichte

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:

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>"
    }]
  }'
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 <email>"
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.

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.

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} abrufen

Emailit sendet außerdem email.accepted, wenn die API eine E-Mail annimmt. Siehe Event-Typen.

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

Wenn Sie mehrere API-Schlüssel von Mailjet genutzt haben, wiederholen Sie das für jeden. Siehe Sperrungen verwalten.

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 für jede Kontakteigenschaft, die Sie nutzen, und eine Kontaktliste für jede Liste.

  2. Angemeldete Mitglieder importieren. Wählen Sie unter Email MarketingContacts 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.

  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 MarketingCampaigns 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 MarketingTemplates oder erstellen Sie die Vorlage mit der Vorlagen-API 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 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 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.

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.

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 von Emailit.

Nächste Schritte

War diese Seite hilfreich?

Danke für Ihr Feedback.

Danke, wir lesen jede Nachricht.