Переезд с Amazon SES
Переезжайте с Amazon SES
на OpenEmail.
Вызовы SESv2, наборы конфигураций и события SNS, сопоставленные поле за полем, и конвертер, который переписывает ваш код.
Одно и то же письмо,
написанное двумя способами.
Одно письмо с адресом для ответа и тегом, отправленное через Amazon SES, а затем через OpenEmail.
import { SESv2Client, SendEmailCommand } from '@aws-sdk/client-sesv2'const ses = new SESv2Client({ region: 'us-east-1' })const result = await ses.send(new SendEmailCommand({FromEmailAddress: 'Acme <[email protected]>',Destination: { ToAddresses: ['[email protected]'] },ReplyToAddresses: ['[email protected]'],Content: {Simple: {Subject: { Data: 'Your invoice is ready' },Body: { Html: { Data: '<p>Thanks for your order.</p>' } },},},EmailTags: [{ Name: 'category', Value: 'invoice' }],}),)console.log(result.MessageId)
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]'],replyTo: '[email protected]',subject: 'Your invoice is ready',html: '<p>Thanks for your order.</p>',tags: { category: 'invoice' },})console.log(email.id)
Поле за полем:
что куда переходит.
Каждый параметр, который принимает Amazon SES, и его место в OpenEmail.
| Amazon SES | OpenEmail | Примечания |
|---|---|---|
FromEmailAddress | from | Также принимает имя и адрес вместе. |
Destination.ToAddresses | to | CcAddresses и BccAddresses становятся cc и bcc. |
ReplyToAddresses | replyTo | Один адрес на письмо. |
Content.Simple.Subject.Data | subject | Обычная строка. |
Content.Simple.Body.Html.Data | html | Текстовая версия идёт в text. |
EmailTags: [{ Name, Value }] | tags: { Name: Value } | До 10 пар ключей и значений. |
Content.Template.TemplateData | template: { id, props } | Props передаются объектом, а не строкой JSON. |
SendBulkEmail | emails.sendBatch | До 100 писем, каждое отправляется отдельно. |
ConfigurationSetName | webhooks.create | События приходят через вебхуки. |
AWS credentials, region | OPENEMAIL_API_KEY | Один ключ и никакого региона. |
Конвертер
Вставьте свой код для Amazon SES
и получите его на OpenEmail.
Выберите, откуда код и на каком он языке. Распознанные ключи удаляются в вашем браузере, а вставленное нигде не хранится.
Помимо кода,
ещё четыре шага.
- 01
Добавьте домен отправки
Добавьте его в OpenEmail и опубликуйте указанные DNS-записи. Отправка начнётся, когда запись подписи станет отвечать.
- 02
Создайте API-ключ
Ключи начинаются с oe_live_ и получают только те права, которые вы им дадите.
- 03
Перенесите вебхуки
Создайте эндпоинт для событий из списка ниже и проверяйте заголовок X-OpenEmail-Signature в каждом запросе.
- 04
Перенесите контакты и список блокировки
Импортируйте контакты из CSV на странице аудитории и добавьте в список блокировки адреса, которые блокировал Amazon SES.
События вебхуков,
под новыми именами.
Каждое событие Amazon SES и событие OpenEmail, которое его заменяет. Каждый запрос несёт одно событие и подписан.
| Amazon SES | OpenEmail |
|---|---|
Send | email.sent |
Delivery | email.delivered |
DeliveryDelay | email.delivery_delayed |
Bounce | email.bounced |
Complaint | email.complained |
Open | email.opened |
Click | email.clicked |
Reject | email.failed |
Переезд с Amazon SES:
ответы на вопросы.
Переходите
с другой платформы?
В каждом руководстве тот же конвертер, та же карта полей и тот же чек-лист.
Сконвертировали?
Создайте ключ, который читает код.
Рабочее пространство создаётся за минуту. Добавьте свой домен, создайте API-ключ и задайте OPENEMAIL_API_KEY.