Создание бота в @BotFather
Как с нуля создать основного бота и бота поддержки, оформить их, подключить Mini App и узнать свой Telegram ID. Что вставить в Reefox Panel и как проверить.
Через основного бота клиенты открывают кабинет (Mini App), получают напоминания и пишут в поддержку. Через него же Reefox Panel присылает вам коды входа в админку и уведомления. Бота создаёт служебный бот Telegram — @BotFather. Это бесплатно и занимает 10–15 минут.
Справочник по самой вкладке админки — Настройки → Telegram бот.
Что понадобится
- Аккаунт Telegram. Им вы будете управлять ботом, на него будут приходить коды входа в админку. Лучше личный аккаунт, к которому у вас точно не пропадёт доступ.
- Домен, на который ставится Reefox Panel. Он нужен для Mini App.
- Картинка 640×360 для Mini App и квадратная картинка для аватара бота (по желанию).
Шаг 1. Создайте основного бота
Откройте в Telegram @BotFather (у настоящего синяя галочка) и нажмите «Start».
Отправьте команду /newbot.
Введите имя бота — его клиенты видят в чате и в профиле, например Мой VPN. Имя можно поменять позже.
Введите username бота. Правила Telegram: от 5 до 32 символов, только латиница, цифры и подчёркивание, в конце обязательно bot, например my_vpn_bot или MyVpnBot. Username потом не поменять, выбирайте сразу.
BotFather пришлёт сообщение с токеном вида 1234567890:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw. Скопируйте его целиком и сохраните в менеджере паролей.
Токен — это ключ от бота
Кто знает токен, тот управляет ботом: читает сообщения клиентов и пишет от его имени. Не отправляйте токен в чаты и не выкладывайте на скриншотах. Если токен утёк — выпустите новый.
Один токен — одна программа
Reefox Panel получает сообщения бота постоянным опросом Telegram. Telegram отдаёт сообщения только одному получателю, поэтому токен не должен работать ещё где-то: в старом боте, конструкторе, другой панели. Лучше создать нового бота специально для Reefox Panel.
Шаг 2. Узнайте свой Telegram ID и нажмите Start
Telegram ID — число, например 123456789. На него Reefox Panel присылает коды входа, уведомления о платежах и сбоях, резервные копии.
Откройте бота @userinfobot и нажмите «Start». Он ответит сообщением, где есть ваш Id. Это и есть Telegram ID.
Откройте своего нового бота (по ссылке t.me/username_бота из сообщения BotFather) и нажмите «Start». Пока вы этого не сделали, бот не может вам писать: установщик не пройдёт проверку, а коды входа не придут.
Шаг 3. Оформите бота
Reefox Panel не меняет имя, описание и аватар бота — их задаёте вы в @BotFather. Все команды ниже по очереди спрашивают, какого бота менять: выберите его кнопкой.
| Команда | Что меняет | Где видно |
|---|---|---|
/setname | Имя бота | Заголовок чата, профиль, список чатов |
/setdescription | Описание, до 512 символов | В пустом чате до нажатия «Start», в блоке «Что умеет этот бот?» |
/setabouttext | Короткий текст «о боте», до 120 символов | В профиле бота и в превью ссылки на бота |
/setuserpic | Аватар бота | Везде, где виден бот. Отправьте квадратную картинку как фото |
Вместо команд можно отправить /mybots, выбрать бота и менять всё кнопками. В @BotFather есть и приложение с теми же настройками: кнопка «Open» в чате с ним.
Задайте имя до установки
Пока в админке не задано своё название сервиса, Reefox Panel при запуске берёт название из имени бота в @BotFather. Если сразу дать боту нормальное имя, клиенты не увидят заглушку «VPN». Позже название меняется в Настройки → Telegram бот (поле «Название бота») или на вкладке «Бренд».
Подсказки команд при вводе «/» задаются командой /setcommands, это необязательно — см. Бот и Mini App.
Шаг 4. Подключите Mini App
Mini App — это кабинет клиента внутри Telegram. Кнопку «Открыть» рядом с полем ввода бот ставит сам. Отдельное приложение в @BotFather нужно для прямой ссылки вида t.me/ваш_бот/app: по ней кабинет открывается сразу, без перехода в чат. Такие ссылки удобны в рекламе и в канале.
Делайте этот шаг после установки Reefox Panel, когда домен уже открывается по HTTPS.
Отправьте @BotFather команду /newapp и выберите своего основного бота. Приложение, созданное у другого бота, не пустит клиентов в кабинет.
Введите название приложения (например, название сервиса) и короткое описание.
Отправьте картинку 640×360 пикселей — её Telegram показывает в превью ссылки на приложение.
BotFather попросит демо-GIF. Его можно пропустить: BotFather подскажет, какой командой.
На вопрос о ссылке отправьте адрес кабинета:
https://ваш-домен/lk/Обязательно https:// и /lk/ в конце.
Придумайте short name — короткое имя латиницей, например app. Из него получится ссылка t.me/ваш_бот/app.
Теперь впишите short name в админку: Настройки → Telegram бот → Подключение, поле «Short name Mini App», кнопка «Сохранить подключение». Под полем появится прямая ссылка — откройте её с телефона.
Сменили домен — поменяйте адрес и в @BotFather
Кнопку меню бота Reefox Panel переключит на новый адрес сама, а адрес приложения из /newapp — нет. Отправьте @BotFather /myapps, выберите приложение и укажите новый адрес кабинета. Подробнее — Настройки → Сайт.
Шаг 5. Бот поддержки (по желанию)
Если хотите отвечать клиентам из админки (раздел «Чат поддержки») и подключить ИИ-поддержку, создайте второго бота:
Отправьте @BotFather /newbot ещё раз. Имя, например, Мой VPN — поддержка, username, например, my_vpn_support_bot.
Оформите его так же, как основного (шаг 3).
Скопируйте токен. Это должен быть другой бот: токен основного сюда не подходит.
Писать в бот поддержки могут только люди, которые уже запускали основного бота.
Если отдельный бот не нужен, в админке можно выбрать «Личный аккаунт» — кнопка «Поддержка» поведёт в ваш Telegram.
Куда вставить в Reefox Panel
Токен основного бота и ваш Telegram ID спрашивает установщик и сам записывает в базу. Остальное — в Настройки → Telegram бот → Подключение.
| Что | Откуда | Поле в админке |
|---|---|---|
| Токен основного бота | @BotFather, /newbot или /mybots → бот → API Token | «Токен бота» (и вопрос установщика) |
| Ваш Telegram ID | @userinfobot | «Telegram ID администратора» (и вопрос установщика) |
| Short name | @BotFather, /newapp | «Short name Mini App» |
| Токен бота поддержки | @BotFather, второй /newbot | «Токен бота поддержки», режим «Бот поддержки» |
| Ваш username для поддержки | Профиль Telegram | «Username аккаунта», режим «Личный аккаунт» |
После вставки нажмите «Сохранить подключение». Под полем токена появится «Подключён @имя_бота», при смене токена бот перезапустится сам.
Проверка
- С другого аккаунта отправьте боту
/start. Должно прийти приветствие с кнопками, рядом с полем ввода — кнопка «Открыть». - Кнопка «Открыть приложение» и ссылка
t.me/ваш_бот/appоткрывают кабинет. - Если подключили бота поддержки — напишите в него с другого аккаунта (после
/startу основного). Сообщение появится в админке в «Чате поддержки».
Чего не делать
Кнопку меню задавать не нужно
Не настраивайте кнопку меню в @BotFather (/setmenubutton или Bot Settings → Menu Button). Reefox Panel сама ставит кнопку «Открыть» с адресом кабинета при каждом запуске и обновляет её на каждый /start. Заданная вручную кнопка будет перезаписана.
- Не подключайте платежи в @BotFather (раздел Payments). Для оплаты звёздами Telegram Stars он не нужен, а СБП и карты Reefox Panel принимает через свои платёжные подключения.
- Не используйте токен бота в других сервисах одновременно с Reefox Panel — бот начнёт терять сообщения.
- Не удаляйте бота командой
/deletebot: username освободится, а клиенты потеряют чат с сервисом.
Отозвать токен
Если токен утёк или вы не уверены, кто его видел, выпустите новый. Старый перестанет работать сразу.
Сначала войдите в админку и не закрывайте вкладку. Пока токен не заменён, бот не работает и не сможет прислать код входа.
Отправьте @BotFather /revoke (или /token) и выберите бота. BotFather пришлёт новый токен.
Вставьте его в Настройки → Telegram бот → «Токен бота» и нажмите «Сохранить подключение». Бот перезапустится и снова начнёт отвечать.
Для бота поддержки — то же самое, поле «Токен бота поддержки». Если войти в админку уже не получается, замените токен прямо в базе по инструкции «Код из Telegram не приходит».
Частые ошибки
| Что видите | Причина | Что сделать |
|---|---|---|
| BotFather: username занят или не подходит | Такой username уже есть или нет bot в конце | Придумайте другой, проверьте окончание |
| Установщик: Telegram не узнал токен | Токен скопирован не целиком или с пробелом | Скопируйте заново: /mybots → бот → API Token |
| Установщик: бот не смог вам написать | Вы не нажали «Start» у своего бота или ошиблись в ID | Нажмите «Start» с аккаунта, чей ID указали |
Бот молчит после /start | Токен работает в другом сервисе или отозван | Выпустите новый токен и вставьте в админку |
Ссылка t.me/бот/app не открывает кабинет | Приложение создано у другого бота или адрес без /lk/ | Проверьте в /myapps бота и адрес |
| Коды входа не приходят | Неверный Telegram ID или не нажат «Start» | См. Код из Telegram не приходит |