← 所有文章
指南

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 跑通發送,再用標準事件將所有入站訊息接返去業務系統。