LINE Service Message và Messaging API: MINI App nên chọn cách nào?
LINE service message và tin nhắn Messaging API phục vụ hai mục đích khác nhau. Hãy dùng service message khi LINE MINI App đã xác minh cần xác nhận hoặc theo dõi một thao tác hoàn tất trong app, như đặt chỗ hoặc giao hàng. Hãy dùng Messaging API khi LINE Official Account cần trả lời hội thoại, gửi push linh hoạt hoặc gửi cho nhiều người. Cách này không phải phiên bản mạnh hơn của cách kia.
Điểm chính
- Service message là thông báo giao dịch gắn với thao tác trong MINI App; quảng cáo, coupon, sản phẩm mới và thông báo sự kiện không liên quan đều bị cấm.
- Messaging API thuộc LINE Official Account, hỗ trợ reply, push, multicast, narrowcast và broadcast.
- Service message trong production cần MINI App đã xác minh, template đã duyệt và service notification token gắn với người dùng.
- Service message xuất hiện trong phòng thông báo MINI App theo từng khu vực và có thể đến người chưa thêm Official Account liên quan làm bạn.
- Nếu cần cả cập nhật giao dịch lẫn hỗ trợ tự do, hãy tách hai luồng và liên kết bằng ID đặt chỗ hoặc đơn hàng của hệ thống.
LINE service message khác Messaging API như thế nào?
Tài liệu service message chính thức định nghĩa đây là xác nhận hoặc phản hồi cho thao tác của người dùng trong LINE MINI App. Tài liệu Messaging API mô tả tin nhắn từ bot kết nối với LINE Official Account. Ranh giới sản phẩm này quan trọng hơn việc cả hai cùng được gọi là “message”.
| Tiêu chí | LINE MINI App service message | LINE Messaging API message |
|---|---|---|
| Mục đích chính | Xác nhận, báo kết quả hoặc nhắc lại thao tác hoàn tất trong MINI App | Trả lời người dùng hoặc gửi từ Official Account đến một hay nhiều người |
| Trigger | Thao tác hợp lệ của người dùng trong MINI App | Sự kiện người dùng cho reply, hoặc quyết định của ứng dụng cho các kiểu gửi khác |
| Người nhận | Người dùng gắn với service notification token | Người dùng, nhóm, phòng chat nhiều người, audience hoặc bạn của Official Account tùy kiểu gửi |
| Thiết kế | Template do LINE cung cấp và duyệt, với biến và liên kết được chấp thuận | Text, image, video, audio, sticker, location, imagemap, template, Flex và các object được hỗ trợ |
| Điều kiện production | MINI App đã xác minh và template đã duyệt | Messaging API channel nối với LINE Official Account và quy tắc của kiểu gửi |
| Nơi hiển thị | Phòng thông báo MINI App theo khu vực | Phòng chat giữa người dùng và LINE Official Account |
| Giới hạn số lượng | Thông thường tối đa 5 tin cho một thao tác hợp lệ; use case đã duyệt có thể khác | Hạn mức tháng và giới hạn endpoint theo gói Official Account |
| Chi phí | LINE mô tả service message của MINI App là miễn phí | Số lượng và giá Messaging API tùy thị trường và gói Official Account |
Chọn service message cho giao dịch gắn với thao tác
Service Message API phù hợp khi không có thao tác cụ thể trong MINI App thì cũng không có thông báo. Ví dụ chính thức gồm xác nhận đặt chỗ, hoàn tất check-in, hoàn tất giao hàng và lời nhắc cho đặt chỗ hoặc vé đã mua.
Server trước tiên đổi LIFF access token tại POST /message/v3/notifier/token, sau đó gửi template đã duyệt bằng POST /message/v3/notifier/send?target=service. Service notification token gắn với một người dùng và luồng thao tác. Nó không phải địa chỉ LINE lâu dài hay credential push dùng chung.
MINI App đã xác minh vẫn phải tuân thủ giới hạn nội dung. Giảm giá, điểm thưởng, sản phẩm mới, coupon, khuyến mãi và thông báo sự kiện chung không phải service message hợp lệ. Hãy dùng checklist duyệt template khi chuẩn bị và runbook lỗi Service Message API khi integration đã có vấn đề.
Chọn Messaging API cho hội thoại và audience của Official Account
Hãy chọn Messaging API khi người gửi cần là LINE Official Account. Reply message dùng reply token để trả lời tin nhắn hoặc thao tác. Push message gửi đến người dùng, nhóm hoặc phòng chat nhiều người đủ điều kiện. Multicast, narrowcast và broadcast phục vụ các mô hình gửi đến nhiều người khác nhau.
Luồng này có nhiều object nội dung hơn và phù hợp với hội thoại bot, hỗ trợ khách hàng, vận hành Official Account. Đổi lại, nó tuân theo quy tắc kết bạn, người nhận, hạn mức tháng, giá và rate limit. Vì vậy push Messaging API không thay thế khả năng đặc biệt của service message là thông báo cho người dùng MINI App chưa thêm Official Account làm bạn.
Cây quyết định thực tế
- Người dùng đã hoàn tất đặt chỗ, đặt hàng, xếp hàng, check-in hoặc thao tác tương tự trong MINI App? Nếu có, tiếp tục đánh giá service message.
- Thông báo chỉ xác nhận, báo kết quả hoặc nhắc về chính thao tác đó? Nếu không, đừng dùng service message.
- MINI App đã xác minh cho production và đúng template đã được duyệt? Nếu có, dùng Service Message API và lưu token mới sau mỗi lần gửi thành công.
- Tin nhắn cần đến từ Official Account, trả lời chat hoặc tiếp cận audience? Dùng Messaging API và chọn phương thức theo mô hình người nhận.
- Người dùng có thể hỏi tự do sau thông báo? Thiết kế luồng nhận hội thoại riêng rồi liên kết với giao dịch trong hệ thống.
Đừng mặc định gửi cùng một cập nhật qua cả hai luồng. Thông báo trùng lặp làm người dùng bối rối và khó kiểm toán delivery, consent, trách nhiệm hỗ trợ.
UnifyPort phù hợp ở đâu?
UnifyPort không cấp service notification token của LINE, không duyệt template MINI App, không cấp trạng thái xác minh, không tạo Official Account và không thay thế tính năng outbound chính thức của Messaging API. Hãy dùng API LINE cho các phần đó.
UnifyPort giải quyết nhu cầu riêng: nhận tin nhắn khách hàng thông thường từ LINE account đã kết nối và giao tin nhắn được hỗ trợ dưới dạng message.received event chuẩn hóa. Nếu webhook endpoint có signing_secret, delivery gồm X-Device-Timestamp và X-Device-Signature; hãy xác minh HMAC-SHA256 trên raw body trước khi routing.
Điều này hữu ích khi service message xác nhận đặt chỗ rồi khách bắt đầu chat hỗ trợ thông thường. Lưu ID đặt chỗ trong ứng dụng và liên kết với hội thoại, không dùng service notification token làm chat identity. Trước khi triển khai, đọc hướng dẫn authorization LINE và kiểm tra ma trận hỗ trợ message.
Giới hạn và đánh đổi
Service Message API chính thức là con đường cho service message native của MINI App. Unofficial interface không thể thay đổi trạng thái xác minh, duyệt template, mở rộng nội dung được phép hoặc tăng số tin đã duyệt.
Messaging API phù hợp hơn với hội thoại Official Account phong phú và gửi audience, nhưng áp dụng mô hình người nhận, quota và giá của Official Account. Luồng account thông thường của UnifyPort hữu ích cho hội thoại khách hàng được hỗ trợ, nhưng không biến hội thoại đó thành service message của MINI App và không cấp tính năng audience của Official Account.
FAQ
LINE service message là gì?
Đây là thông báo giao dịch từ LINE MINI App để xác nhận, báo kết quả hoặc nhắc về thao tác người dùng hoàn tất trong app. Production cần MINI App đã xác minh và template đã duyệt.
LINE service message có giống push message không?
Không. Service message dùng service notification token gắn với người dùng và template MINI App đã duyệt. Push Messaging API đến từ LINE Official Account và theo quy tắc người nhận, quota, giá của account đó.
Người dùng có phải thêm Official Account để nhận service message không?
Không. LINE cho biết service message có thể đến người dùng MINI App dù họ chưa thêm LINE Official Account liên quan làm bạn. Tin nhắn xuất hiện trong phòng thông báo MINI App theo khu vực.
Service message có thể chứa khuyến mãi hoặc coupon không?
Không. LINE cấm quảng cáo và thông báo sự kiện, gồm giảm giá, điểm thưởng, sản phẩm mới, coupon và khuyến mãi. Hãy chọn phương thức Official Account hợp lệ cho marketing và tuân thủ quy tắc riêng.
Một sản phẩm có thể dùng cả hai API không?
Có. Dùng service message cho cập nhật MINI App gắn với thao tác đã duyệt và Messaging API cho hội thoại hay audience của Official Account. Tách credentials, state và liên kết bằng business ID của bạn.
Bước tiếp theo
Bắt đầu với hướng dẫn quyết định và triển khai service message chính thức của LINE. Nếu nhu cầu riêng là nhận tin nhắn khách hàng LINE thông thường, kiểm tra ranh giới hiện tại trong ma trận hỗ trợ UnifyPort.
Nguồn
Tài liệu LINE chính thức được kiểm tra ngày 07-08-2026: