Telegram URI (tg://)
Нативный URI-протокол Telegram: tg://resolve?domain=username, tg://join?invite=hash и другие схемы для открытия каналов, ботов, чатов и диалогов напрямую в приложении Telegram.
Что такое Telegram URI
Telegram URI — это набор URI-схем с протоколом tg://, которые операционная система передаёт напрямую установленному приложению Telegram, минуя браузер. При сканировании QR-кода с такой ссылкой смартфон мгновенно открывает нужный диалог, канал, бота или приглашение в Telegram без промежуточных страниц загрузки.
Telegram поддерживает два параллельных формата для одних и тех же действий: нативный tg:// и HTTPS-ссылку https://t.me/. Оба ведут к одному результату, но поведение отличается в деталях — особенно когда приложение не установлено или ссылка открывается в нестандартном контексте.
Синтаксис основных схем
Открыть публичный канал, бота или аккаунт по username:
tg://resolve?domain=username
Присоединиться к приватному каналу или группе по инвайт-хешу:
tg://join?invite=ABCDEF1234567890
Открыть диалог с предзаполненным сообщением:
tg://msg?to=username&text=Привет%2C%20хочу%20узнать%20подробнее
Открыть конкретное сообщение в канале (для цитирования или навигации):
tg://resolve?domain=channelname&post=42
Аналоги через HTTPS (рекомендуются для QR — см. ниже):
https://t.me/username→ открыть аккаунт / каналhttps://t.me/joinchat/HASHилиhttps://t.me/+HASH→ приватный инвайтhttps://t.me/username?start=payload→ запустить бота с параметром
Применение в QR-кодах
Telegram QR — одно из ключевых применений для российского рынка, где мессенджер занимает первое место по активности каналов и бизнес-коммуникациям:
- QR на канал. Распечатайте QR с t.me/yourchannel на визитке, листовке или стенде выставки. Один скан — пользователь видит превью канала и кнопку «Подписаться».
- QR на бота. t.me/yourbot?start=source_expo2026 — параметр start передаётся боту при запуске и позволяет атрибутировать источник без UTM в URL.
- QR-приглашение в приватный чат. Инвайт-ссылка t.me/+HASH даёт временный доступ в закрытую группу: на конференциях, в коворкингах, для закрытых сообществ.
- QR для пожертвований. Ссылка на Telegram-бота для платежей или официальный @donate механизм.
- QR на конкретный пост. t.me/channel/123 — ссылка на пост с акцией или анонсом прямо с плаката.
Для физических носителей с длительным сроком жизни (упаковка, вывески) используйте динамический QR через URL Shortener: если username канала изменится или бот переедет — достаточно обновить редирект, не перепечатывая носитель.
Для QR-кодов t.me/ предпочтительнее tg://: HTTPS-ссылка открывается в браузере как предпросмотр, если Telegram не установлен, и предлагает скачать приложение — вместо ошибки «Невозможно открыть».
Частые вопросы
В чём разница между tg:// и t.me/ для QR-кода?
Схема tg:// — нативная: она открывает Telegram напрямую, но только если приложение установлено. На устройстве без Telegram браузер покажет ошибку или ничего не сделает. Ссылка t.me/ открывается через браузер как HTTPS-страница с превью профиля / канала и кнопкой «Открыть в Telegram» или «Скачать Telegram». Для QR-кодов на публичных носителях используйте t.me/: она работает везде и направляет новых пользователей на установку приложения.
Как добавить предзаполненный текст в Telegram QR?
Для ботов: t.me/yourbot?start=текст передаёт payload в команду /start — бот получает его и может отреагировать соответствующим сообщением. Для обычных диалогов через нативный URI: tg://msg?to=username&text=текст. Важно: параметр text только предзаполняет поле ввода — пользователь должен нажать «Отправить» самостоятельно. Автоматической отправки без действия пользователя нет.
Как сделать QR на приватный Telegram-канал?
В настройках приватного канала или группы перейдите в «Управление группой» → «Пригласительные ссылки» → создайте ссылку. Она будет вида t.me/+HASH или t.me/joinchat/HASH. Эту ссылку закодируйте в QR. Важно: инвайт-ссылки можно настроить с ограниченным сроком действия или лимитом использований. Для QR на постоянных носителях создавайте бессрочную ссылку и не теряйте доступ к каналу — иначе QR перестанет работать.
Можно ли сделать QR, который открывает Telegram напрямую без браузера?
Да — используйте tg:// схему. Большинство QR-сканеров на iOS и Android при распознавании tg:// передают её напрямую в Telegram без открытия браузера. Однако на устройствах без Telegram это приведёт к ошибке. Компромиссное решение: использовать динамический QR с переадресацией через Smart Routing — на устройствах с Telegram открывается нативная ссылка, без приложения — страница загрузки.
Как передать параметры боту через QR для аналитики?
Параметр start в ссылке t.me/yourbot?start=payload — это основной механизм атрибуции для Telegram-ботов. Payload (до 64 символов) передаётся боту в команде /start и может содержать идентификатор источника: start=poster_msk_may или start=qr_expo_stand2. Бот фиксирует параметр в своей аналитике. Это аналог UTM-меток для Telegram-трафика из QR-кодов.