For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /zh-tw/docs/modules/email.md (or send Accept: text/markdown).
事務性郵件
認證與產品工作流的投遞。
閱讀您的第一條本地訊息，然後啟用傳送
事務性電子郵件是指由應用程式操作觸發的訊息，例如登入程式碼或任務結果。 Web 伺服器執行時，將 EMAIL_PROVIDER=local 保留在 apps/web/.env.local. 中 完成資料庫設定，在 /auth 請求登入程式碼，然後開啟 /mail-preview 並檢查最新訊息。此處顯示的本地訊息不是傳送到您的外部收件箱的電子郵件。
要傳送真實訊息，請選擇一個電子郵件提供商，建立其帳戶，驗證您控制的域並遵循其專用指南。將名為API的金鑰和發件人地址放入apps/web/.env.local中，儲存並重新啟動Web伺服器。請求一個新的登入程式碼，然後檢查提供商的傳送日誌和目標收件箱，包括垃圾郵件。域驗證和發件人批准可能需要時間。
如果訊息失敗，請在重複請求之前檢查傳送錯誤和發件人驗證。 /mail-preview 路由僅用於開發，在生產中返回 404。將營銷推廣活動與該交易發件人分開，以便時事通訊活動不會中斷帳戶驗證郵件。
讓事務性投遞保持獨立
郵件模組處理事務性產品訊息，包括認證與任務完成通知。營銷觸達屬於使用方產品自己的工作流，必須與這條事務性路徑保持分離。
配置投遞介面卡
確定性測試用本地介面卡。啟用外部投遞前，配置選定的生產介面卡及其服務端憑證。絕不要把郵件供應商金鑰放進客戶端配置或日誌。
獨立記錄投遞結果
生成的結果與它的完成郵件是兩個獨立結果。在聲稱訊息傳送成功之前檢查投遞記錄。測試投遞失敗時，不要把它當作生成失敗，也不要重複提交模型工作。
如果你想繼續完成設定，可以閱讀《設定 OAuth 登入》。