SKILL.md
readonlyread-only
name
email-best-practices
description
在建立電子郵件功能、郵件進入垃圾郵件、高退信率、設定 SPF/DKIM/DMARC 驗證、實作電子郵件擷取、確保法規遵循(CAN-SPAM、GDPR、CASL)、處理 Webhook、重試邏輯、讓郵件具備無障礙性(替代文字、標題、對比度、螢幕閱讀器),或決定交易型與行銷型郵件時使用。
電子郵件最佳實務
建立可送達、合規且友善使用者的電子郵件指南。
架構概覽
[使用者] → [電子郵件表單] → [驗證] → [雙重選擇加入]
↓
[記錄同意]
↓
[抑制檢查] ←──────────────[準備發送]
↓
[冪等發送 + 重試] ──────→ [電子郵件 API]
↓
[Webhook 事件]
↓
┌────────┬────────┬─────────────┐
↓ ↓ ↓ ↓
已送達 退信 投訴 開啟/點擊
↓ ↓
[更新抑制清單]
↓
[清單清理任務]
快速參考
| 需求... | 請參閱 |
|---|---|
| 設定 SPF/DKIM/DMARC,解決垃圾郵件問題 | 送達率 |
| 建立密碼重設、OTP、確認信 | 交易型郵件 |
| 規劃應用程式需要的郵件類型 | 交易型郵件目錄 |
| 建立電子報註冊、驗證電子郵件 | 電子郵件擷取 |
| 發送電子報、促銷郵件 | 行銷型郵件 |
| 確保 CAN-SPAM/GDPR/CASL 合規 | 法規遵循 |
| 區分交易型與行銷型郵件 | 郵件類型 |
| 處理重試、冪等性、錯誤 | 發送可靠性 |
| 處理送達事件、設定 Webhook | Webhook 與事件 |
| 管理退信、投訴、抑制 | 清單管理 |
| 讓郵件具備無障礙性(螢幕閱讀器、替代文字、對比度) | 無障礙性 |
從這裡開始
新應用程式?
先從目錄開始,規劃應用程式需要的郵件類型(密碼重設、驗證等),然後在發送第一封郵件前設定送達率(DNS 驗證)。
有垃圾郵件問題?
先檢查送達率——驗證問題是最常見的原因。Gmail/Yahoo 會拒絕未驗證的郵件。
行銷型郵件?
依循此路徑:電子郵件擷取(收集同意)→ 法規遵循(法律要求)→ 行銷型郵件(最佳實務)。
準備上線發送?
加入可靠性:發送可靠性(重試 + 冪等性)→ Webhook 與事件(追蹤送達)→ 清單管理(處理退信)。
無障礙性?
大多數郵件未通過基本的無障礙檢查。請參閱無障礙性了解 lang/dir、呈現性表格、標題、替代文字、<title> 和對比度。






