メールサービス統合

目次

• 概要
• 使用時期
• クイックスタート
• リファレンスガイド
• ベストプラクティス

概要

SMTP統合、サードパーティメールプロバイダー(SendGrid、Mailgun、AWS SES)、HTMLテンプレート、メール検証、リトライメカニズム、適切なエラーハンドリングを備えた包括的なメールシステムを構築します。

使用時期

• トランザクションメールの送信
• ウェルカム/確認メールの実装
• パスワードリセットフローの作成
• 通知メールの送信
• メールテンプレートの構築
• バルクメールキャンペーンの管理

クイックスタート

最小限の動作例：

# config.py
import os

class EmailConfig:
    MAIL_SERVER = os.getenv('MAIL_SERVER', 'smtp.gmail.com')
    MAIL_PORT = int(os.getenv('MAIL_PORT', 587))
    MAIL_USE_TLS = os.getenv('MAIL_USE_TLS', True)
    MAIL_USERNAME = os.getenv('MAIL_USERNAME')
    MAIL_PASSWORD = os.getenv('MAIL_PASSWORD')
    MAIL_DEFAULT_SENDER = os.getenv('MAIL_DEFAULT_SENDER', 'noreply@example.com')

# email_service.py
from flask_mail import Mail, Message
from flask import render_template_string
import logging
from datetime import datetime
import smtplib
from email.mime.text import MIMEText
from email.mime.multipart import MIMEMultipart

logger = logging.getLogger(__name__)
mail = Mail()

class EmailService:
    def __init__(self, app=None):
// ... (詳細な実装についてはリファレンスガイドを参照してください)

リファレンスガイド

references/ ディレクトリの詳細な実装：

ガイド	内容
Python/Flask with SMTP	Python/Flask with SMTP
Node.js with SendGrid	Node.js with SendGrid
Email Templates with Mjml	Email Templates with Mjml
FastAPI Email with Background Tasks	FastAPI Email with Background Tasks
Email Validation and Verification	Email Validation and Verification

ベストプラクティス

✅ すべきこと

• 信頼性のためにトランザクションメールプロバイダーを使用する
• 一貫性のためにメールテンプレートを実装する
• 購読解除リンクを追加する(法律で必須)
• メール送信に背景タスクを使用する
• 適切なエラーハンドリングと再試行を実装する
• 送信前にメールアドレスを検証する
• 悪用を防ぐためレート制限を追加する
• メール配信とバウンスを監視する
• SMTP認証を使用する
• 開発環境でメールをテストする

❌ してはいけないこと

• リクエストハンドラーで同期的にメールを送信する
• パスワードをコードに保存する
• メールで機密情報を送信する
• 機密操作に汎用メールアドレスを使用する
• メール検証をスキップする
• バウンスおよび苦情通知を無視する
• インラインスタイルを多用したHTMLメールを使用する
• 失敗したメール配信のハンドリングを忘れる
• 適切なテンプレートなしでメールを送信する
• 同意なしでメールアドレスを保存する