はじめに

今回業務でSendgridを使うことになったのでやるべきこと、やったほうがよさそうなことを机上で調査しWebHookについてはAzureFunctionを作ってみて試してみました。

ドメイン認証

ドメイン認証は、SendGridがユーザーの許可を得て、ユーザーの代わりにメールを送信していることを証明するもの
具体的にはCNAMEを追加する。
ちょっとお試ししたい場合はメールアドレスでの認証もできるのでご安心を。

SPF、DKIMの設定

絶対やっとくべし。
設定に必要なDNSレコードはSendGridの管理画面で出力されるので、これをDNSに設定後SendGridの管理画面で「Verify」を押すだけ。

IPアドレスの逆引き設定

複数ドメインからメールを送信じゃなくてもやっておいても良いと思う。

IPアドレス制限

FromのIPアドレスを固定化できるかは要注意。Azureだとプランによって固定化できなかったりするので。

APIキーのパーミッションを限定的にする

APIキーをローテーションする機能はないので運用でローテーションするしかなさそう
APIキーは複数登録できる

アラートメールの設定

送信通数・・・通数で課金されるので設定しておこう
メールの統計レポート・・・これはなくてもよいかもしれない。

Email Activity

Bounces, Blocksはアラートを設定するまでではないが定期的に見た方が良いかも。
ActivityはWebhook経由でFunctionなどを経由してBlobStorageなどに保存する必要がある

FunctionでEventHookを取得するのは簡単。少し古い記事だが今も変わらず利用可能。

（追記）AzureFunctionのサンプルも用意しました。こちらを利用してください。

URLの設定画面はこんな感じ

実際に動かしてみるとBounceのログはこんな感じでとれる

[
  {
    email: 'example@test.com',
    timestamp: 1674109954,
    'smtp-id': '<14c5d75ce93.dfd.64b469@ismtpd-555>',
    event: 'bounce',
    category: [ 'cat facts' ],
    sg_event_id: 'fjO_iOXzYXsSKWWOR_HUEw==',
    sg_message_id: '14c5d75ce93.dfd.64b469.filter0001.16648.5515E0B88.0',
    reason: '500 unknown recipient',
    status: '5.0.0'
  },
  {
    email: 'example@test.com',
    timestamp: 1674109954,
    'smtp-id': '<14c5d75ce93.dfd.64b469@ismtpd-555>',
    event: 'dropped',
    category: [ 'cat facts' ],
    sg_event_id: 'dhZLeuQ_cPKJZW0q8Xa_lQ==',
    sg_message_id: '14c5d75ce93.dfd.64b469.filter0001.16648.5515E0B88.0',
    reason: 'Bounced Address',
    status: '5.0.0'
  }
]

注意点

Webhookのイベントは重複する可能性ある。sg_event_idでユニークになるので集計時は注意すること
以下の制約は大事。Functionでサーバレスプランで初回起動に時間がかかってもリトライしてくれるので大丈夫そうですね。

受けきれないと消えてしまうので絶対消えちゃダメな場合はAPIGateway→Queueで受けるとよいと思います。

SendGridは、HTTPステータスコード 2xx が返されるのを待ちます。
指定されたURLから 2xx 以外のコードが返された場合は、24時間リトライします。
リトライキューの最大数は 100,000 です。キューが一杯になった場合は、
古いリクエストから順に削除されます。リトライ期間内に送信されなかったイベントや、
キューから削除されてしまったイベントは、そのまま失われてしまいます。

サービスステータス・障害情報・メンテナンス情報の受信

下記で登録することでサービスを受けられる。登録必須。

サポート | SendGrid【日本公式サイト】