Umzug von SendGrid
Zieh von SendGrid
zu OpenEmail um.
Personalisierungen, dynamische Vorlagen, Kategorien und der Event-Webhook, 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 SendGrid und dann über OpenEmail gesendet.
import sgMail from '@sendgrid/mail'sgMail.setApiKey(process.env.SENDGRID_API_KEY)try {const [response] = await sgMail.send({from: { email: '[email protected]', name: 'Acme' },to: '[email protected]',replyTo: '[email protected]',subject: 'Your invoice is ready',html: '<p>Thanks for your order.</p>',categories: ['invoice'],})console.log(response.statusCode)} catch (error) {console.error(error.response?.body ?? error)}
import { init, openemail } from '@openemail/sdk'init({ apiKey: process.env.OPENEMAIL_API_KEY })try {const email = await openemail.emails.send({from: { email: '[email protected]', name: 'Acme' },to: '[email protected]',replyTo: '[email protected]',subject: 'Your invoice is ready',html: '<p>Thanks for your order.</p>',tags: { category: 'invoice' },})console.log(email.status)} catch (error) {console.error(error.message)}
Feld für Feld,
was wohin gehört.
Jede Option, die SendGrid annimmt, und ihr Platz in OpenEmail.
| SendGrid | OpenEmail | Hinweise |
|---|---|---|
personalizations[].to | to | Eine Nachricht pro Personalisierung. |
reply_to | replyTo | Eine Adresse pro Nachricht. |
content[] | html, text | Ein Feld pro Inhaltstyp. |
template_id, dynamic_template_data | template: { id, props } | Leg die Vorlage zuerst in OpenEmail neu an. |
categories, custom_args | tags | Bis zu 10 Schlüssel-Wert-Paare. |
send_at | scheduledAt | Ein Datum statt Unix-Sekunden. |
tracking_settings | tracking: { opens, clicks } | Zwei Schalter pro Nachricht. |
attachments[].type | attachments[].contentType | Base64 oder Bytes, insgesamt 5 MB. |
batch_id | emails.cancel(id) | Storniere jede Nachricht über ihre eigene ID. |
asm.group_id | suppressions.add | Abmeldungen landen in einer einzigen Sperrliste. |
Konverter
Füge deinen Code für SendGrid 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 SendGrid gesperrt hat, zur Sperrliste hinzu.
Webhook-Ereignisse,
umbenannt.
Jedes Ereignis von SendGrid und das OpenEmail-Ereignis, das es ersetzt. Jede Anfrage trägt ein Ereignis und ist signiert.
| SendGrid | OpenEmail |
|---|---|
processed | email.sent |
delivered | email.delivered |
deferred | email.delivery_delayed |
bounce | email.bounced |
dropped | email.suppressed |
spamreport | email.complained |
open | email.opened |
click | email.clicked |
unsubscribe | suppression.added |
Fragen zum Umzug von SendGrid,
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.