概要
SES => SNS => lambda => slackという構成で
メールのバウンス検知だけでなく、メール開封やリンククリックも検知しよう！というお話。
バウンス検知だけの場合とは異なる設定方法を使います。
ちなみにこの設定方法だと、送信メールに特定のヘッダを埋め込むだけで
SES利用の送信メールは全て検知することができます。
SESでEメールを送信する際にヘッダを付加する
こちらに関してはお使いの言語によって他サイトを参照してください。
Laravelでmailableクラスを使っている場合は、build時にwithSwiftMessageで
自由にヘッダを設定できます。
つけるヘッダは
X-SES-CONFIGURATION-SET: {{ #SESで設定するconfig名 }}
public function build()
{
return $this->view('mail.html.mail')
->text('mail.plain.mail')
->subject($this->subject)
->from($this->from)
->withSwiftMessage(function (\Swift_Message $message) {
$message->getHeaders()->addTextHeader('X-SES-CONFIGURATION-SET', 'test-set-01');
});
}
SESでconfigを設定しSNSと連携する
Create Configuration Setをクリック。
Configuration Setの名前を入力。
Configuration Setが作成されるので、作成したconfigのリンクをクリック。
Configuration Setの編集画面がこちら。
ここで開封やクリックのイベントの出力先を選択する。今回はSNSを選択。
するとこちらのような入力項目になる。
通知したいEvent typesを選択して、連携したいSNS topicを作成するか、
作成済みのSNSを選択するとSES→SNSの連携は完了。
各Event typeの説明はこちら。
Event type(AWS公式より)
- Send(送信)
- Amazon SESに対する呼び出しが成功しました。Amazon SESはメールの配信を試行します。
- Reject(拒否)
- Amazon SESはEメールを受け付け、ウイルスが含まれていることを検出した後で拒否しました。Amazon SES は、受取人のメールサーバーにメールの配信を試みませんでした。
- Delivery(配信)
- Amazon SESが受取人のメールサーバーに Eメールを正常に送信しました。
- Bounce(バウンス)
- 受取人のメールサーバーにより、メールは完全に拒否されました。このイベントはハードバウンスに該当します。ソフトバウンスは、Amazon SESが一定期間にわたって再試行してもメールを配信できなかった場合に限ります。
- Complaint(苦情)
- Eメールは受取人に正常に配信されました。受取人がメールをスパムとしてマークしました。
- Open(オープン)
- 受取人がメッセージを受け取り、Eメールクライアントで開きました。
- Click(クリック)
- 受取人はメール内の1つ以上のリンクをクリックしました。
- Rendering failure(レンダリング失敗)
- テンプレートレンダリングの問題のためにEメールが送信されませんでした。このイベントタイプは、SendTemplatedEmail または SendBulkTemplatedEmail API オペレーションを使用してテンプレートメールを送信する場合にのみ発生します。このイベントタイプは、テンプレートデータが見つからない場合や、テンプレートのパラメーターとデータが一致しない場合に発生します。
#SNSでTOPICを作成
次にSNSでSESから通知を受けられるように設定します。
トピックを作成。
名前さえ決めれば他はデフォルト値で問題ありません。
サブスクリプションではHTTPSでpostしたり、Eメールでの通知も設定できますが、ここでは設定しません。
lambdaから設定した方が簡単なので。
テストしたい場合はとりあえずEメールで通知してみると良いかも。
#lambdaからSlackに通知
https://qiita.com/icck/items/75f484cd3ccd944cd4c2
こちらを参照のこと。コードはNode.js 10.xでも問題なく動作しました。
let arr = JSON.parse(rec.Sns.Message);
した時のarr.eventTypeに各event Typeが入ってくるので、
それによって投稿されるメッセージを変えてあげると分かりやすいです。
SESで検知できない点
実装して色々テストしてみたのですが、下記の状態取得では一部正確では無い点がありました。
- 携帯のpush通知で開封扱いになる(iOS13で確認)
- gメール, yahooメールで迷惑メール判定されてもComplaintが返ってこない
開封通知については、メール文面に含まれる小さくて透明な画像が表示されたかどうかで判定しているそうです。
AWSのサポートにも問い合わせましたが、メーラーの仕様によるため、これを回避する方法は現状無いそうです。