← Tất cả bài viết
Cẩm nang

LINE push trả về 200 nhưng không nhận được tin? Kiểm tra người nhận

Yêu cầu push của LINE Messaging API có thể trả về HTTP 200 dù người dùng không nhận được tin nhắn. LINE nêu rõ các trường hợp tài khoản đã bị xóa, người dùng chặn Official Account gửi tin và người chưa thêm bạn nhưng không thuộc ngoại lệ. Trước khi gửi lại, hãy xác minh channel thực tế, ID người nhận và quan hệ của họ với Official Account đó. HTTP thành công không chứng minh tin đã đến, cũng không chứng minh người dùng đã chặn bạn.

Những điểm chính

  • Kiểm tra yêu cầu push gửi ra, không nhầm với phản hồi 200 của máy chủ webhook.
  • Người chưa thêm bạn nhưng đã nhắn cho Official Account trong cuộc trò chuyện một-một có thể nhận push trong vòng bảy ngày sau tin nhắn đó.
  • Ngoại lệ này không phải cửa sổ gửi chung cho khách truy cập website, thành viên nhóm hay mọi người đã đăng nhập.
  • Dừng gửi lại tự động khi đã biết yêu cầu thành công; kiểm tra điều kiện và giữ trạng thái giao tin chưa xác nhận.

Vì sao LINE push thành công nhưng tin không đến

Tài liệu LINE Messaging API liệt kê các điều kiện gửi push sau:

Đích đếnĐiều kiện được tài liệu hóa
Người dùng cá nhânĐã thêm LINE Official Account gửi tin làm bạn
Nhóm hoặc cuộc trò chuyện nhiều ngườiOfficial Account đã tham gia cuộc trò chuyện đó
Cá nhân chưa thêm bạnĐã nhắn cho Official Account đó trong trò chuyện một-một trong bảy ngày vừa qua

Cùng tài liệu này cảnh báo rằng yêu cầu có thể trả 200 mà không giao tin nếu người dùng đã xóa tài khoản LINE, chặn Official Account gửi tin hoặc chưa thêm bạn và không thuộc ngoại lệ.

Đây là các nguyên nhân có thể xảy ra, không phải kết luận được mã hóa trong phản hồi thành công. Đừng gắn nhãn “khách hàng đã chặn chúng ta” trong CRM chỉ vì họ báo không thấy tin. Cũng cần phân biệt loại đích đến: tương tác trong nhóm không chứng minh đã có tin nhắn một-một đủ điều kiện.

Với tác vụ hỗ trợ xử lý chậm, nên lưu riêng thời điểm tin nhắn đến liên quan, thời điểm tạo tác vụ và thời điểm gửi thực tế. Kiểm tra lại điều kiện dành cho người chưa thêm bạn khi lấy tác vụ ra gửi. Khởi động tác vụ AI trong khoảng bảy ngày không giữ chỗ cho quyền gửi về sau.

Lần theo một lần gửi từ channel đến người nhận

Những mục dưới đây là bản ghi chẩn đoán được đề xuất cho ứng dụng, không phải các trường mới của LINE API.

1. Tìm đúng phản hồi cần kiểm tra

Xác nhận 200 đến từ yêu cầu push gửi ra. Webhook của bạn trả thành công chỉ xác nhận máy chủ đã nhận yêu cầu. API hàng đợi tự xây dựng trả thành công cũng có thể chỉ có nghĩa tác vụ đã được lưu.

Giữ lại phương thức, endpoint, thời gian, mã HTTP và x-line-request-id. Hướng dẫn phát triển của LINE khuyến nghị lưu các bằng chứng yêu cầu này. Không ghi access token hoặc sao chép nội dung tin nhắn khách hàng vào log thông thường.

2. Kiểm tra đồng thời bên gửi và đích đến

Xem worker đang chạy đã chọn channel access token nào, channel đó đại diện Official Account nào và ID đích đến được lấy từ đâu. Tài khoản thử nghiệm và tài khoản vận hành có thể có tên giống nhau. Ảnh chụp cấu hình dự kiến không chứng minh worker thực sự dùng cấu hình đó.

Hướng dẫn user ID của LINE phân biệt API user ID với tên hiển thị và LINE ID dùng tìm bạn, đồng thời xác định phạm vi user ID theo provider. Nếu đích đến lấy từ LINE Login hoặc một tích hợp khác, hãy dùng checklist sai lệch provider để xác minh ánh xạ. Đăng nhập website không tự chứng minh người dùng đã kết bạn với Official Account gửi tin.

3. Xác định quan hệ với đúng Official Account

Đối với cá nhân, kiểm tra bằng chứng kết bạn hiện có hoặc tin nhắn một-một gần đây đủ điều kiện gửi đến chính Official Account này. Hoạt động cũ trong CRM, lượt xem trang hay tin nhắn gửi cho tài khoản khác không phải bằng chứng tương đương.

Nếu chưa đủ dữ liệu, hãy giữ trạng thái chưa biết. Không liên tục gửi tin thăm dò để suy đoán người đó có chặn tài khoản hay không. Hướng dẫn LINE cấm gửi hàng loạt tin cho cùng một người dùng; việc chẩn đoán không nên trở thành liên hệ ngoài mong muốn.

4. Tách yêu cầu đã được chấp nhận, bị từ chối và chưa rõ kết quả

Quan sátBước tiếp theo
Push trả 200, người nhận báo không thấy tinKiểm tra danh tính và điều kiện; không tự gửi lại
API có phản hồi không thành côngĐiều tra phản hồi đó, không áp dụng máy móc trường hợp 200
Yêu cầu hết thời gian chờ, không có phản hồiGiữ kết quả chấp nhận ở trạng thái chưa biết và dùng quy trình retry riêng
Chỉ webhook trả 200Xác minh có yêu cầu gửi ra thực sự hay chưa

Với timeout, xem hướng dẫn LINE retry key. Bảo vệ khi retry xử lý sự không chắc chắn về việc yêu cầu đã được chấp nhận hay chưa. Nó không thay đổi điều kiện của người nhận hoặc khiến một yêu cầu thành công nhưng không thể giao tin trở nên giao được.

Thử nghiệm có kiểm soát, không lặp gửi lại

Với sự đồng ý của người thử nghiệm, xác minh đúng Official Account trong ứng dụng LINE và quan hệ bạn bè mong muốn. Gửi một tin thử dễ nhận ra qua cùng channel đang triển khai. So sánh bản ghi HTTP với nội dung người thử thực sự thấy trong cuộc trò chuyện, không chỉ với biểu ngữ thông báo.

Nếu thành công, bạn chỉ xác nhận đường gửi hoạt động cho người thử đó tại thời điểm đó. Kết quả không chứng minh quan hệ của khách hàng khác, không giải thích toàn bộ tin cũ bị thiếu và không cho phép gửi lại các tác vụ cũ một cách mặc định.

Có thể kiểm thử logic tác vụ chậm tại môi trường cục bộ: tin nhắn của người chưa thêm bạn vượt điều kiện bảy ngày trước lúc gửi; đích đến đã lưu thuộc sai tích hợp; tác vụ đã được chấp nhận được worker retry lấy lại. Kết quả mong đợi lần lượt là giữ tác vụ, kiểm tra danh tính và không gửi trùng. Đây là đề xuất kiểm thử, không phải kết quả vận hành đã ghi nhận.

Giữ bằng chứng UnifyPort ở đường tích hợp riêng

Giao diện không chính thức của UnifyPort cung cấp đường kết nối tài khoản nhắn tin riêng. Hợp đồng gửi văn bản dùng account_id, to và message, với status: accepted trong ví dụ phản hồi thành công. Đó không phải xác nhận giao tin và không khôi phục push trước đó từ Official Account.

Ma trận sự kiện theo nền tảng có ánh xạ sự kiện đã giao và đã đọc của LINE, nhưng không bảo đảm mọi tài khoản hoặc môi trường đều phát sinh tất cả sự kiện đã ánh xạ. Chỉ áp dụng xác nhận nhận được cho đúng các tin nhắn nó chỉ ra. Thiếu xác nhận không chứng minh lỗi hay bị chặn. Không ghép xác nhận từ một tài khoản khác với official push chỉ vì tên hiển thị trùng nhau.

Nếu danh tính gửi phải là LINE Official Account, hãy tiếp tục dùng Messaging API chính thức. Đổi người gửi không phải thao tác khôi phục tự động và không thay đổi lựa chọn của người nhận.

Câu hỏi thường gặp

HTTP 200 có chứng minh khách hàng chặn Official Account không?

Không. Nó không chứng minh giao tin hoặc chỉ ra nguyên nhân không giao được. LINE ghi nhận nhiều điều kiện có thể xảy ra.

Có thể push cho người chưa thêm bạn không?

LINE có ngoại lệ cho người đã nhắn một-một với Official Account đó trong bảy ngày vừa qua. Không mở rộng ngoại lệ này sang truy cập website hay tương tác nhóm.

Nên gửi lại nếu tin chưa xuất hiện không?

Không tự động gửi lại sau khi đã biết yêu cầu được chấp nhận thành công. Trước hết hãy kiểm tra người gửi, người nhận, điều kiện và bằng chứng. Timeout là trường hợp khác với phản hồi 200 đã nhận được.

Bước tiếp theo và nguồn

Chọn một push gặp vấn đề và đối chiếu với điều kiện push chính thức. Nếu đang dùng UnifyPort, hãy đọc hợp đồng gửi riêng trước khi gắn nhãn trạng thái giao tin.

Nguồn chính thức được kiểm tra ngày 2026-11-18:

UnifyPort API

Biến tích hợp nhắn tin thành một pipeline sản phẩm ổn định.

Bắt đầu bằng cách gửi qua một API, rồi đưa mọi tin nhắn inbound trở lại hệ thống kinh doanh bằng sự kiện chuẩn.