使用「觸發電子郵件」擴充功能管理傳送狀態

當文件新增至珍藏內容時，擴充功能就會將其選取，以便處理電子郵件傳送作業。擴充功能會在處理電子郵件時，在文件中建立及更新 delivery 欄位。

處理電子郵件傳送作業

delivery 欄位可填入下列欄位：

  • state：PENDING、PROCESSING、SUCCESS 或 ERROR 其中之一。
  • startTime：電子郵件處理作業開始的時間戳記。
  • endTime：電子郵件處理作業完成的時間戳記 (也就是在 SUCCESS 或 ERROR 狀態下結束)。
  • error：如果發生電子郵件傳送錯誤，系統會在這裡填入錯誤訊息。
  • attempts：這封電子郵件嘗試傳送的次數。
  • leaseExpireTime：如果發生掛起或逾時情形，系統應將 PROCESSING 狀態視為錯誤的時間。
  • info：成功傳送電子郵件 (至少傳送至一個地址) 後，系統會在這個欄位填入下列欄位：
    • messageId：已送達電子郵件的郵件 ID。
    • accepted: 電子郵件成功送達的電子郵件地址陣列。
    • rejected: 無法傳送電子郵件的電子郵件地址陣列。
    • pending：SMTP 暫時拒絕的電子郵件地址陣列。
    • response：SMTP 伺服器的最後回應。

電子郵件通常會從 PENDING 傳送至 PROCESSING，再傳送至 SUCCESS 或 ERROR。一旦進入 SUCCESS 或 ERROR 狀態，文件的其他變更就不會觸發擴充功能傳送其他電子郵件。如要重新傳送含有文件更新內容的電子郵件，請將 state 變更為 PENDING 或 RETRY。

手動重試

在某些情況下，電子郵件無法正常傳送，但可以透過手動修正方式，讓文件以適當的方式傳送。雖然重試不會自動執行，但您可以手動將 delivery 欄位中的 state 變更為 RETRY，讓擴充功能再次嘗試傳送電子郵件 (並增加 attempts 的數量)。