Formaty linków Telegram
Każdy wiersz pokazuje normalny link internetowy, schemat URL iPhone'a oraz formularz Androida. Zamień wielkie litery na rzeczywiste wartości.
| Treść | Link do strony internetowej | iPhone (schemat URL) | Androida |
|---|---|---|---|
| Kanał, grupa lub użytkownik | https://t.me/USERNAME | tg://resolve?domain=USERNAME | intent://t.me/USERNAME#Intent;package=org.telegram.messenger;scheme=https;end |
| Konkretna wiadomość | https://t.me/CHANNEL/123 | tg://resolve?domain=CHANNEL&post=123 | intent://t.me/CHANNEL/123#Intent;package=org.telegram.messenger;scheme=https;end |
| Bot z parametrem start | 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 |
| Prywatne zaproszenie | https://t.me/+INVITE_CODE | tg://join?invite=INVITE_CODE | intent://t.me/+INVITE_CODE#Intent;package=org.telegram.messenger;scheme=https;end |
tg:// pomija stronę internetową t.me, która prosi odwiedzających o kliknięcie „Otwórz w Telegramie”.
Większość aplikacji nie dokumentuje oficjalnie swoich schematów adresów URL. Poniższe formaty to formaty, których DSLink używa obecnie w środowisku produkcyjnym, ale aktualizacja aplikacji może je zmienić — przetestuj na prawdziwym urządzeniu, zanim zakodujesz schemat we własnej aplikacji lub witrynie.
Korzystanie ze schematu na stronie internetowej
Schemat adresu URL może przejść bezpośrednio do łącza. Na iPhonie Safari prosi odwiedzającego o potwierdzenie przed przełączeniem aplikacji:
<a href="tg://resolve?domain=USERNAME">Open in Telegram</a>W systemie Android możesz dodać rezerwową wersję internetową do samej intencji. Jeśli brakuje aplikacji, Chrome otwiera zastępczy adres URL, zamiast kończyć się niepowodzeniem:
intent://t.me/USERNAME#Intent;package=org.telegram.messenger;scheme=https;S.browser_fallback_url=https%3A%2F%2Ft.me%2FUSERNAME;endWszędzie obowiązują dwa ograniczenia. Jeśli aplikacja nie jest zainstalowana, sam schemat nie robi nic przydatnego — iOS wyświetla błąd. Przeglądarki wbudowane w aplikacje takie jak Instagram, TikTok czy X często blokują lub ignorują niestandardowe schematy, czyli dokładnie tam, gdzie klikana jest większość linków.
Alternatywa bez kodu: inteligentne łącze
Inteligentny link DSLink łączy to wszystko w jednym krótkim URL. Na telefonie wybiera odpowiedni format aplikacji dla urządzenia, w razie braku aplikacji przekierowuje na stronę Telegram, a użytkowników desktopowych kieruje bezpośrednio na stronę internetową. Możesz udostępnić jeden link wszędzie i dodatkowo uzyskać statystyki kliknięć.
Często zadawane pytania
Co to jest schemat URL tg://?
tg:// to schemat, który rejestruje aplikacja Telegram. tg://resolve?domain=NAME otwiera kanał, grupę, użytkownika lub bota; tg://join?invite=CODE otwiera prywatne zaproszenie.
Czy mogę przekazać parametr start do bota Telegram?
Tak: tg://resolve?domain=BOTNAME&start=PAYLOAD. Dane (payload) mogą zawierać litery, cyfry, podkreślenia i myślniki.
Co się stanie, jeśli aplikacja Telegram nie jest zainstalowana?
Schemat czystego adresu URL kończy się niepowodzeniem: iOS wyświetla błąd i nic się nie otwiera. Zawsze łącz go z rezerwowym łączem internetowym — na Androidzie z zamierzeniem S.browser_fallback_url lub użyj inteligentnego łącza DSLink, które automatycznie powraca do strony internetowej.