← 所有文章
指南

LINE push 回傳 200 卻收不到訊息?先確認接收條件

LINE Messaging API 的 push 請求即使回傳 HTTP 200,使用者也可能收不到訊息。LINE 明確列出帳號已刪除、使用者封鎖發送方官方帳號,以及不符合例外條件的非好友等情況。再次傳送前,先核對實際使用的 channel、接收者 ID,以及使用者與該官方帳號的關係。HTTP 成功不能證明送達,也不能證明對方封鎖了你。

重點整理

  • 檢查實際的出站 push 請求,不要把 webhook 接收端的 200 當成傳送結果。
  • 非好友在一對一聊天室傳訊息給該官方帳號後,可在七天內接收其 push 訊息。
  • 這不是適用於網站訪客、群組成員或所有登入使用者的通用傳送期限。
  • 已確認成功的請求不要自動重送;先核對接收條件,保留尚未確認的送達狀態。

為什麼 LINE push 成功卻沒收到

LINE Messaging API reference 列出以下 push 傳送條件:

目標官方記載的條件
個別使用者已將發送方 LINE 官方帳號加為好友
群組或多人聊天室官方帳號已加入該聊天室
非好友使用者過去七天內曾在一對一聊天室傳訊息給該官方帳號

同一份文件說明:使用者刪除 LINE 帳號、封鎖發送方官方帳號,或未加好友且不符合例外時,請求可以回傳 200,但訊息不會送達。

這些是可能原因,不是成功回應已確認的診斷。不要只因使用者說「沒收到」,就在 CRM 標示「客戶已封鎖」。目標類型也要分清楚:群組互動不能證明使用者曾傳送符合條件的一對一訊息。

對於延後處理的客服工作,建議分別記錄相關收到訊息的時間、工作建立時間與實際傳送時間,並在工作出列時重新檢查非好友條件。啟動 AI 工作時還在七天內,不代表已保留日後傳送資格。

沿著一次傳送核對證據

以下是建議的應用程式診斷紀錄,不是新增的 LINE API 欄位。

1. 找出真正相關的回應

確認 200 來自出站 push 請求。Webhook 回應成功只表示接收端確認了請求;自建佇列 API 成功也可能只表示工作已儲存。

保留請求方法、endpoint、時間、HTTP 狀態與 x-line-request-id。LINE 開發規範 建議記錄這些證據。不要記錄 access token,也不要把客戶訊息內容複製到一般日誌。

2. 同時核對發送方與接收者

確認已部署的 worker 實際使用哪個 channel access token、該 channel 對應哪個官方帳號,以及目標 ID 的來源。測試與正式帳號可能名稱相近;設定畫面截圖不能取代實際執行紀錄。

LINE 使用者 ID 文件 區分 API user ID、顯示名稱與供好友搜尋的 LINE ID,並說明 user ID 依 provider 區分。如果目標來自 LINE Login 或其他整合,先按使用者 ID 與 provider 不一致檢查指南核對對應關係。登入網站本身不代表已將發送方官方帳號加入好友。

3. 確認與這個官方帳號的關係

對個別使用者,檢查可用的好友關係證據,或最近是否向這個官方帳號傳送過符合條件的一對一訊息。CRM 舊活動、網頁瀏覽,以及傳給其他帳號的訊息,都不是等價證據。

資料不足就維持「未知」。不要反覆傳送測試訊息來推測對方是否封鎖帳號。LINE 開發規範禁止向同一使用者大量傳訊,診斷不應變成不必要的聯繫。

4. 區分已接受、已拒絕與結果未知

觀察下一步
push 回傳 200,使用者表示沒收到核對身分與接收條件,不自動重送
API 有非成功回應依實際回應調查,不套用本篇的 200 情境
請求逾時,沒有回應保留接受狀態未知,進入獨立重試流程
只有 webhook 回傳 200查明是否真的送出出站請求

逾時處理請看 LINE retry key 指南。重試保護處理的是請求是否已被接受的不確定性,不會改變接收條件,也無法讓原本不可送達的成功請求變得可送達。

進行受控驗證,不要循環重送

取得測試使用者同意後,在 LINE 應用程式中確認正確的官方帳號與預期好友關係,再透過同一個已部署 channel 傳送一則容易辨認的測試訊息。將 HTTP 紀錄與測試者在聊天室實際看到的內容比對,不要只看通知橫幅。

成功只證明該使用者在當時的路徑可用,不能證明其他客戶的關係,也不能解釋所有過去缺失,更不是重送舊工作的依據。

延後工作邏輯可使用本機測試:非好友的相關訊息在實際傳送前已超過七天;儲存的目標來自錯誤整合;已接受的操作再次進入重試 worker。預期分別是暫停工作、進入身分檢查,以及不重複傳送。這些是建議測試情境,不是已取得的正式環境結果。

UnifyPort 的證據要獨立處理

UnifyPort 非官方介面提供獨立的訊息帳號連線路徑。文字訊息傳送契約使用 account_id、to 與 message,成功範例回傳 status: accepted。這不是送達回條,也不能恢復先前由官方帳號發出的 push。

平台事件矩陣列出 LINE 送達與已讀事件的映射,但不保證每個帳號或部署都會產生所有已映射事件。收到回條時,只更新其指向的訊息;缺少回條不能證明失敗或遭到封鎖。也不要只因顯示名稱相同,就把另一帳號的回條關聯到官方 push。

如果發送身分必須維持 LINE 官方帳號,請繼續使用官方 Messaging API。更換發送身分不是自動復原動作,也不會取消接收者的選擇。

常見問題

HTTP 200 能證明客戶封鎖官方帳號嗎?

不能。它不證明送達,也不指出未送達的原因。LINE 文件列出了多種可能條件。

可以向未加好友的使用者傳送 push 嗎?

官方例外適用於過去七天內向該官方帳號傳送過一對一訊息的使用者,不能擴大為網站瀏覽或群組互動。

使用者沒看到訊息,應該再傳一次嗎?

已確認請求成功後不要自動重送。先核對發送方、接收者、接收條件與證據。請求逾時和已取得 200 是不同問題。

下一步與參考資料

選擇一筆有問題的 push,對照官方 push 條件檢查。若已使用 UnifyPort,請先閱讀獨立的傳送契約,再設計送達狀態標籤。

官方來源核對日期:2026-11-18。

UnifyPort API

讓訊息接入變成一條穩定的產品管線。

先用統一 API 跑通傳送,再用標準事件把所有入站訊息接回業務系統。