Telegram Deep Link
HTTPS-ссылка на Telegram через t.me, открывающая профиль, канал, чат или бота непосредственно в приложении. Форматы: t.me/username (публичный), t.me/+hash (приватная группа), t.me/botname?start=payload (бот). Основной тип данных QR-кода для Telegram.
Что такое Telegram Deep Link
Telegram Deep Link — HTTPS-ссылка через домен t.me, которая ведёт прямо в конкретный чат, канал, профиль или бота мессенджера Telegram. В отличие от обычных URL, такая ссылка при открытии с устройства, где установлен Telegram, запускает приложение и переходит по нужному адресу. Если Telegram не установлен — открывается веб-версия web.telegram.org.
Для QR-кодов это ключевой формат: наведи камеру, и пользователь сразу попадает в нужный канал. Никакого ручного поиска по имени канала, никакого ввода ссылки. Telegram Deep Link используют в рекламных листовках, на витринах магазинов, на упаковке товаров, в офисах и на мероприятиях.
Форматы Telegram Deep Link
Telegram поддерживает несколько форматов ссылок в зависимости от назначения:
| Формат | Назначение | Пример |
|---|---|---|
t.me/username | Публичный канал, группа, профиль пользователя, бот | t.me/durov |
t.me/+HASH | Приглашение в приватную группу или канал | t.me/+AbCdEfGhIjKl |
t.me/joinchat/HASH | Устаревший формат приглашений (работает, но не рекомендован) | t.me/joinchat/AAAAAAbCdEfGh |
t.me/botname?start=PAYLOAD | Запуск бота с передачей payload для deep linking в боте | t.me/mybot?start=ref123 |
t.me/share/url?url=...&text=... | Шаринг URL через Telegram | t.me/share/url?url=https://example.com |
t.me/+PHONE | Открыть чат с номером телефона (если пользователь найден) | t.me/+79161234567 |
Самый распространённый случай для QR: t.me/имя_канала для публичного канала и t.me/+хэш для приватной группы. Последний формат — единственный способ пригласить людей в приватный чат через QR без раскрытия юзернейма.
Telegram Deep Link vs нативный URI tg://
Помимо t.me-ссылок, Telegram поддерживает нативные URI вида tg://resolve?domain=username. Разница принципиальная:
- t.me/username — универсальная ссылка (Universal Link на iOS, App Link на Android). Открывается в браузере → перехватывается системой → запускается приложение Telegram. Если приложения нет — открывается
web.telegram.org. Работает везде. - tg://resolve?domain=username — нативный URI-схема. Открывается только если Telegram установлен. Если нет — браузер показывает ошибку «не удалось открыть страницу». Для QR не подходит, если часть аудитории может не иметь Telegram.
Для QR-кодов всегда используйте t.me/..., а не tg://.... Это особенно важно для публичных QR — в кафе, на выставке, на улице — где нет уверенности, что у всех установлен Telegram. Подробнее о форматах URI — в статье о deep link.
Применение в QR-кодах
Типичные сценарии использования Telegram Deep Link в QR:
- Канал магазина или сервиса: QR на кассе, витрине или упаковке → подписка на канал с акциями. Один скан — клиент в базе рассылки.
- Чат-бот:
t.me/support_bot?start=store42— QR в конкретном магазине передаёт ID магазина боту, тот автоматически определяет источник обращения. - Приватная группа: QR на мероприятии открывает закрытый чат участников. Хэш инвайта Telegram можно сбросить в любой момент, если ссылка стала публичной.
- Donation / оплата: Telegram позволяет принимать звёзды через бота — QR ведёт напрямую к форме оплаты.
Для отслеживания источников переходов используйте динамический QR: URL внутри кода можно менять без перепечатки, а статистика сканирований помогает понять, с каких носителей приходят подписчики.
Частые вопросы
Чем t.me/username отличается от telegram.me/username?
telegram.me — старый домен Telegram, работавший до 2015 года. Сейчас он перенаправляет на t.me через 301-редирект. Оба варианта работают, но t.me — официальный короткий домен. Для QR-кода используйте t.me: URL короче, что уменьшает сложность QR и снижает версию кода.
Как долго действует ссылка t.me/+hash для приватной группы?
Ссылки-приглашения (t.me/+hash) по умолчанию бессрочны, но администратор может их отозвать в любой момент в настройках группы. Также Telegram автоматически деактивирует ссылки при превышении лимита использований (если задан) или при изменении режима группы. Если выдаёте QR с инвайтом на массовое мероприятие — создайте отдельную ссылку с лимитом, чтобы контролировать приток.
Что такое ?start= параметр для Telegram-бота?
Параметр ?start=payload передаёт до 64 символов произвольных данных при первом запуске бота. Бот получает их в сообщении /start payload. Это стандартный способ отслеживания источников: разные QR-коды в разных местах передают разный payload, и бот видит, откуда пришёл пользователь. Например, t.me/shop_bot?start=flyer_msk — пользователь пришёл с московской листовки.
Как открывается t.me-ссылка если Telegram не установлен?
При открытии t.me/username в браузере без Telegram браузер переходит на web.telegram.org/k/#@username — веб-версию мессенджера. Пользователь может войти через SMS-авторизацию прямо в браузере. Это важное отличие от tg:// — нативная схема просто показывает ошибку, веб-фолбэка нет. Для публичных QR это критично: часть аудитории использует Telegram в браузере или только планирует установить приложение.
Можно ли в один QR вписать ссылку и для Telegram, и для WhatsApp?
В один статический QR — нет, он хранит одну ссылку. Решение — smart routing в динамическом QR: один QR определяет устройство и ОС, и перенаправляет iOS-пользователей на t.me/channel, Android — туда же или на другой ресурс. Другой вариант — ссылка-агрегатор (Linktree, ISOC.bio и аналоги) с кнопками «Telegram», «WhatsApp», «VK»: пользователь сам выбирает мессенджер.