Формати посилань Telegram
Кожен рядок показує звичайне веб-посилання, схему URL для iPhone та форму для Android. Замініть великі заповнювачі на реальні значення.
| Контент | Веб-посилання | iPhone (схема URL) | Android |
|---|---|---|---|
| Канал, група або користувач | https://t.me/USERNAME | tg://resolve?domain=USERNAME | intent://t.me/USERNAME#Intent;package=org.telegram.messenger;scheme=https;end |
| Конкретна публікація | https://t.me/CHANNEL/123 | tg://resolve?domain=CHANNEL&post=123 | intent://t.me/CHANNEL/123#Intent;package=org.telegram.messenger;scheme=https;end |
| Бот із стартовим параметром | https://t.me/BOTNAME?start=PAYLOAD | tg://resolve?domain=BOTNAME&start=PAYLOAD | intent://t.me/BOTNAME?start=PAYLOAD#Intent;package=org.telegram.messenger;scheme=https;end |
| Приватне запрошення | https://t.me/+INVITE_CODE | tg://join?invite=INVITE_CODE | intent://t.me/+INVITE_CODE#Intent;package=org.telegram.messenger;scheme=https;end |
tg:// пропускає веб-сторінку t.me, яка просить відвідувачів натиснути «Відкрити в Telegram».
Більшість програм офіційно не документують свої схеми 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, якщо додаток відсутній, і відправляє десктопних відвідувачів прямо на сайт. Ви ділитеся одним посиланням скрізь і отримуєте статистику кліків зверху.
Часті запитання
Яка схема tg:// URL?
tg:// — це схема, яку реєструє додаток Telegram. tg://resolve?domain=NAME відкриває канал, групу, користувача або бота; tg://join?invite=CODE відкриває приватне запрошення.
Чи можна передати параметр start боту Telegram?
Так: tg://resolve?domain=BOTNAME&start=PAYLOAD. Дані payload можуть містити літери, цифри, підкреслення та дефіси.
Що станеться, якщо додаток Telegram не встановлений?
Схема простої URL-адреси не працює: iOS показує помилку, і нічого не відкривається. Завжди поєднуйте його з резервним веб-сайтом — на Android із S.browser_fallback_url у намірі або використовуйте смарт-посилання DSLink, яке автоматично повертається до веб-сторінки.