email-service-integration

メールサービスの統合

目次

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

概要

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', '[email protected]')

# 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):
// ... (see reference guides for full implementation)

リファレンスガイド

references/ ディレクトリにある詳細な実装：

ガイド	内容
Python/Flask と SMTP	Python/Flask と SMTP
Node.js と SendGrid	Node.js と SendGrid
Mjml を使用したメールテンプレート	Mjml を使用したメールテンプレート
バックグラウンドタスクを使用した FastAPI メール	バックグラウンドタスクを使用した FastAPI メール
メールアドレスの検証と確認	メールアドレスの検証と確認

ベストプラクティス

✅ 推奨事項

• 信頼性を高めるため、トランザクションメールプロバイダーを使用します
• 一貫性を保つため、メールテンプレートを実装します
• 配信停止リンクを追加します（法律で義務付けられています）
• メール送信にはバックグラウンドタスクを使用します
• 適切なエラー処理と再試行を実装します
• 送信前にメールアドレスを検証します
• 不正利用を防ぐため、レート制限を追加します
• メールの配信状況とバウンスを監視します
• SMTP 認証を使用します
• 開発環境でメールをテストします

❌ 禁止事項

• リクエストハンドラーでメールを同期的に送信しないでください
• パスワードをコードに保存しないでください
• メールで機密情報を送信しないでください
• 機密性の高い操作に汎用のメールアドレスを使用しないでください
• メールアドレスの検証を省略しないでください
• バウンス通知や苦情通知を無視しないでください
• HTML メールでインラインスタイルを過剰に使用しないでください
• メールの配信失敗への対応を忘れないでください
• 適切なテンプレートなしでメールを送信しないでください
• 同意なしにメールアドレスを保存しないでください