佇列管理

監控發送狀態、排解錯誤並管理您的郵件佇列。

佇列管理 可讓您監控 PDF 生成和郵件發送工作的進度。它提供每個作業的詳細檢視，從整體設定檔狀態到個別郵件項目。

概覽

佇列管理系統分為四個層級，幫助您深入分析問題：

  1. 設定檔清單：所有設定檔及其近期活動的概覽。
  2. 批次清單：特定設定檔的匯入（檔案）歷史記錄。
  3. 佇列清單：批次中的個別項目（收件人）。
  4. 項目詳細資訊：單一項目的詳細資料和狀態。

1. 設定檔清單（概覽）

主檢視會為每個已設定的 設定檔 顯示一張卡片。

  • 統計：每張卡片會視覺化顯示過去 30 天的項目狀態。
    • 錯誤：失敗的項目（PDF 生成、發送或匯入）。
    • 待處理：等待處理的項目（PDF 生成）。
    • 已生成 PDF：PDF 已生成，等待發送的項目。

操作： 點擊設定檔卡片（或 編輯 圖示）以檢視其 批次清單。

2. 批次清單（歷史記錄）

此清單顯示您為所選設定檔匯入的每個檔案。

  • 批次名稱：對應匯入 CSV 的 檔案名稱。
  • 匯入日期：用於區分同一檔案的多次匯入。
  • 狀態欄位：
    • 總計：批次中的項目總數。
    • 錯誤：失敗總數。
    • 待處理：等待 PDF 生成。
    • 已生成 PDF：PDF 已生成，等待發送郵件。
    • 已發送：成功發送。

操作： 點擊特定批次列上的 編輯 圖示以檢視其 佇列清單。

3. 佇列清單（項目）

此檢視列出所選批次中的每位個別收件人。

功能

  • 搜尋：您可以依收件人（To）、狀態、錯誤訊息或資料內容（JSON）進行搜尋。
  • 篩選：使用下拉選單僅顯示特定狀態（例如僅「錯誤」）。
  • 刪除批次：刪除批次 按鈕允許您移除整個批次歷史記錄。

狀態定義

狀態內部值說明
待處理pending等待系統生成 PDF。
已生成 PDFpdf_generatedPDF 已成功建立。等待發送。
已發送sent郵件已成功傳遞到 SMTP 伺服器。
錯誤（匯入）error_import此項目的資料匯入失敗。
錯誤（PDF）error_pdfPDF 生成失敗。
錯誤（郵件）error_email郵件發送失敗（可重試）。
錯誤（郵件 - 致命）error_email_fatal郵件發送永久失敗（例如無效地址）。

常見錯誤訊息

以下錯誤可能出現在 錯誤訊息 欄位或批次的 錯誤清單 中：

郵件發送錯誤

  • MISSING_TO_RECIPIENT：「收件人」地址為空。請檢查您的對應設定。
  • INVALID_EMAIL_FORMAT：電子郵件地址格式無效。
  • BACKEND_CONNECTION_FAILED：無法連線到 SMTP 伺服器。請檢查您的網際網路連線或 VPN。
  • SMTP_AUTH_ERROR：SMTP 驗證失敗。請檢查您的使用者名稱和密碼。
  • RETRY_LIMIT_REACHED_SKIP：系統在達到最大重試次數後放棄，並略過此項目。
  • RETRY_LIMIT_REACHED_ABORT：系統在達到最大重試次數後放棄，並中止整個批次。

匯入與處理錯誤

  • TEMPLATE_FILE_NOT_FOUND：工作區中找不到已設定的 PDF 範本檔案。
  • MISSING_MASTER_LOOKUP_VALUE：此項目沒有查詢鍵的值（例如客戶 ID 為空），因此無法擷取主資料。
  • CSV_DATA_EMPTY_OR_UNREADABLE：匯入的 CSV 檔案為空或已損毀。

4. 項目詳細資訊（編輯與重試）

點擊項目上的 編輯 圖示可讓您修改其資料或重試失敗的處理。

修改資料

您可以修正匯入錯誤的電子郵件地址（To、CC、BCC）。

修改狀態（重試）

儲存時狀態不會自動變更。您必須手動選擇適當的狀態以觸發重試：

  • 待處理：選擇此狀態以捨棄目前的 PDF 並嘗試重新生成（例如修正 JSON 資料後）。
  • 已生成 PDF：選擇此狀態以重試發送 現有的 PDF（例如修正電子郵件地址後）。

編輯 JSON

您可以直接編輯 文件內容資料 和 客戶主資料。