# 切り替えと配信ログを備えるメール機能を構築

メール送信をプラットフォームの共通機能として構築。3つのプロバイダーによるフェイルオーバー、配信Webhook、送信・配信ログ、テンプレート、キャンペーンを備え、送信手段がなければ起動を拒否する検査を設けた。

2025

**状況.** メールは、認証、通知、定期まとめ、キャンペーンなど、利用者が実際に待つ重要な役割を担っていた。プロバイダーは静かに失敗し得る依存先であり、設定が正しく見え、起動しても、約束した通知が届かなかった人によって初めて故障がわかる。それは最悪の発見方法だった。1社だけなら全面停止となり、修正も相手任せになる。

**課題.** メールを呼び出すライブラリではなく、プラットフォームが責任を持つ機能として扱い、供給元の障害に耐え、個々の通知の経緯を説明し、沈黙が危険な環境では起動時に明確に失敗させる必要があった。

**行動.** SendGridを主に、SMTP2GOとAzure Communication Servicesを控えとして、3社を共通インターフェースの背後に置き、緊急時の設定変更ではなく自動で切り替えた。到達を想定で済ませず、受信Webhookで処理結果を報告させ、送信ログと配信イベントテーブルの両方に記録した。認証メールが届いたかは推測でなく問い合わせで確認する。本文はテンプレートに分離し、トランザクションメールとは別の問題である一斉配信は、5テーブル・24関数の専用スキーマで利用者層ごとのキャンペーンを扱った。フラグ付きの起動検査は実際に1通送信する。開発では期限切れの実験用鍵で端末を起動不能にしないよう警告で続行し、ステージング・本番では送信不能の版を導入しないよう、失敗を致命的として終了する。送信はSSRF対策と30秒制限付きクライアントを通し、非同期配信は再試行とバックオフで一時的な失敗による欠落を防いだ。

**結果.** 静かな失敗の一群が「数日後に利用者が発見する」から「デプロイが止まる」へ移り、供給元の一時的な不調は全面停止でなく縮退した経路になった。1社ではなく3社の連携維持と、増える配信ログの削除が必要になったが、代わりのない連絡経路であるため受け入れた。

---

- 役割: バックエンドエンジニア
- カテゴリー: [バックエンド開発](https://platform.engineer.company/ja/categories/backend/), [API・システム連携](https://platform.engineer.company/ja/categories/api/), [クラウド](https://platform.engineer.company/ja/categories/cloud/), [信頼性・バックアップ](https://platform.engineer.company/ja/categories/reliability/), [セキュリティ](https://platform.engineer.company/ja/categories/security/)
- サービス: [バックエンド・API開発](https://platform.engineer.company/ja/services/backend-development/), [サイト信頼性・監視](https://platform.engineer.company/ja/services/site-reliability/), [セキュリティ・アクセス管理](https://platform.engineer.company/ja/services/security-access/)

<https://engineer.company/ja/portfolio/built-email-with-failover-and-delivery-logging/>
