共享 Resend 作品集
透過一個 Resend 帳戶和已驗證的網域,為多個產品實作郵件功能。最佳化獨立開發者或小型作品集對免費方案的使用,避免讓每個應用程式看起來都像同一個產品。
核心模型
共享基礎設施,而非產品身份:
一個 Resend 帳戶
└── 現有已驗證的寄件者網域
├── 產品 A 寄件者身份
├── 產品 B 寄件者身份
└── 產品 C 寄件者身份
每個應用程式保有它自己的:
- 寄件者顯示名稱
- 目的地收件匣
- 回覆路由
- 主題慣例
- 品牌化 HTML 和純文字範本
- 部署環境變數
- 傳遞記錄與失敗行為
所有應用程式共享帳戶層級的免費方案配額和已驗證網域的聲譽。
作品集探索
實作前:
- 檢查目標應用程式以及任何已有 Resend 設定的同系列應用程式。
- 識別標準的 Resend 帳戶和已驗證的網域。
- 確認產品顯示名稱、共享寄件者信箱、內部收件者、支援回覆信箱以及預期的郵件類型。
- 確認目標部署是否已有 Resend API 金鑰。
- 除非現有帳戶無法滿足已陳述的需求,否則不要要求使用者建立另一個帳戶、驗證另一個網域或購買方案。
帳戶與金鑰策略
重複使用同一個 Resend 帳戶和已驗證網域。當帳戶允許時,優先為每個部署的應用程式使用獨立的 API 金鑰;這能限制金鑰外洩或輪換的影響,同時維持在單一帳戶和配額下。只有在無法取得獨立金鑰或使用者明確偏好該取捨時,才重複使用同一個金鑰。
切勿將其他儲存庫中的祕密複製到原始碼管理中。直接將選擇的金鑰新增到每個部署的祕密環境變數中。
各產品配置
在實際可行時,使用僅伺服器端的變數和產品特定的名稱。從使用者現有的 Resend 帳戶、已驗證寄件者設定和預期的產品收件匣解析這些值——切勿將範例身份複製到實作中。
| 變數角色 | 用途 |
|---|---|
| Resend API 金鑰 | 驗證伺服器端提供者呼叫 |
| 產品寄件者身份 | 將當前產品的顯示名稱與現有已驗證網域上的地址組合 |
| 產品聯絡收件者 | 接收此產品的內部通知 |
| 產品回覆地址 | 當與聯絡收件者不同時,接收使用者面對訊息的回覆 |
可見的顯示名稱提供產品身份;現有的已驗證地址提供可送達性。切勿為 API 金鑰使用 NEXT_PUBLIC_ 或等效的用戶端暴露變數。
聯繫表單路由
傳送兩封獨立的訊息:
內部通知
寄件者:配置的產品寄件者身份
收件者:配置的內部產品收件匣
回覆:訪客提交的已驗證地址
訪客確認信
寄件者:配置的產品寄件者身份
收件者:訪客提交的已驗證地址
回覆:配置的內部產品收件匣
不要將訪客和內部收件匣放在同一個收件者清單中。分開的訊息可避免地址暴露,並允許不同的內容。
將內部通知視為主要傳遞。僅在 Resend 接受它並傳回訊息 ID 後,才回傳表單成功。接著嘗試發送訪客確認信;記錄其失敗,但不要宣稱主要查詢已遺失。
品牌隔離
為每個產品建立不同的範本外殼,同時保持提供者模組模式可重複使用。自訂:
- 產品名稱和描述
- 顏色、排版和標題處理
- 郵件預覽文字
- 主題和語氣
- 頁尾所有權、支援地址和回覆期望
使用表格佈局、行內 CSS、600–640px 的內容寬度、轉義的使用者值以及純文字版本。不要僅僅因為寄件基礎設施是共享的,就重複使用另一個產品的視覺識別。
共享免費方案保障措施
- 檢查目前 Resend 免費方案的限制,而非依賴記憶中的數字。
- 記住每個應用程式都消耗同一個帳戶配額。
- 僅傳送必要的交易性訊息;避免重複通知。
- 在公開表單上保持反垃圾郵件控制:驗證、長度限制、蜜罐陷阱和適當的限速。
- 避免可能產生重複信件的重試迴圈。在流程有實際重試風險時使用持久化或冪等性。
- 監控提供者拒絕和配額錯誤,但不記錄祕密或不必要的個人資料。
- 僅在測量到的流量、隔離、合規性或聲譽需求證明合理時,才升級到另一個帳戶或付費方案。
可靠實作
- 在正確的工作區安裝官方的
resend套件。 - 將提供者呼叫保留在僅伺服器端的模組中。
- 驗證
result.data?.id並確保result.error不存在。 - 捕獲 SDK 和網路例外。
- 明確設定
replyTo。 - 當郵件未配置時回傳
503,主要傳遞失敗時回傳502。 - 在使用者介面中保留直接的電子郵件、電話或訊息後援。
- 永遠不要將僅記錄的處理回報為成功傳遞。
驗證
- 確認在重複使用的 Resend 帳戶中,共享網域已驗證。
- 確認產品特定的寄件者、收件者和回覆值。
- 測試內部傳遞,接著訪客確認信,然後測試雙向回覆。
- 測試驗證、蜜罐陷阱、缺少金鑰、提供者拒絕和後援路徑。
- 執行儲存庫原生的類型檢查、Lint、測試和建置命令。
- 確認部署包含其 API 金鑰和產品變數。
- 在宣稱即時傳遞正常運作之前,先執行一次真實提交。