Telegram Bot HandbookСсылки, открывающие Телеграм-бота
Обычные ссылки
Ссылки на ботов работают так же, как и ссылки на пользователей, группы и каналы: бота с юзернеймом @examplebot можно открыть по ссылке t.me/examplebot.
Также можно использовать прямую ссылку: tg://resolve?domain=examplebot
О ссылках tg://
Ссылки, начинающиеся на tg://, могут не только заменять ссылки t.me. Ссылка tg://settings, например, открывает настройки.
Списки таких ссылок есть в документации и в неофициальном канале @DeepLink.
Диплинки
Ссылка t.me/examplebot?start=ВАШ_ТЕКСТ называется диплинком. С её помощью пользователь может запустить бота с каким-то стартовым параметром.
Это работает так. Когда пользователь переходит по диплинку, у него открывается переписка с ботом и кнопка «Запустить» — даже если пользователь уже запускал бота. Кнопка «Запустить» отправляет команду /start ВАШ_ТЕКСТ. При этом пользователь увидит только /start, как при обычном запуске бота.
Часто диплинки используются для реферальных программ: например, в качестве параметра можно передавать ID пользователя, поделившегося ссылкой.
Такая же прямая ссылка: tg://resolve?domain=examplebot&start=ВАШ_ТЕКСТ
Диплинки для групп
Диплинки можно использовать не только для личных сообщений, но и для групп.
Ссылка t.me/examplebot?startgroup=ВАШ_ТЕКСТ откроет у пользователя меню с выбором группы для добавления бота. Когда пользователь добавит бота, сразу отправится команда /start ВАШ_ТЕКСТ.
Прямая ссылка: tg://resolve?domain=examplebot&startgroup=true