Cẩm nang July 28, 2026

Duyệt mẫu tin nhắn dịch vụ LINE MINI App: Checklist trước khi gửi

Trước khi gửi mẫu tin nhắn dịch vụ LINE MINI App để duyệt, hãy chọn mẫu do LINE cung cấp phù hợp nhất, mô tả chính xác hành động của người dùng và chuỗi thông báo trong Use Case, kiểm thử toàn bộ biến và permanent link, rồi loại bỏ nội dung quảng bá. Muốn gửi trên production, MINI App phải được xác minh và Published status của mẫu phải là PUBLISHING; gửi thành công trong simulator hoặc trạng thái DEVELOPING chưa phải là phê duyệt production.

Điểm chính

Tin nhắn dịch vụ chỉ được xác nhận hoặc phản hồi một hành động người dùng đã thực hiện trong MINI App. Giảm giá, phần thưởng mua sắm, sản phẩm mới, coupon, promotion và thông báo sự kiện chung đều bị cấm.
LINE cung cấp bố cục mẫu; đội ngũ chọn danh mục và ngôn ngữ, khai báo biến, liên kết và use case thực tế.
Mỗi channel có thể thêm tối đa 20 mẫu. Tên dùng cho API có dạng {template name}_{BCP 47 language tag} và phải khớp LINE Developers Console.
Khi channel MINI App đang được duyệt, bạn có thể xem mẫu và dùng simulator nhưng không thể thêm, sửa Use Case hoặc xoá mẫu.
Thay đổi thông tin mẫu sau khi MINI App đã được xác minh cần tái duyệt; hãy coi Use Case được phê duyệt là ranh giới production.

Việc duyệt mẫu tin nhắn dịch vụ LINE xác nhận điều gì

Tài liệu chính thức về tin nhắn dịch vụ tách ba bước thường bị nhầm lẫn:

Điều kiện của MINI App: tin nhắn dịch vụ trên production chỉ dành cho LINE MINI App đã xác minh. App chưa xác minh chỉ thử được trên Developing channel nội bộ với tài khoản Admin hoặc Tester.
Duyệt mẫu: mẫu đã chọn và Use Case khai báo phải được LY Corporation duyệt trước khi dùng trên production.
Uỷ quyền lúc chạy: sau khi được duyệt, máy chủ vẫn cần service notification token gắn với người dùng và hành động trước khi gọi API gửi.

Hướng dẫn so sánh MINI App đã và chưa xác minh giải quyết bước đầu; bài hướng dẫn service notification token giải quyết bước ba. Checklist này tập trung vào phần ở giữa: chuẩn bị mẫu và quy tắc vận hành trước khi gửi duyệt.

Trạng thái	Có thể làm gì	Không chứng minh được điều gì
`DEVELOPING`	Preview và thử với tài khoản nhà phát triển hợp lệ trên Developing channel nội bộ	Người dùng production đã nhận được tin nhắn
Channel MINI App đang duyệt	Xem chi tiết mẫu, gửi thử bằng simulator	Có thể thêm, sửa hoặc xoá mẫu trong lúc duyệt
`PUBLISHING`	Dùng mẫu đã duyệt trên production sau khi MINI App được xác minh	Có thể đổi Use Case hoặc chuyển mẫu thành quảng cáo
Sửa mẫu sau khi xác minh	Chuẩn bị cấu hình mới để tái duyệt	Phê duyệt cũ tự động bao phủ thay đổi

LINE dùng PUBLISHING cho Published status của mẫu đã qua duyệt. Đừng tự tạo một trạng thái “production-ready” khác trong ứng dụng. Hãy lưu trạng thái thực tế từ Console và chặn job production cho tới khi cả channel lẫn mẫu đều sẵn sàng.

Checklist duyệt mẫu tin nhắn dịch vụ LINE MINI App

1. Bắt đầu bằng một hành động người dùng

Trước tiên, ghi rõ trigger: đặt bàn, đăng ký xếp hàng, đặt hàng, check-in, yêu cầu giao hàng hoặc một hành động khác hoàn tất trong MINI App. Sau đó mới liệt kê xác nhận, kết quả hoặc nhắc nhở mà người dùng cần vì hành động đó.

LINE thường cho phép tối đa năm tin nhắn dịch vụ cho một hành động, nhưng giới hạn được duyệt có thể khác theo use case. Phần mô tả nên trình bày toàn bộ chuỗi, chẳng hạn xác nhận ngay sau khi đặt chỗ, nhắc trước một ngày và cập nhật trạng thái trong ngày. Không nên mô tả nó như một nhóm marketing định kỳ.

2. Chọn mẫu chính thức và ngôn ngữ phù hợp nhất

LINE cung cấp các mẫu theo danh mục như đặt chỗ cửa hàng, quản lý hàng chờ và thông báo giao hàng. Ngôn ngữ hỗ trợ gồm tiếng Nhật, Anh, Hoa phồn thể, Thái, Indonesia và Hàn. Hãy chọn bố cục đúng với thao tác, thay vì ép nội dung quảng bá vào một mẫu giao dịch.

Sao chép nguyên giá trị Template name for API use trong Console. Trường request là templateName, theo định dạng {template name}_{BCP 47 language tag}. Không tự suy ra hậu tố ngôn ngữ từ tiêu đề hiển thị.

3. Viết Use Case đủ cụ thể để kiểm thử

Use Case cần nói rõ ai thực hiện hành động, ở đâu, mỗi thông báo xác nhận điều gì và được gửi lúc nào. “Cập nhật cho khách hàng” quá mơ hồ. Bản có thể kiểm thử sẽ giống: “Người dùng hoàn tất đặt lịch giao hàng trong MINI App; gửi xác nhận ngay, sau đó gửi kết quả giao hàng khi đơn vị vận chuyển cập nhật đơn.”

LINE cảnh báo rằng việc dùng mẫu khác với mô tả đã nộp có thể khiến mẫu bị ngừng sử dụng. Lưu mô tả đã duyệt cạnh định nghĩa job trong runbook nội bộ để thay đổi sản phẩm sau này không âm thầm mở rộng phạm vi.

4. Kiểm tra biến, giới hạn ký tự và permanent link

Trong preview của Console, thử giá trị ngắn, giá trị thông thường và giá trị gần giới hạn cho từng biến. Ngày, tên, mã đơn và nội dung bản địa hoá phải nằm trong mức khuyến nghị và giới hạn cứng của mẫu. Nếu mẫu không có biến, request gửi vẫn cần params: {}.

Nút phải dùng permanent link đến trang trong LINE MINI App. Nút đầu tiên là bắt buộc; các nút sau tuỳ theo mẫu. Hãy kiểm tra bên trong ứng dụng LINE, gồm trạng thái đăng nhập và đơn đã hết hạn, thay vì chỉ mở URL trên trình duyệt máy tính.

5. Hoàn tất simulator trước khi đóng bộ hồ sơ

Console có thể gửi tin nhắn thử đến tài khoản LINE liên kết với tài khoản nhà phát triển đang đăng nhập. Kiểm tra bố cục, thứ tự biến, ngôn ngữ, nút và footer. Simulator thành công chỉ chứng minh phần hiển thị, không chứng minh đủ điều kiện production.

Hoàn thiện toàn bộ bộ mẫu trước khi gửi channel MINI App để duyệt. Trong thời gian duyệt, bạn không thể thêm mẫu mới, sửa Use Case hoặc xoá mẫu. Mẫu đã thêm thành công trước đó vẫn còn, nhưng đây không phải thời điểm phù hợp để phát hiện thiếu một loại thông báo.

6. Xác định ranh giới thay đổi sau phê duyệt

Sau khi MINI App được xác minh, mọi thay đổi thông tin mẫu tin nhắn dịch vụ đều cần tái duyệt theo hướng dẫn cập nhật của LINE. Đưa thay đổi mẫu vào change control và so sánh hành động, nội dung, biến, liên kết, thời điểm gửi với bản đã duyệt trước khi phát hành code phụ thuộc.

Trong runtime, có thể ghi templateName, ID hành động hoặc đơn hàng, sessionId và remainingCount mới nhất. Không ghi LIFF access token, channel access token hay service notification token vào log. Phê duyệt mẫu không thay thế quản lý vòng đời token và theo dõi delivery.

UnifyPort phù hợp ở đâu

UnifyPort không gửi hay phê duyệt mẫu LINE MINI App, không đổi Published status, không cấp LINE service notification token và không mở rộng nội dung LINE cho phép. Thông báo gắn với đặt chỗ, đơn hàng, hàng chờ hoặc hành động trong MINI App phải đi theo luồng chính thức của LINE.

UnifyPort giải quyết yêu cầu khác: nhận tin nhắn tự do từ tài khoản LINE thông thường đã kết nối. Tài khoản LINE được uỷ quyền bằng QR; tin nhắn inbound được hỗ trợ đến dưới dạng sự kiện chuẩn message.received. Nếu webhook endpoint có signing_secret, delivery gồm X-Device-Timestamp và X-Device-Signature để xác minh HMAC-SHA256.

Với đội ngũ ở Việt Nam đang vận hành cả LINE và Zalo, schema chuẩn giúp giữ pipeline hỗ trợ tách khỏi thông báo giao dịch của MINI App. Khi người dùng nhận service message rồi đặt câu hỏi, mẫu đã duyệt xử lý thông báo; luồng inbound riêng xử lý hội thoại. Hướng dẫn nhận tin LINE mô tả kiến trúc thứ hai mà không thay đổi điều kiện MINI App.

Giới hạn và đánh đổi

Nếu MINI App cần gửi thông báo giao dịch được duyệt, luồng chính thức của LINE là lựa chọn đúng. Giao diện không chính thức không thể cấp trạng thái xác minh hay duyệt mẫu.
PUBLISHING không phải quyền nhắn tin chung; nội dung vẫn phải nằm trong Use Case và chính sách service message đã duyệt.
Duyệt mẫu không đảm bảo mọi API call thành công. Token hết hạn hoặc luân chuyển, remainingCount về 0, biến không hợp lệ vẫn gây lỗi.
Service message không phải hộp thư hỗ trợ. Hãy thiết kế luồng inbound riêng nếu người dùng cần đặt câu hỏi mở.

FAQ

Trạng thái nào cho biết mẫu LINE đã qua duyệt?

LINE dùng Published status PUBLISHING cho mẫu đã qua duyệt và có thể dùng trên production sau khi MINI App được xác minh.

LINE MINI App chưa xác minh có gửi service message trên production được không?

Không. App chỉ có thể thử trên Developing channel nội bộ; production cần MINI App đã xác minh và mẫu đã duyệt.

Service message có thể chứa coupon hoặc promotion không?

Không. LINE cấm giảm giá, phần thưởng, sản phẩm mới, coupon, promotion, quảng cáo và thông báo sự kiện chung. Tin nhắn phải gắn với hành động trong MINI App.

Có thể sửa mẫu khi channel MINI App đang được duyệt không?

Không. Bạn có thể xem chi tiết và dùng simulator, nhưng không thể thêm mẫu, sửa Use Case hoặc xoá mẫu.

Sửa mẫu có cần tái duyệt không?

Có. LINE liệt kê toàn bộ thông tin mẫu service message là cài đặt cần tái duyệt sau khi cập nhật MINI App đã xác minh.

Bước tiếp theo

Chuẩn bị mẫu, Use Case, biến và bằng chứng simulator theo hướng dẫn service message chính thức của LINE. Nếu nhu cầu thật là nhận tin nhắn tự do thay vì thông báo giao dịch, dùng hướng dẫn uỷ quyền LINE của UnifyPort như một lộ trình riêng.

Nguồn

Nguồn chính thức của LINE được kiểm tra ngày 28 tháng 7 năm 2026: