Hướng dẫn August 9, 2026

Tái xét duyệt LINE MINI App: từ Approved đến Reflected

LINE MINI App đã xác minh phải tái xét duyệt khi bạn thay đổi các thiết lập chịu kiểm soát như tên, URL chính sách quyền riêng tư, Published Endpoint, scopes, LINE Official Account được liên kết, Service Message template hoặc thông tin doanh nghiệp. Với app đã phát hành, được duyệt không có nghĩa là thay đổi lên production ngay: trạng thái dừng ở Approved cho đến khi bạn chọn Publish changes, rồi mới thành Reflected. Nếu không thao tác, LINE tự phản ánh thay đổi vào ngày thứ 31.

Điểm chính

Thay đổi thiết lập chịu xét duyệt trong LINE Developers Console cần tái xét duyệt. Việc cập nhật code hoặc nội dung không chạm các thiết lập đó không tự động cần xét duyệt, nhưng vẫn phải tuân thủ LINE MINI App Policy.
MINI App đã xác minh có ba internal channel Developing, Review và Published; mỗi channel có LIFF ID riêng.
Với app đang chạy, Approved là cửa sổ phát hành. Publish changes mới sao chép cấu hình đã duyệt sang Published và đổi thành Reflected.
Nếu không phát hành thủ công trong 30 ngày, LINE tự phản ánh vào 9:00 JST ngày thứ 31; cuối tuần và ngày lễ vẫn được tính.
Tạm thay Published Endpoint vì bảo trì hợp lệ là ngoại lệ được tài liệu hóa, không phải cách đưa thay đổi vĩnh viễn lên mà không tái xét duyệt.

Thay đổi LINE MINI App nào cần tái xét duyệt?

Hướng dẫn tái xét duyệt chính thức của LINE liệt kê các thiết lập Console quay lại quy trình kiểm tra. Điểm phân biệt không phải có deploy code hay không, mà là release có thay đổi hợp đồng đã được kiểm tra trong LINE Developers Console hay không.

Phạm vi	Ví dụ cần tái xét duyệt	Ý nghĩa khi phát hành
Basic settings	Icon, tên, mô tả, email, privacy policy, terms, localization, Official Account được liên kết	Gom thay đổi thương hiệu và pháp lý vào một bộ xét duyệt
Web app settings	`shareTargetPicker`, consent simplification, Published Endpoint, scopes, add-friend option	Không bật hành vi phụ thuộc trước khi thiết lập thành `Reflected`
Doanh nghiệp và liên hệ	Thông tin service, developer, provider và toàn bộ contact	Giữ pháp nhân và đầu mối hỗ trợ nhất quán
Service Message	Mọi thông tin template	Dùng template đang Published làm hợp đồng production đến khi bản mới được phản ánh
In-app purchase	Thông tin trong tab đăng ký	Sắp xếp đợt xét duyệt in-app purchase riêng trước verification review

Thay đổi không liên quan các thiết lập Console này không cần tái xét duyệt chỉ vì code hay nội dung app thay đổi. Tuy nhiên đây không phải miễn trừ chính sách: LINE vẫn có thể yêu cầu sửa nội dung hoặc creative đã phát hành nếu vi phạm MINI App Policy.

Bài này bắt đầu sau lần xác minh đầu tiên. Khi nộp lần đầu, dùng checklist verification review. Nếu thay đổi use case, biến hoặc link của Service Message, chuẩn bị theo checklist xét duyệt template.

Approved là cửa sổ phát hành, chưa phải production

Hướng dẫn gửi xét duyệt chính thức phân biệt hai luồng sau khi được duyệt:

Tình huống	Điều xảy ra sau approval	Việc của operator	Mốc tự động
Xác minh lần đầu	Từ `Approved` sang `Reflected` ngay	Bật search riêng khi sẵn sàng	Search tự bật lúc 9:00 JST ngày 31 nếu chưa bật thủ công
Tái xét duyệt app đã Published	Dừng ở `Approved`; production vẫn dùng cấu hình hiện tại	Chọn Publish changes	Thay đổi tự phản ánh lúc 9:00 JST ngày 31 nếu chưa phát hành thủ công

Hàng thứ hai là ranh giới release quan trọng. Approved nói rằng thay đổi được phép phát hành, không nói rằng người dùng đã thấy nó. Sau Publish changes, cấu hình Review được sao chép sang Published và trạng thái thành Reflected. LINE lưu ý việc tự chuyển ngày 31 có thể trễ một đến hai giờ.

Checklist từ Developing đến Reflected

Ghi lại thiết lập được xét duyệt. Lưu đúng phiên bản tên, URL, scopes, account liên kết, bộ template và dữ liệu doanh nghiệp trong request.
Tách ba LIFF ID. Developing, Review và Published có ID riêng. Khởi tạo từng môi trường bằng ID tương ứng và thử Review URL mà người xét duyệt sẽ mở.
Kiểm tra dependency trước khi phát hành. Xác nhận redirect, privacy policy, terms, permanent links, Service Message template, add-friend và consent theo cấu hình đã gửi.
Ghi thời điểm approval và ngày thứ 31. Tính cả cuối tuần và ngày lễ; không xem auto-release như trạng thái giữ vô thời hạn.
Lên lịch Publish changes. Chỉ định một owner, đặt điều kiện go/no-go và lưu bằng chứng chuyển từ Approved sang Reflected.
Acceptance test sau phát hành. Mở Published LIFF URL trên ứng dụng LINE thật, kiểm tra tên và thiết lập, rồi xác nhận luồng nhận tin nhắn khách hàng vẫn ổn định.

Khi đạt Reflected, channel trở về Not yet reviewed cho chu kỳ sau. Chỉnh sửa mới nằm ở Developing và không đổi app production hiện tại cho đến khi qua xét duyệt và phát hành tiếp theo.

Đổi Endpoint khẩn cấp và rollback

LINE cho biết tạm thay Published Endpoint vì bảo trì hoặc lý do hợp lệ khác không cần tái xét duyệt và có hiệu lực ngay. Chỉ dùng trong phạm vi hẹp: chuyển sang trang bảo trì có kiểm soát, lưu Endpoint cũ, kiểm tra phản hồi người dùng và khôi phục dịch vụ đã duyệt khi sự cố kết thúc.

Không dùng ngoại lệ bảo trì để phát hành vĩnh viễn sản phẩm, scopes, danh tính hay template mới. Chúng vẫn chịu xét duyệt. Nếu thông tin in-app purchase cũng thay đổi, phải xếp đúng thứ tự: không thể gửi verification review khi hồ sơ in-app purchase đang được xét, và không thể đăng ký in-app purchase trong lúc verification review.

UnifyPort phù hợp ở đâu?

UnifyPort không gửi LINE MINI App đi xét duyệt, không đổi Approved hoặc Reflected, không sao chép thiết lập giữa các internal channel và không cấp tính năng verified. Danh tính MINI App, search, Service Message, Quick-fill, shortcut và in-app purchase phải dùng quy trình chính thức của LINE.

UnifyPort xử lý một đường vận hành riêng: nhận các tin nhắn được hỗ trợ từ tài khoản LINE thông thường đã kết nối dưới dạng sự kiện message.received chuẩn hóa. Nếu webhook endpoint có signing_secret, hãy xác minh X-Device-Timestamp và X-Device-Signature trên raw request body trước khi routing.

Tách hai đường giúp release MINI App đi qua xét duyệt LINE mà không âm thầm đổi hợp đồng nhận hỗ trợ. Bắt đầu với hướng dẫn xác thực LINE và xác nhận ranh giới hiện tại trong ma trận hỗ trợ tin nhắn.

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

Tái xét duyệt chính thức là bắt buộc khi thay đổi tác động thiết lập chịu kiểm tra hoặc tính năng chỉ dành cho verified MINI App. Unofficial interface không thể tăng tốc approval, ngăn tự phát hành ngày 31, rollback thay đổi LINE Console hoặc biến tin nhắn tài khoản thường thành MINI App Service Message.

Ngược lại, tái xét duyệt thành công chỉ chứng minh LINE chấp nhận cấu hình đã gửi; nó không chứng minh deployment, deep link, monitoring hay inbound queue hoạt động end-to-end. Hãy giữ review status và operational readiness thành hai release gate riêng.

FAQ

Approved khác Reflected thế nào?

Approved nghĩa là LINE chấp nhận thay đổi. Với verified MINI App đã phát hành, người dùng vẫn thấy cấu hình hiện tại đến khi chọn Publish changes hoặc tới hạn tự động. Reflected nghĩa là thay đổi đã duyệt đã được sao chép sang Published.

Thay đổi được duyệt có thể chờ bao lâu trước khi phát hành?

Tối đa 30 ngày. Nếu không chọn Publish changes, LINE tự phản ánh lúc 9:00 JST ngày thứ 31, tính cả cuối tuần và ngày lễ, và có thể chậm một đến hai giờ.

Mỗi lần deploy code có cần tái xét duyệt không?

Không. LINE không yêu cầu tái xét duyệt với cập nhật không liên quan thiết lập Console chịu kiểm tra. Dịch vụ đã phát hành vẫn phải tuân thủ LINE MINI App Policy.

Có thể tạm đổi Published Endpoint khi bảo trì không?

Có. LINE ghi rõ việc tạm thay vì bảo trì hoặc lý do hợp lệ khác có hiệu lực ngay và không cần xét duyệt. Hãy có kế hoạch khôi phục đã kiểm thử.

Sửa Service Message template có cần tái xét duyệt không?

Có. LINE xếp toàn bộ thông tin template vào nhóm chịu kiểm tra. Template Reflected hiện tại vẫn là hợp đồng production đến khi bản thay thế được duyệt và phát hành.

Bước tiếp theo

Lập lịch release theo hướng dẫn tái xét duyệt và quy trình gửi-phát hành chính thức của LINE. Nếu nhu cầu riêng là nhận tin nhắn khách hàng từ tài khoản LINE thông thường, hãy theo hướng dẫn xác thực LINE của UnifyPort.

Nguồn

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