常見問題｜查詢【簡訊+ API】的發送紀錄、發送狀態，與無法送達的原因 – 漸強實驗室幫助中心

若您透過簡訊+ API 發送訊息，可透過 MAAC 後台查看各範本的發送成效與詳細紀錄。

本篇文章將說明如何查詢與理解發送紀錄。

🔍 查詢方式一：查看各範本的發送統計

🔎 備註：可使用上方藍框處的篩選器，進行訊息渠道篩選，以利查詢資料。

🔎 注意：由於簡訊+ API 支援自動 fallback 到簡訊發送，可能會出現：

API 觸發當日未立即送達

訊息實際送達日與觸發日不同

若需要進一步查看每一筆訊息的詳細發送狀況，請依下列方式操作：

1. 可選擇特定發送時間區間

2. 可搜尋特定發送聯絡人的手機號碼（前方下拉式選單可選擇國碼）

3. 依照全部及發送狀態（發送中、已發送、無法發送、發送失敗）可選擇不同的頁籤列表，下方會顯示電話號碼、發送情境、發送狀態、觸發時間、送達時間及送達渠道

4. 點擊展開圖示，可查看單一發送紀錄的詳情

發送狀態	說明
發送中	訊息正在處理中，尚未有結果
已發送	訊息已成功送達
無法發送	系統判斷渠道有異常或資訊錯誤，因此未能發送
發送失敗	因範本設定錯誤或系統異常導致發送失敗，建議聯繫漸強實驗室確認原因

preparing：指的是 MAAC 有收到發送需求，正在開始處理訊息發送。
undeliverable：漸強無法將電話號碼比對到單一聯絡人、聯絡人已封鎖 LINE 官方帳號、已達 LINE 訊息額度上限等因素而無法發送，會自動轉發 LINE 通知型訊息或簡訊。
delivered：發送成功

preparing：指的是 MAAC 有收到發送需求，正在開始處理訊息發送。
accepted：指的是 MAAC 正在等 LINE 回覆聯絡人是否有收到，多數是因為聯絡人還未完成通知型訊息驗證。流程為 accepted > 未驗證 N 小時（當初設定的轉發時間） > 自動轉發成簡訊
undeliverable：LINE 目前比對不到號碼/封鎖，會統一等 N 小時（當初設定的轉發時間）後才轉發。
delivered：發送成功

preparing：指的是 MAAC 有收到發送需求，正在開始處理訊息發送。
accepted：MAAC 正在等待電信方回復聯絡人是否收到訊息，若有訊息在此階段發送失敗，會自動retry，依照電信商有不同的預設retry時間。
undeliverable：因電信商或接收端訊號異常、手機號碼格式不符、停用或空號或簡訊中有「被視作敏感字詞」的內文而無法送達簡訊。
- 詳細簡訊發送失敗原因可參考：常見問題｜簡訊發送失敗原因說明
delivered：發送成功
根據不同電信商會有不同預設的 retry 時間：
中華電信：24小時
遠傳電信：24小時
亞太電信：24小時
台灣大哥大：8小時
在上述期間內電信商會持續重試，不過重試的頻率平台並無多加說明。Retry 中間的結果並不會提供給漸強，只會提供最終結果。

preparing：指的是 MAAC 有收到發送需求，正在開始處理訊息發送。
undeliverable：因 API 呼叫參數不符合 WhatsApp 訊息範本、WhatsApp 訊息額度不足、WhatsApp 商業帳號權限異常、WhatsApp 授權異常等情況。
delivered：發送成功

單則發送後，可使用此 Open API 來查詢通知型訊息的最新狀態（例如：發送中 - pnp_preparing、已送達 - pnp_delivered...）。您可根據需求，取得特定時間區間內有狀態更動的發送紀錄。