aws-ses

Amazon Simple Email Service（SES）

Amazon SES は、クラウドベースのメール送受信サービスです。トランザクションメール、マーケティングメール、通知メール向けに、API と SMTP アクセスを提供し、ニーズに合わせて拡張できるよう設計されています。

主な機能

• メール送信 — V2 API（sesv2）、SMTP インターフェース、テンプレートメールと一括送信
• メール受信 — 受信メールの処理については、Mail Manager Agent Context Pack をご覧ください（近日公開）
• ID 管理 — DKIM、SPF、DMARC、BIMI によるドメインとメールアドレスの検証
• テナント — テナントごとのレピュテーション監視と適用を備えた、ワークロードの分離
• 設定セット — イベント追跡、抑制管理、IP プールの割り当て
• メールアドレス検証 — 送信前にアドレスを検証し、バウンスを削減
• 到達性 — VDM ダッシュボード、レピュテーション監視、専用 IP 管理
• 抑制リスト — グローバル、アカウントレベル、設定セットレベルの抑制

このスキルを使用する場面

• アプリケーションにメール送信機能を組み込む
• トランザクションメール（パスワードリセット、注文確認、通知）を設定する
• マルチテナントのメールプラットフォーム（ISV/SaaS）を構築する
• 別のメールサービス（SendGrid、Postmark、Mailgun）から移行する
• メール認証（DKIM、SPF、DMARC）を設定する
• メールの到達性と送信者のレピュテーションを監視する
• 到達性を高めるためにメールアドレスを検証する

よくある間違い（クイックリファレンス）

間違い	対処法
V1 API（ses）を使用する	sesv2 を使用してください。V1 はレガシーです
ID を検証する前に送信する	まずドメインまたはメールアドレスを検証してください
サンドボックスモードを無視する	テストにはシミュレーターアドレスを使用し、本番稼働前に本番アクセスをリクエストしてください
DKIM/SPF/DMARC を省略する	Gmail と Yahoo は、認証されていない一括メールを拒否します
設定セットがない	可観測性がすべて失われます。必ず作成してください
テナントがない	初日からメールストリームを分離してください。テナントを使うと、ストリームごとのレピュテーションを監視できます
スロットリングを誤診する	TPS 制限は上限です。まずアプリ独自のレート制限を確認してください
バウンスや苦情を無視する	バウンス率が 5% 超、または苦情率が 0.1% 超になると、制限措置が適用されます
配信遅延イベントがない	Gmail は最大 14 時間にわたって配信を延期します。通知を有効にしてください
SPF の設定先ドメインが間違っている	SPF が確認するのは From ヘッダーではなく MAIL FROM です。カスタム MAIL FROM を使用してください
専用 IP を十分にウォームアップしない	2～4 週間かけてウォームアップするか、マネージド専用 IP を使用してください
無効なアドレスに送信する	まず GetEmailAddressInsights で検証してください

各間違いの詳しい説明については、AGENTS.md をご覧ください。

実行可能なスクリプト

（scripts/ 内のスクリプトはコマンドライン引数を受け取り、直接実行できます。Python と Node.js で利用できます。

スクリプト	説明	使用方法
send-email	簡単なメールを送信する	python scripts/send-email.py --from [email protected] --to [email protected]
send-templated	テンプレートを使って送信する	python scripts/send-templated.py --from [email protected] --to [email protected] --template name --data '{"key":"val"}'
send-bulk	テンプレートを使ったメールを一括送信する	python scripts/send-bulk.py --from [email protected] --template name --recipients '[{"email":"[email protected]","data":{"name":"Alice"}}]'
verify-domain	ドメインを検証し、DKIM レコードを取得する	python scripts/verify-domain.py --domain example.com
setup-config-set	設定セットとイベント送信先を作成する	python scripts/setup-config-set.py --name my-config --enable-cloudwatch
handle-bounces	バウンス／苦情の Amazon SNS 通知を設定する	python scripts/handle-bounces.py --config-set my-config --email [email protected]
setup-tenant	テナントを作成し、リソースを関連付ける	python scripts/setup-tenant.py --name my-tenant --identity-arn arn:... --config-set-arn arn:...
validate-email	メールアドレスを検証する	python scripts/validate-email.py --email [email protected]

Java の例については、references/java-examples.md をご覧ください。

このスキルで扱わないこと

• Mail Manager／受信メール — SES Mail Manager は、受信メールの処理（受信、ルーティング、アーカイブ、SMTP リレー）を担当します。従来の SES 受信ルール（V1 API）はこのスキルでは扱いません。受信メールのユースケースについては、Mail Manager Agent Context Pack（近日公開）をご覧ください。
• Global Endpoints — リージョン間のフェイルオーバー設定は高度なトピックです。
• V1 API — 意図的に対象外としています。すべてのガイダンスと例では V2 を使用します。

リソースリンク

• AGENTS.md — ワークフローのパターンとエージェント向けの手順の全容
• 開発者ガイド
• API リファレンス（V2）