Telegram-бот клуба за 5 минут — пошаговая инструкция

Telegram-бот клуба под собственным брендом — это не разработка за 200 тысяч от подрядчика на месяц. letscourt даёт готовый бот, который ты подключаешь к своему клубу через токен от @BotFather. Mini App с онлайн-бронью корта, связь с админом, оплата ЮKassa внутри мессенджера. Реально 5 минут с нуля.

Шаг 1. Создать бота в @BotFather

Открываете Telegram. В поиске вводите @BotFather. Это официальный бот Telegram для управления другими ботами — самый старый и проверенный.

Пишете команду:

/newbot

Бот спросит:

• Name — имя видимое клиенту, например «La Familia Tennis Club»
• Username — должен заканчиваться на _bot, например la_familia_club_bot. Если занят — попробуйте варианты.

BotFather пришлёт сообщение с токеном:

Use this token to access the HTTP API:
123456789:AABBCCdd_EeFfGgHhIiJjKkLlMmNnOo

Keep your token secure and store it safely

Скопируйте токен. Никому не показывайте — это credential бота.

Шаг 2. Подключить токен в letscourt

В админке letscourt → меню «Ещё → Telegram-бот» → жмёте «Подключить бота» → вставляете токен → кнопка «Подключить».

letscourt в этот момент:

1. Делает запрос getMe к Telegram API — проверяет, что токен валидный, забирает username и user_id бота
2. Регистрирует webhook на https://letscourt.ru/api/telegram/webhook/<bot_id> с секретом
3. Сохраняет конфигурацию в БД

Через 2-3 секунды видите «✓ Бот подключён» с username. Уже работает — бот отвечает на /start.

Шаг 3. (Опционально) Брендирование бота

В @BotFather можно настроить вид бота:

• /setuserpic — загрузить логотип клуба (квадрат, минимум 512×512)
• /setdescription — описание которое видит клиент при первом открытии бота. Например: «Бронирование кортов La Familia. 6 кортов indoor, открыты 7-23 ежедневно.»
• /setabouttext — короткий «about» текст в шапке бота
• /setcommands — список команд для меню. Например: /start - Главное меню

Это нужно один раз — потом бот выглядит профессионально.

Шаг 4. Что увидит клиент

Клиент находит бота по username (поиск Telegram), жмёт «Запустить» / /start. Появляется приветственное меню:

«🎾 Забронировать корт» открывает Mini App с тем же UI что на вашем сайте — сетка кортов, выбор времени, длительность 1-4 часа, оплата через ЮKassa. Не выходит из Telegram.

Шаг 5. Привязка админ-чата

Чтобы клиенты могли «связаться с админом» через бот — нужно привязать чат куда будут пересылаться сообщения.

В админке letscourt → Telegram-бот → «Сгенерировать ссылку для админ-чата». Получаете одноразовую ссылку вида https://t.me/la_familia_club_bot?start=admin_xxxxxx — действительна 60 минут.

Открываете эту ссылку в Telegram-аккаунте админа (или в групповом чате через бот) → бот фиксирует chat_id → активирует пересылку.

Теперь, когда клиент нажимает «Связаться с админом» в боте и пишет сообщение — оно приходит в админский чат с подписью «От Лебедевой М. (@lebedeva), chat_id=12345». Админ отвечает в этом же чате — letscourt пересылает обратно клиенту.

Команды в админ-чате

• /off — приостановить пересылку (если занят и не хочется отвлекаться)
• /on — возобновить пересылку

Что дальше

На этом базовая настройка закончена. Клиенты могут:

• Находить бот по username
• Бронировать корт через Mini App
• Видеть свои брони с обновлением статуса оплаты
• Связываться с админом одним сообщением

Дальше — рекламируете бот клиентам: на сайте, в инстаграме клуба, в WhatsApp-чатах постоянных клиентов («теперь можно бронировать через @la_familia_club_bot, удобнее»). Через 1-2 месяца 30-50% броней пойдёт через бот.