Định dạng liên kết Telegram

Mỗi hàng hiển thị liên kết web thông thường, lược đồ URL cho iPhone và dạng Android. Thay thế các chỗ giữ viết hoa bằng giá trị thực.

Nội dungLiên kết webiPhone (lược đồ URL)Android
Kênh, nhóm hoặc người dùnghttps://t.me/USERNAMEtg://resolve?domain=USERNAMEintent://t.me/USERNAME#Intent;package=org.telegram.messenger;scheme=https;end
Chức vụ cụ thểhttps://t.me/CHANNEL/123tg://resolve?domain=CHANNEL&post=123intent://t.me/CHANNEL/123#Intent;package=org.telegram.messenger;scheme=https;end
Bot với tham số bắt đầuhttps://t.me/BOTNAME?start=PAYLOADtg://resolve?domain=BOTNAME&start=PAYLOADintent://t.me/BOTNAME?start=PAYLOAD#Intent;package=org.telegram.messenger;scheme=https;end
Lời mời riênghttps://t.me/+INVITE_CODEtg://join?invite=INVITE_CODEintent://t.me/+INVITE_CODE#Intent;package=org.telegram.messenger;scheme=https;end
Note

tg:// bỏ qua trang web t.me yêu cầu khách truy cập chạm vào "Mở trong Telegram".

Not an official API

Hầu hết các ứng dụng không chính thức ghi lại các sơ đồ URL của chúng. Các định dạng dưới đây là những định dạng mà DSLink đang sử dụng trong thực tế hiện nay, nhưng một bản cập nhật ứng dụng có thể thay đổi chúng — hãy thử trên thiết bị thực trước khi mã hóa cứng một sơ đồ vào ứng dụng hoặc trang web của riêng bạn.

Sử dụng kế hoạch trên một trang web

Một sơ đồ URL có thể đi thẳng vào một liên kết. Trên iPhone, Safari yêu cầu người truy cập xác nhận trước khi chuyển sang ứng dụng khác:

<a href="tg://resolve?domain=USERNAME">Open in Telegram</a>

Trên Android, bạn có thể thêm một phương án dự phòng web vào chính intent. Nếu ứng dụng không có, Chrome sẽ mở URL dự phòng thay vì gặp lỗi:

intent://t.me/USERNAME#Intent;package=org.telegram.messenger;scheme=https;S.browser_fallback_url=https%3A%2F%2Ft.me%2FUSERNAME;end

Hai giới hạn áp dụng ở mọi nơi. Nếu ứng dụng không được cài đặt, một scheme trần không làm gì hữu ích — iOS sẽ hiển thị lỗi. Và các trình duyệt tích hợp bên trong các ứng dụng như Instagram, TikTok hoặc X thường chặn hoặc bỏ qua các scheme tùy chỉnh, chính xác là nơi hầu hết các liên kết được nhấn.

Một liên kết thông minh DSLink gói tất cả những điều này trong một URL ngắn. Trên điện thoại, nó thử định dạng ứng dụng phù hợp với thiết bị, quay lại trang web Telegram nếu ứng dụng bị thiếu, và gửi khách truy cập máy tính trực tiếp đến trang web. Bạn chia sẻ một liên kết ở mọi nơi và nhận thống kê nhấp chuột ở phía trên.

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

Sơ đồ URL tg:// là gì?

tg:// là giao thức mà ứng dụng Telegram đăng ký. tg://resolve?domain=NAME mở một kênh, nhóm, người dùng hoặc bot; tg://join?invite=CODE mở một lời mời riêng tư.

Tôi có thể truyền tham số start cho một bot Telegram không?

Có: tg://resolve?domain=BOTNAME&start=PAYLOAD. Payload có thể chứa chữ cái, chữ số, gạch dưới và dấu gạch ngang.

Điều gì sẽ xảy ra nếu ứng dụng Telegram không được cài đặt?

Một giao thức URL trần sẽ thất bại: iOS hiển thị lỗi và không mở gì cả. Luôn kết hợp nó với một phương án dự phòng trên web — trên Android với S.browser_fallback_url trong intent, hoặc sử dụng liên kết thông minh DSLink, liên kết này sẽ tự động chuyển sang trang web dự phòng.