Umzug von Mailgun
Zieh von Mailgun
zu OpenEmail um.
Domains in der URL, o:-Optionen und v:-Variablen, Feld für Feld zugeordnet, mit einem Konverter, der deinen Code umschreibt.
Dieselbe E-Mail,
auf beide Arten geschrieben.
Eine Nachricht mit einer Reply-To-Adresse und einem Tag, erst über Mailgun und dann über OpenEmail gesendet.
import FormData from 'form-data'import Mailgun from 'mailgun.js'const mailgun = new Mailgun(FormData)const mg = mailgun.client({ username: 'api', key: process.env.MAILGUN_API_KEY })const result = await mg.messages.create('mg.acme.com', {from: 'Acme <[email protected]>',to: ['[email protected]'],subject: 'Your invoice is ready',html: '<p>Thanks for your order.</p>','h:Reply-To': '[email protected]','o:tag': ['invoice'],})console.log(result.id)
import { init, openemail } from '@openemail/sdk'init({ apiKey: process.env.OPENEMAIL_API_KEY })const email = await openemail.emails.send({from: 'Acme <[email protected]>',to: ['[email protected]'],subject: 'Your invoice is ready',html: '<p>Thanks for your order.</p>',replyTo: '[email protected]',tags: { tag: 'invoice' },})console.log(email.id)
Feld für Feld,
was wohin gehört.
Jede Option, die Mailgun annimmt, und ihr Platz in OpenEmail.
| Mailgun | OpenEmail | Hinweise |
|---|---|---|
messages.create(domain, …) | from | Die Domain der from-Adresse entscheidet. |
h:Reply-To | replyTo | Eine Adresse pro Nachricht. |
h:X-* | headers | Ein Objekt aus Namen und Werten. |
o:tag, v:* | tags | Bis zu 10 Schlüssel-Wert-Paare. |
o:deliverytime | scheduledAt | Eine ISO-Zeit statt eines Datums nach RFC 2822. |
o:tracking-opens, o:tracking-clicks | tracking: { opens, clicks } | Boolesche Werte statt yes und no. |
template, t:variables | template: { id, props } | Leg die Vorlage zuerst in OpenEmail neu an. |
attachment | attachments | Base64 oder Bytes, insgesamt 5 MB. |
recipient-variables | emails.sendBatch | Ein Eintrag pro Empfänger, mit eingesetzten Werten. |
Konverter
Füge deinen Code für Mailgun ein,
bekomm ihn auf OpenEmail umgestellt zurück.
Wähle, woher der Code kommt und in welcher Sprache er geschrieben ist. Erkannte Schlüssel werden in deinem Browser entfernt, und nichts, was du einfügst, wird aufbewahrt.
Über den Code hinaus,
vier weitere Schritte.
- 01
Absenderdomain hinzufügen
Füge sie in OpenEmail hinzu und veröffentliche die DNS-Einträge, die dort angezeigt werden. Der Versand startet, sobald der Signatur-Eintrag auflöst.
- 02
API-Schlüssel erstellen
Schlüssel beginnen mit oe_live_ und tragen nur die Berechtigungen, die du ihnen gibst.
- 03
Webhooks umziehen
Leg einen Endpunkt für die unten aufgeführten Ereignisse an und prüfe bei jeder Anfrage den Header X-OpenEmail-Signature.
- 04
Kontakte und Sperrliste mitnehmen
Importiere deine Kontakte als CSV auf einer Zielgruppenseite und füge die Adressen, die Mailgun gesperrt hat, zur Sperrliste hinzu.
Webhook-Ereignisse,
umbenannt.
Jedes Ereignis von Mailgun und das OpenEmail-Ereignis, das es ersetzt. Jede Anfrage trägt ein Ereignis und ist signiert.
| Mailgun | OpenEmail |
|---|---|
accepted | email.sent |
delivered | email.delivered |
failed (temporary) | email.delivery_delayed |
failed (permanent) | email.bounced |
complained | email.complained |
opened | email.opened |
clicked | email.clicked |
unsubscribed | suppression.added |
Fragen zum Umzug von Mailgun,
beantwortet.
Du ziehst von
woanders um?
Jede Anleitung hat denselben Konverter, dieselbe Feldzuordnung und dieselbe Checkliste.
Konvertiert?
Erstelle den Schlüssel, den dein Code liest.
Ein Workspace ist in einer Minute angelegt. Füge deine Domain hinzu, erstelle einen API-Schlüssel und setze OPENEMAIL_API_KEY.