Von Mailgun migrieren

Diese Anleitung ordnet Konzepte, API-Aufrufe, Webhooks, Sperrungen und Vorlagen von Mailgun ihren Entsprechungen in Emailit zu. Lesen Sie zuerst Zu Emailit migrieren für die allgemeine Reihenfolge und den parallelen Betrieb beider Anbieter.

Konzepte

API-Aufrufe anpassen

POST /v3/<domain>/messages von Mailgun nimmt Formularfelder mit Basic Authentication an. POST /v2/emails von Emailit nimmt JSON mit einem Bearer-Token an:

curl -s --user "api:$MAILGUN_API_KEY" \
  https://api.mailgun.net/v3/mg.acme.com/messages \
  -F from='Acme <hello@mg.acme.com>' \
  -F to='ada@example.com' \
  -F subject='Your receipt' \
  -F text='Thanks for your order.' \
  --form-string html='<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@mg.acme.com>",
    "to": "ada@example.com",
    "subject": "Your receipt",
    "text": "Thanks for your order.",
    "html": "<p>Thanks for your order.</p>"
  }'

Wenn Sie von einer Subdomain wie mg.acme.com gesendet haben, fügen Sie genau diese Subdomain in Emailit hinzu. Subdomains werden getrennt von der übergeordneten Domain verifiziert. Die EU- und US-API-Hosts von Mailgun entsprechen beide dem einen Endpunkt von Emailit. Siehe E-Mail senden.

SMTP-Einstellungen umstellen

Emailit liest keine X-Mailgun-*-Header. Entfernen Sie sie und legen Sie das Tracking stattdessen bei der Domain fest. Siehe SMTP-Einstellungen.

Webhook-Events zuordnen

Das Anfrageformat ändert sich:

• Mailgun sendet ein Event pro Anfrage, mit den Details in event-data. Emailit sendet ein JSON-Array mit bis zu 100 Events. Iterieren Sie über das Array.
• 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, um Events Nachrichten zuzuordnen. Ihre meta-Werte stehen in data.object.meta.
• Mailgun signiert einen Zeitstempel und ein Token im Body. Emailit signiert den gesamten unveränderten Body: Verifizieren Sie X-Emailit-Signature anhand von X-Emailit-Timestamp und Ihrem whsec_-Secret. 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

1. Exportieren Sie die Listen Bounces, Complaints und Unsubscribes jeder Mailgun-Domain, von der Sie senden, im Control Panel oder mit der Suppressions-API (/v3/<domain>/bounces, /complaints und /unsubscribes).

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

   CSV

   email,type,reason
   old-address@example.com,recipient,mailgun bounce
   angry@example.com,recipient,mailgun 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. Die Typen bounce, complaint und unsubscribe stoppen nur Kampagnen.

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 Mailgun-Domains in dieselbe Liste. Eine Allowlist gibt es nicht. Siehe Sperrungen verwalten.

Vorlagen umziehen

Kopieren Sie das HTML jeder Vorlage aus Mailgun und importieren Sie es dann unter Email Marketing›Templates oder erstellen Sie die Vorlage mit der Vorlagen-API. Geben Sie ihr einen Alias und senden Sie sie mit "template": "<alias>" und variables.

Mailgun-Vorlagen verwenden Handlebars. Temple deckt die üblichen Teile ab:

Siehe Temple und Vorlagen importieren und exportieren.

DNS ändern

Fügen Sie jede 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 von Mailgun noch mit dessen Tracking-CNAME email.<domain>. Ihren SPF-Eintrag auf der Hauptdomain müssen Sie für Emailit nicht ändern. Behalten Sie Ihren DMARC-Eintrag. Siehe DNS-Einträge.

Entfernen Sie nach der Umstellung die DKIM- und Tracking-Einträge von Mailgun und entfernen Sie include:mailgun.org aus Ihrem SPF-Eintrag. Wenn Sie E-Mails über Routes von Mailgun empfangen, behalten Sie dessen MX-Einträge, bis Sie diesen Verkehr auf eingehende E-Mails bei Emailit umgestellt haben, die auf einer Subdomain wie inbound.acme.com empfangen.

Nächste Schritte

• Go-live-Checkliste
• Webhook einrichten
• Priority migration: Lassen Sie Engineers von Emailit den Umzug gemeinsam mit Ihnen erledigen