Cẩm nang November 7, 2026

URI action của LINE: Giới hạn 10.000 ký tự và liên kết máy tính

URI action trong LINE Messaging API hiện cho phép tối đa 10.000 ký tự cho từng thuộc tính uri và altUri.desktop. LINE công bố thay đổi này ngày 27/10/2026. Hãy cập nhật bộ kiểm tra cho đúng hai thuộc tính đó, không nới giới hạn của mọi URL hay trường văn bản. Với Flex Message, khi có địa chỉ thay thế cho máy tính, LINE trên macOS và Windows dùng địa chỉ ấy thay cho uri; đây không phải tùy chọn dùng chung cho mọi loại tin nhắn.

Điểm chính

Giới hạn mới áp dụng cho địa chỉ đích của URI action, không phải số nút hay toàn bộ tin nhắn.
Kiểm tra chuỗi URI thực sự được gửi, sau khi ghép tham số và mã hóa.
Dùng altUri.desktop trong URI action của Flex Message được hỗ trợ; không dùng cho quick reply.
API chấp nhận tin nhắn, người dùng mở trang và hoàn thành thao tác nghiệp vụ là ba việc cần kiểm tra riêng.

LINE đã thay đổi điều gì?

Kho tin chính thức năm 2026 của LINE ghi nhận thay đổi ngày 27/10. Tài liệu URI action hiện tại nêu giới hạn 10.000 ký tự cho cả hai thuộc tính.

Thuộc tính	Giới hạn hiện tại	Ý nghĩa
`uri`	10.000 ký tự	URI được mở khi thực hiện action
`altUri.desktop`	10.000 ký tự	URI thay thế trên LINE cho macOS và Windows trong ngữ cảnh được hỗ trợ

Các scheme được LINE liệt kê gồm http, https, line và tel; URI phải được percent-encode bằng UTF-8. Scheme hợp lệ và độ dài đúng không chứng minh trang đích tồn tại hay người dùng có quyền truy cập.

Đừng đổi mọi giới hạn trong ứng dụng thành 10.000. URL ảnh, nhãn, nội dung văn bản và cấu trúc chứa tin nhắn có quy định riêng. Nếu vấn đề là quá nhiều lựa chọn chứ không phải địa chỉ quá dài, hãy xem các lựa chọn thay thế buttons template của LINE.

Chọn đích đến cho từng loại ứng dụng LINE

Theo tài liệu LINE, khi đặt altUri.desktop, LINE trên macOS và Windows bỏ qua uri để mở địa chỉ thay thế. Thuộc tính này được hỗ trợ trong URI action của Flex Message nhưng không hoạt động trong quick reply. Thông báo cũng xác định Flex Message là loại sử dụng thuộc tính dành cho máy tính; không nên suy rộng sang template message hoặc rich menu.

Dưới đây là đối tượng action minh họa để đặt trong Flex Message, không phải yêu cầu gửi hoàn chỉnh:

{
  "type": "uri",
  "label": "Xem chi tiết",
  "uri": "https://example.com/mobile/orders/42",
  "altUri": {
    "desktop": "https://example.com/orders/42"
  }
}

Các URL chỉ là ví dụ, không phải trang đơn hàng đang hoạt động. Hãy đặt action trong thành phần tương thích rồi kiểm tra toàn bộ tin nhắn theo tài liệu LINE. Nếu luồng của bạn là chia sẻ trang MINI App, hãy dùng hướng dẫn custom action button và liên kết cố định. Giới hạn dài hơn không thay thế cách tạo liên kết MINI App đúng.

Kiểm tra URI cuối cùng, không chỉ ô nhập liệu

Trước khi cho phép địa chỉ dài hơn, hãy thực hiện danh sách kiểm tra sau:

Tìm mọi chốt kiểm tra độ dài trong ứng dụng. Rà soát trình soạn thảo, kiểm tra phía backend, bộ tạo tin nhắn và mô hình SDK đang dùng. Chỉ sửa kiểm tra cho hai thuộc tính URI action được nêu. Xác minh phiên bản SDK thực tế, đừng mặc định mọi phiên bản đều chấp nhận giới hạn mới.
Tạo xong rồi mới đo. Ghép địa chỉ và tham số truy vấn, áp dụng percent-encoding UTF-8 đúng cách. Kiểm tra giá trị thuộc tính cuối cùng, không phải văn bản chưa mã hóa hay độ dài toàn bộ JSON. Không mã hóa cả URL như một giá trị truy vấn đơn lẻ và không mã hóa lặp lại giá trị đã được mã hóa.
Kiểm tra độc lập cả hai địa chỉ. URI di động hợp lệ không xác nhận URI máy tính hợp lệ. Trang máy tính cần dùng được ngoài luồng chỉ dành cho di động, đồng thời xử lý riêng việc đăng nhập và bản ghi không còn truy cập được.
Kiểm tra quyền tại trang đích. Theo thực hành an toàn cho ứng dụng, không đặt API key, thông tin xác thực phiên hay dữ liệu cá nhân không cần thiết trong liên kết. Có thêm chỗ không phải lý do đưa cả hồ sơ khách hàng vào chuỗi truy vấn. Ưu tiên tham chiếu tới bản ghi mà máy chủ kiểm tra quyền trước khi trả dữ liệu.
Thử thao tác trên tin nhắn thật. Xác nhận toàn bộ tin nhắn được chấp nhận, sau đó bấm action trên ứng dụng di động và máy tính mục tiêu. Kiểm tra trang cuối sau chuyển hướng, không chỉ URL do bộ tạo tin nhắn sinh ra.

Bộ kiểm thử hồi quy nên có giá trị đúng bằng và vượt giới hạn, tham số ngoài ASCII sau mã hóa, URI máy tính sai độc lập với URI di động, và trang yêu cầu đăng nhập. Đây là các kiểm thử đề xuất, không phải kết quả đã thực hiện. Không kết luận toàn bộ luồng thành công chỉ từ phản hồi gửi tin.

Tách biệt với hợp đồng API của UnifyPort

Thay đổi này thuộc LINE Messaging API chính thức. Ma trận hỗ trợ tin nhắn chuẩn hóa của UnifyPort không mô tả khả năng gửi URI action của LINE Flex Message hay trường altUri.desktop. Đừng thêm trường ấy vào yêu cầu UnifyPort rồi kỳ vọng thẻ tương tác gốc sẽ được hiển thị.

Nếu cần thẻ tương tác gốc của LINE, hãy dùng tích hợp LINE chính thức. Giao diện không chính thức của UnifyPort phục vụ nhu cầu khác: kết nối tài khoản LINE thông thường và xử lý hội thoại được hỗ trợ qua sự kiện chuẩn hóa. Xem hướng dẫn xác thực LINE để chọn luồng tài khoản phù hợp. Với nhóm đang xử lý thêm WhatsApp hoặc Zalo, vẫn cần kiểm tra khả năng riêng của từng kênh; sự kiện chung không có nghĩa là mọi kênh đều hỗ trợ thẻ LINE. Việc tăng độ dài URI cũng không đổi danh tính hay khả năng của tích hợp đã chọn.

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

URI action của LINE vẫn giới hạn 1.000 ký tự phải không?

Không. Thông báo ngày 27/10/2026 đã tăng giới hạn; tài liệu hiện tại quy định tối đa 10.000 ký tự cho uri và altUri.desktop. Nếu giá trị dài vẫn bị từ chối, hãy kiểm tra validator trong ứng dụng.

altUri.desktop có hoạt động trong quick reply không?

Không. LINE nói rõ thuộc tính này không hoạt động trong quick reply. Hãy dùng ngữ cảnh Flex Message được tài liệu hỗ trợ và kiểm thử ứng dụng máy tính tương ứng.

Số nút hoặc quyền chia sẻ của MINI App có tăng không?

Không. Thay đổi chỉ áp dụng cho độ dài các thuộc tính URI action được chỉ định. Giới hạn bố cục, luồng chia sẻ, xác thực và quyền truy cập trang đích vẫn là các yêu cầu riêng.

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

Bắt đầu bằng cách rà soát bộ tạo tin nhắn theo tài liệu URI action của LINE. Nếu còn đang chọn giữa thẻ gốc và tin nhắn chuẩn hóa, hãy kiểm tra ma trận hỗ trợ UnifyPort trước khi triển khai luồng gửi.

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

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.

Lấy API Key Xem tham chiếu API