Переезд с SendGrid
Переезжайте с SendGrid
на OpenEmail.
Персонализации, динамические шаблоны, категории и вебхук событий, сопоставленные поле за полем, и конвертер, который переписывает ваш код.
Одно и то же письмо,
написанное двумя способами.
Одно письмо с адресом для ответа и тегом, отправленное через SendGrid, а затем через OpenEmail.
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)}
Поле за полем:
что куда переходит.
Каждый параметр, который принимает SendGrid, и его место в OpenEmail.
| SendGrid | OpenEmail | Примечания |
|---|---|---|
personalizations[].to | to | Одно письмо на каждую персонализацию. |
reply_to | replyTo | Один адрес на письмо. |
content[] | html, text | Отдельное поле для каждого типа содержимого. |
template_id, dynamic_template_data | template: { id, props } | Сначала создайте шаблон заново в OpenEmail. |
categories, custom_args | tags | До 10 пар ключей и значений. |
send_at | scheduledAt | Дата вместо секунд Unix. |
tracking_settings | tracking: { opens, clicks } | Два переключателя в каждом письме. |
attachments[].type | attachments[].contentType | Base64 или байты, в сумме до 5 МБ. |
batch_id | emails.cancel(id) | Отменяйте каждое письмо по его собственному id. |
asm.group_id | suppressions.add | Отписки попадают в один список блокировки. |
Конвертер
Вставьте свой код для SendGrid
и получите его на OpenEmail.
Выберите, откуда код и на каком он языке. Распознанные ключи удаляются в вашем браузере, а вставленное нигде не хранится.
Помимо кода,
ещё четыре шага.
- 01
Добавьте домен отправки
Добавьте его в OpenEmail и опубликуйте указанные DNS-записи. Отправка начнётся, когда запись подписи станет отвечать.
- 02
Создайте API-ключ
Ключи начинаются с oe_live_ и получают только те права, которые вы им дадите.
- 03
Перенесите вебхуки
Создайте эндпоинт для событий из списка ниже и проверяйте заголовок X-OpenEmail-Signature в каждом запросе.
- 04
Перенесите контакты и список блокировки
Импортируйте контакты из CSV на странице аудитории и добавьте в список блокировки адреса, которые блокировал SendGrid.
События вебхуков,
под новыми именами.
Каждое событие SendGrid и событие OpenEmail, которое его заменяет. Каждый запрос несёт одно событие и подписан.
| 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 |
Переезд с SendGrid:
ответы на вопросы.
Переходите
с другой платформы?
В каждом руководстве тот же конвертер, та же карта полей и тот же чек-лист.
Сконвертировали?
Создайте ключ, который читает код.
Рабочее пространство создаётся за минуту. Добавьте свой домен, создайте API-ключ и задайте OPENEMAIL_API_KEY.