同じメールを、
両方の書き方で。
返信先アドレスとタグを 1 つずつ付けたメッセージを、まず 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 | 1 通につきアドレスは 1 つ。 |
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 通。1 通ずつ個別に送信されます。 |
ConfigurationSetName | webhooks.create | イベントは Webhook で届きます。 |
AWS credentials, region | OPENEMAIL_API_KEY | キーは 1 つ、リージョンは不要。 |
コンバーター
Amazon SES のコードを貼り付けて、
OpenEmail 用のコードを受け取る。
コードの移行元と言語を選んでください。検出したキーはブラウザ内で取り除き、貼り付けた内容は保存しません。
コードのほかに、
あと 4 つのステップ。
- 01
送信ドメインを追加する
OpenEmail でドメインを追加し、表示される DNS レコードを公開します。署名レコードが応答すると、送信が始まります。
- 02
API キーを作成する
キーは oe_live_ で始まり、付与したスコープだけを持ちます。
- 03
Webhook を移す
下に挙げたイベント用のエンドポイントを作成し、すべてのリクエストで X-OpenEmail-Signature ヘッダーを確認してください。
- 04
連絡先と抑制リストを移す
連絡先はオーディエンスのページで CSV としてインポートし、Amazon SES で抑制されていたアドレスは抑制リストに追加します。
Webhook イベントを、
新しい名前で。
Amazon SES の各イベントと、それに代わる OpenEmail のイベント。どのリクエストにも、署名付きのイベントが 1 つ入っています。
| 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 からの移行について、
お答えします。
ほかのプラットフォームから
移りますか？
どのガイドにも、同じコンバーター、フィールド対応表、チェックリストがあります。
変換できましたか？
コードが読み込むキーを作りましょう。
ワークスペースは 1 分で作れます。ドメインを追加し、API キーを作成して、OPENEMAIL_API_KEY を設定してください。