Инструкции

QR-код на Telegram-бота: чтобы скан запускал нужный сценарий

Как сделать QR-код на Telegram-бота, чтобы скан запускал нужный сценарий: ссылка с меткой start, короткая ссылка с учётом сканов, печать и проверка.

Команда ЭТОЧАТБОТА · · 10 мин чтения

QR-код на Telegram-бота — это картинка, внутри которой записана ссылка на бота. Чтобы скан запускал нужный сценарий, в код кладут не голый адрес t.me/имя_бота, а ссылку с меткой: t.me/имя_бота?start=kafe. Бот получает метку и запускает сценарий, собранный под неё. А если нужно ещё и видеть, сколько людей отсканировали код и сколько из них написали боту, подойдёт короткая ссылка с учётом переходов: QR-код к ней скачивается одной кнопкой. Разберём оба способа, а заодно — как напечатать код, чтобы его сканировали, и как отличить сканы от других переходов.

Что внутри QR-кода и почему голой ссылки мало

QR-код ничего не умеет сам. Камера телефона распознаёт записанный в нём адрес и предлагает его открыть — дальше всё решает ссылка. Если внутри обычный адрес бота, человек попадёт в бота, нажмёт «Старт» и получит общее приветствие. Для таблички на кассе этого часто мало:

  • Бот не знает, откуда человек. Пришёл он с наклейки на упаковке, из канала или по совету друга — для бота это одинаковый «Старт».
  • Нельзя ответить по месту. Гостю за столиком нужно меню, покупателю коробки — инструкция, посетителю выставки — каталог. С одной голой ссылкой все получают одно и то же.
  • Нечего считать. Telegram не сообщает, сколько людей открыли ссылку. Окупилась ли печать тиража, по такому коду не понять.

QR-код, который можно сделать в самом приложении Telegram, тоже ведёт на обычный адрес — без метки и без выбора сценария.

Короткая ссылка на бота

Переходы, «пришли в бота» и QR-код.

Сделать короткую ссылку

Способ 1. Бесплатно: QR-код на ссылку с параметром start

У Telegram есть встроенный механизм для таких случаев — параметр запуска. Формула ссылки:

https://t.me/имя_бота?start=метка

Метка — латиница, цифры, «_» и «-», до 64 знаков. Пробелы и кириллица не подойдут. Когда человек открывает такую ссылку и нажимает «Старт», бот получает метку и может по ней выбрать ответ. Это работает и для новых людей, и для тех, кто уже переписывался с ботом: Telegram снова показывает кнопку запуска, нажатие передаёт метку.

Как настроить в ЭТОЧАТБОТЕ

  1. Откройте сценарий, который должен запускаться со скана, и нажмите на блок «Старт».
  2. Нажмите «Ссылка на сценарий» — появится запуск «Старт с параметром» и готовая ссылка с кнопкой «Скопировать». Метку можно заменить на свою, например stol или korobka.
  3. Сценарий сработает, только если метка в ссылке совпала полностью. Её значение доступно в текстах и условиях как {{var.start_param}} — например, чтобы написать «Вы с выставки — держите каталог».
  4. Скопированную ссылку превратите в QR-код любым генератором.

Метки, которые начинаются с «ck-», заняты кодовым словом в комментариях — свои ссылки так не называйте. Для бота в МАКС формула та же: max.ru/имя_бота?start=метка.

Сценарий Telegram-бота с запуском «Старт с параметром» и готовой ссылкой для QR-кода
«Ссылка на сценарий» сама добавляет запуск по метке и показывает адрес для QR-кода. Скриншот кабинета ЭТОЧАТБОТА.

Ограничение у этого способа одно, но важное: переходов не видно. Вы узнаете только о тех, кто нажал «Старт» и попал в сценарий. Сколько людей отсканировали код и закрыли Telegram, не нажав кнопку, — неизвестно.

Способ 2. Короткая ссылка: QR-код на Telegram-бота и учёт сканов

В ЭТОЧАТБОТЕ есть раздел «Короткие ссылки». Ссылка вида etochatbot.link/k7m ведёт в бота вашего аккаунта, по пути засчитывает переход и старается сразу открыть приложение. QR-код к ней уже готов, а адрес не меняется — для печати это и нужно. Как сделать:

  1. В меню аккаунта откройте «Страницы» → «Короткие ссылки» → «Создать ссылку».
  2. Название — для себя, чтобы не путать ссылки: «Кафе — стол у окна», «Упаковка — инструкция».
  3. Куда ведёт — в бота этого аккаунта.
  4. «Открывать сразу в приложении» — оставьте включённым: человек попадёт прямо в Telegram, а не на страницу t.me в браузере.
  5. «Когда человек придёт в бота» — обычный старт или сценарий, и с какого шага его начать. Например, сразу с шага, где бот присылает меню.
  6. «Не запускать повторно» — если человек отсканирует код второй раз, сценарий не начнётся заново, пока не пройдёт заданное время.
  7. «Метка контакту» — например, kafe. Она останется в карточке, по ней потом удобно сделать рассылку только тем, кто пришёл из зала.
  8. Нажмите «Создать ссылку» — короткий адрес и QR-код появятся сразу.
Форма «Новая ссылка» для QR-кода на Telegram-бота: куда ведёт, сценарий и метка
Новая ссылка: куда ведёт, что сделает бот и какую метку поставить. Скриншот кабинета ЭТОЧАТБОТА.

После создания откроется экран «Ссылка готова»: адрес крупно, кнопка «Скопировать» и QR-код. Кнопка «Скачать QR-код» сохраняет его картинкой PNG 1024 × 1024 пикселя — тёмный код на белом фоне, с белым полем по краям. Та же кнопка есть в настройках ссылки.

Экран «Ссылка готова»: короткая ссылка на Telegram-бота и её QR-код для печати
QR-код появляется сразу после создания ссылки. Скриншот кабинета ЭТОЧАТБОТА.

Одна тонкость. В короткой ссылке параметр start занят служебной меткой, по которой сервис узнаёт переход. Поэтому сценарий для неё выбирают в настройках самой ссылки, а не запуском «Старт с параметром».

Свой QR-код на каждую точку

Главная польза QR-кода со сценарием — разный ответ для разных мест. Сделайте по ссылке на каждую точку: у каждой будет своё название, свой сценарий, своя метка и свои цифры.

Где висит QR-кодЧто сделает бот после скана
Стол или стойка в кафеПришлёт меню и акцию дня
Упаковка товараДаст инструкцию и попросит оставить отзыв
ВизиткаРасскажет о вас и предложит записаться
Стенд на выставкеОтправит каталог и спросит, что интересно
Листовка у партнёраВыдаст промокод для новых клиентов

То, что стоит за ссылкой, можно поменять в любой момент: в настройках ссылки — выбрать другой сценарий, шаг или метку, а тексты ответов — в самом сценарии. QR-код при этом остаётся тем же, перепечатывать ничего не нужно.

Как напечатать QR-код, чтобы его сканировали

  • Размер. На визитке и наклейке — не меньше 2 × 2 см. Для плаката работает простое правило: расстояние, с которого сканируют, примерно в 10 раз больше стороны кода.
  • Без лишних меток. Чем короче ссылка, тем меньше в коде квадратиков и тем лучше он читается в маленьком размере. Длинная ссылка с несколькими метками даёт мелкий и плотный рисунок.
  • Контраст. Тёмный код на светлом фоне. Не перекрашивайте в бледные цвета, не кладите на пёструю фотографию и не обрезайте белое поле вокруг — по нему камера находит код.
  • Подпись. Под кодом напишите, что человек получит: «Наведите камеру — пришлём меню в Telegram». Без объяснения непонятно, зачем сканировать.
  • Проверка до тиража. Отсканируйте пробный отпечаток обычной камерой на iPhone и на Android, при том свете, где он будет висеть.

И о сроке жизни. Если у аккаунта закончится тариф, ссылка встанет на паузу: по коду откроется «Ссылка временно не работает». Адрес, настройки и статистика сохранятся, и после оплаты ссылка сразу заработает — напечатанные коды выбрасывать не придётся.

Что увидит человек после скана

Камера открывает ссылку в браузере телефона. Если включено «Открывать сразу в приложении», появится страница «Открываем Telegram…» и попробует открыть приложение с вашим ботом. Не получилось — страница откроет веб-версию. Язык страницы — как в вашем кабинете.

Страница «Открываем Telegram…» после сканирования QR-кода на телефоне
После скана страница пробует открыть приложение, а не оставляет человека на t.me в браузере. Скриншот страницы ЭТОЧАТБОТА.

Дальше всё как обычно: человек нажимает «Старт», бот запускает сценарий, выбранный в ссылке, ставит метку. В переписке появляется строка «Пришёл по ссылке «Кафе — стол у окна»» — так и вы, и ваши операторы видят, откуда этот человек.

Как посчитать сканы QR-кода

Каждый скан — это переход по ссылке. В статистике ссылки видно:

  • путь «Перешли по ссылке → Открылось приложение → Написали боту»;
  • переходы и людей по дням — за 7, 30 или 90 дней;
  • с телефона или с компьютера, какие системы и браузеры;
  • где открывали — страны и города. Удобно, если коды висят в разных городах.

Людьми считаются разные устройства. Превью мессенджеров и поисковые роботы в цифры не попадают.

Статистика короткой ссылки с QR-кода: перешли, открылось приложение, написали боту
Путь от перехода до бота и переходы по дням. Скриншот кабинета ЭТОЧАТБОТА на демо-данных.

Отдельного счётчика «сканы» нет. Камера не сообщает, откуда открыта ссылка, поэтому в источниках такие переходы попадают в строку «Напрямую или из приложения» — вместе с теми, кто нажал ссылку, например, в Telegram. Чтобы точно знать число сканов, дайте QR-коду свою ссылку и не ставьте её больше никуда. Тогда все её переходы — это сканы.

Где открывали ссылку из QR-кода: города, системы, браузеры и приложения
Города, системы и браузеры — для каждой ссылки отдельно. Скриншот кабинета ЭТОЧАТБОТА на демо-данных.

Когда нужен QR-код не на бота, а на страницу

Если человеку нужно выбрать мессенджер — одним удобнее Telegram, другим МАКС или ВКонтакте, — ставьте QR-код на страницу с кнопками. У мультиссылки QR-код тоже скачивается из кабинета, а кнопки ведут в ваших ботов. Как её собрать — в статье «Как сделать мультиссылку». Если же нужен один путь — сразу в Telegram-бота и в нужный сценарий, — достаточно QR-кода на ссылку: на страницу с выбором человеку пришлось бы сделать лишнее нажатие.

Частые вопросы

Можно сделать QR-код на Telegram-бота бесплатно?

Да. Соберите ссылку t.me/имя_бота?start=метка и сделайте из неё QR-код любым генератором. Сценарий под метку настраивается запуском «Старт с параметром». Учёт переходов и QR-код в кабинете — в разделе «Короткие ссылки», он работает на тарифах «Плюс» и «Премиум»; подробности — на странице тарифов.

Видно, сколько людей отсканировали код?

У короткой ссылки — да: каждый скан засчитывается как переход, а в пути видно, сколько из этих людей написали боту. У обычной ссылки t.me с меткой — нет, видно только тех, кто дошёл до сценария.

Можно поменять, куда ведёт QR-код, после печати?

Сценарий, шаг и метку — да, в настройках ссылки, код остаётся прежним. Сам адрес не меняется. Ссылку можно перенести в другой ваш оплаченный аккаунт — тогда она поведёт в его бота, а сценарий нужно будет выбрать заново.

Работает ли это для МАКС, ВКонтакте и Instagram*?

Короткая ссылка ведёт в бота любого из этих каналов. В МАКС сценарий запускается так же, по «Старт». Во ВКонтакте — когда человек напишет в сообщения сообщества, в Instagram* — когда напишет в Директ первым. Бесплатная формула с параметром start подходит для Telegram и МАКС.

Человек отсканировал код, но сценарий не запустился. Почему?

Чаще всего он не нажал «Старт» в боте. Ещё бывает, что сработало «Не запускать повторно»: человек уже приходил по этой ссылке недавно. А у ссылки t.me с меткой сценарий не запустится, если метка в коде и в запуске «Старт с параметром» отличается хотя бы одним знаком.

Подойдёт ли QR-код для рекламы в печати и на улице?

Да, но делайте отдельную ссылку на каждый носитель: листовки, наружную рекламу, журнал. Тогда в статистике будет видно, какой из них приводит людей в бота, а метка в карточке покажет, откуда пришёл каждый. Про метки для онлайн-рекламы — в статье «Реклама Telegram-бота».

Короткая ссылка на вашего бота

Ведёт в бота Telegram, МАКС, ВКонтакте или Instagram*, запускает нужный сценарий и показывает, сколько людей перешло и сколько дошло. QR-код — одной кнопкой. Работает на «Плюсе» и «Премиуме».

Сделать короткую ссылку

Уже пользуетесь другим сервисом?

Перенесём ваши автоматизации бесплатно и подарим тариф на 1 месяц 🤗

Все статьи
Поделиться: