Telegram-бот и Mini App

Бот работает прямо в панели, отдельный сервер не нужен. Подписчики видят в нём тариф, устройства и инструкции, открывают страницу подписки как Mini App, получают напоминания и покупают доступ.

Подключить

1. Создайте бота у @BotFather командой /newbot и скопируйте токен.

2. В панели откройте Telegram → Подключение, вставьте токен и нажмите «Подключить». Панель проверит его у Telegram.

Mini App нужен настоящий сертификат

Telegram не откроет страницу с самоподписанным сертификатом. Mini App заработает, когда у панели будет сертификат Let’s Encrypt или свой, см. Домен и сертификаты.

Если Telegram заблокирован на сервере

Карточка Связь с Telegram на той же вкладке:

• Напрямую;
• Через ноду: удалённая нода панели передаёт только запросы к Telegram;
• Через прокси: SOCKS5 или HTTP(S). Пароль после сохранения не показывается.

Маршрут проверяется перед сохранением.

Что видит подписчик

• Экран подписки: срок, трафик, устройства, пулы. Если подписок несколько, между ними можно переключаться, до пяти на аккаунт.
• Устройства с отвязкой, раз в сутки.
• «Подключить устройство»: ссылка и приложения, кнопка страницы подписки в Mini App.
• Покупка и продление, «Докупить трафик», «Промокоды», «Попробовать бесплатно».
• «Убрать из бота»: удаляет только связь с Telegram. Подписка продолжает работать в приложениях и вернётся в бота, если снова прислать ему ссылку.

Подписка привязывается, когда человек присылает боту ссылку или нажимает «Открыть в Telegram» на странице подписки. Если подписка уже привязана к другому аккаунту, она переедет, только когда её владелец нажмёт «Разрешить», запрос живёт час. Бот принимает и старые ссылки пользователей, перенесённых из Marzban, PasarGuard или Remnawave.

Меню и тексты

Вкладка Меню и тексты: кнопки главного меню (подписка, устройства, подключение, продление, поддержка, Mini App и свои: ссылка или страница с текстом), до 20 кнопок, порядок стрелками. Тексты приветствия, продления и уведомлений, язык бота. Справа предпросмотр с примером данных.

Уведомления

Вкладка Уведомления: напоминания за 3 дня и за день до конца срока, при окончании, при 90% трафика и когда трафик кончился. Там же кнопка Mini App рядом с полем ввода, «Держать в чате одно меню» и «Ночью без звука» (с 22:00 до 9:00 по Москве).

Рассылка

Вкладка Рассылка отправляет текст всем, у кого подписка привязана к боту. Сообщения идут в пределах лимитов Telegram, прогресс виден в панели.

Пробный период

Платежи → Приём оплаты → Пробный период: выберите тариф со сроком, и бот в приветствии предложит его бесплатно. Пробный период выдаётся один раз на аккаунт Telegram, у которого нет подписки, оплат и прошлого пробного периода. Он работает, даже если продажа выключена.

Уведомления администратору и бэкапы в Telegram описаны в разделе Уведомления и мониторинг.