Форматы ссылок Telegram

Каждая строка показывает обычную веб-ссылку, схему URL для iPhone и форму для Android. Замените прописные заполнители на реальные значения.

КонтентВеб-ссылкаiPhone (схема URL)Андроид
Канал, группа или пользовательhttps://t.me/USERNAMEtg://resolve?domain=USERNAMEintent://t.me/USERNAME#Intent;package=org.telegram.messenger;scheme=https;end
Конкретный постhttps://t.me/CHANNEL/123tg://resolve?domain=CHANNEL&post=123intent://t.me/CHANNEL/123#Intent;package=org.telegram.messenger;scheme=https;end
Бот с параметром starthttps://t.me/BOTNAME?start=PAYLOADtg://resolve?domain=BOTNAME&start=PAYLOADintent://t.me/BOTNAME?start=PAYLOAD#Intent;package=org.telegram.messenger;scheme=https;end
Приватное приглашениеhttps://t.me/+INVITE_CODEtg://join?invite=INVITE_CODEintent://t.me/+INVITE_CODE#Intent;package=org.telegram.messenger;scheme=https;end
Note

tg:// пропускает веб-страницу t.me, которая предлагает посетителям нажать «Открыть в Telegram».

Not an official API

Большинство приложений официально не документируют свои URL-схемы. Приведенные ниже форматы — это те, которые DSLink использует в производстве на сегодняшний день, но обновление приложения может их изменить — тестируйте на реальном устройстве перед тем, как жестко прописывать схему в ваше собственное приложение или сайт.

Использование схемы на веб-сайте

Схему URL можно вставить прямо в ссылку. На iPhone Safari просит пользователя подтвердить переход перед переключением приложений:

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

На Android вы можете добавить веб-резервный вариант прямо к самому интенту. Если приложение отсутствует, Chrome откроет резервный URL вместо того, чтобы выдать ошибку:

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

Существуют два ограничения, которые применяются повсюду. Если приложение не установлено, пустая схема ничего полезного не делает — iOS показывает ошибку. А встроенные браузеры внутри приложений, таких как Instagram, TikTok или X, часто блокируют или игнорируют пользовательские схемы, и именно там большинство ссылок нажимается.

Умная ссылка DSLink объединяет всё это в одном коротком URL. На телефоне она подбирает правильный формат приложения для устройства, если приложении нет — переходит на веб-страницу Telegram, а для настольных пользователей сразу направляет на сайт. Вы делитесь одной ссылкой повсюду и при этом получаете статистику кликов.

Часто задаваемые вопросы

Что такое схема URL tg://?

tg:// — это схема, которую регистрирует приложение Telegram. tg://resolve?domain=NAME открывает канал, группу, пользователя или бота; tg://join?invite=CODE открывает приватное приглашение.

Можно ли передать параметр start боту Telegram?

Да: tg://resolve?domain=BOTNAME&start=PAYLOAD. Пейлоуд может содержать буквы, цифры, нижние подчеркивания и дефисы.

Что произойдет, если приложение Telegram не установлено?

Простая схема URL не работает: iOS показывает ошибку и ничего не открывается. Всегда используйте её вместе с веб-резервом — на Android с S.browser_fallback_url в интенте, или используйте умную ссылку DSLink, которая автоматически обращается к веб-странице в случае необходимости.