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.
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:
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>"
}]
}'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
eventnachtype, und die E-Mail steht indata.object. Verwenden Siedata.object.id, dieem_-ID aus der Antwort auf den Versand, stattMessageIDoderMessage_GUIDunddata.object.tostattemail. Ihremeta-Werte, dieCustomIDundPayloadersetzen, stehen indata.object.meta. - Bei
email.loadedundemail.clickedistdata.objectder Ladevorgang oder der Klick. Verwenden Siedata.object.email_idfür die ID der E-Mail sowiedata.object.email.rcpt_tounddata.object.email.metafür den Empfänger und Ihremeta-Werte. - Mailjet signiert seine Anfragen nicht. Emailit signiert jede: Verifizieren Sie
X-Emailit-Signatureanhand vonX-Emailit-Timestampund Ihremwhsec_-Secret und entfernen Sie die Basic-Authentication-Zugangsdaten aus Ihrer URL, wenn Sie möchten. Siehe Anfragesignatur.
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:
-
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=trueunsubscribe, der Kampagnen stoppt, transaktionale E-Mails aber weiter durchlässt, wie die Ausschlussliste von MailjetAdressen mit Spam-Beschwerden Kontakte mit gesetztem IsSpamComplaining, ausGET /v3/REST/contactrecipientHard Bounces Die bounce-Events, die Ihre Webhooks gespeichert haben, oder Ihre Kampagnenberichterecipient -
Erstellen Sie eine CSV-Datei mit den Spalten
email,type,reason:email,type,reason excluded@example.com,unsubscribe,mailjet exclusion list angry@example.com,recipient,mailjet spam complaintDer Typ
recipientblockiert Versände per API, SMTP und Kampagne. -
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.
-
Emailit vorbereiten. Erstellen Sie ein eigenes Feld für jede Kontakteigenschaft, die Sie nutzen, und eine Kontaktliste für jede Liste.
-
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.
-
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
unsubscribeIhrer CSV-Datei mit Sperrungen hinzu und lassen Sie Kontakte weg, deren Opt-in noch aussteht. Eine Sperrung vom Typunsubscribestoppt 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
- Go-live-Checkliste
- Webhook einrichten
- Priority migration: Lassen Sie Engineers von Emailit den Umzug gemeinsam mit Ihnen erledigen