Справочный центр

Три вещи перед началом:

1. Token Telegram-бота. Получите его, написав @BotFather в Telegram, отправив /newbot и следуя шагам. Скопируйте выданный token.
2. ID чата вашей Telegram-группы. Добавьте бота в группу, сделайте администратором, затем после генерации используйте /id, чтобы убедиться, что ID совпадает с .env.
3. Установленный Node.js на компьютере (или сервере). Скачайте версию LTS с nodejs.org.

Сгенерируйте бота с выбранной возможностью ID Command. Добавьте его в группу, запустите и введите /id в группе. Показанный Chat ID - это значение для .env как GROUP_ID_1.

ID чатов супергрупп всегда начинаются с -100. Если группа недавно преобразована из обычной, ID изменился. Команда /id всегда показывает текущий правильный ID.

Откройте вашу Telegram-группу, нажмите на название вверху, перейдите в «Администраторы», нажмите «Добавить администратора», найдите бота и включите как минимум: «Удаление сообщений» и «Блокировка пользователей». Без этих прав команды модерации будут молча не срабатывать.

По умолчанию Telegram-боты видят только сообщения, начинающиеся с /. Отключение режима приватности позволяет боту читать все сообщения, что нужно для таких возможностей, как фильтр слов, анти-спам, анти-ссылки, авто-ответы и учёт XP.

Чтобы отключить: напишите @BotFather, отправьте /setprivacy, выберите бота, нажмите Disable.

Пройдите этот чек-лист по порядку:

1. Бот добавлен в вашу группу.
2. Бот является администратором с правами «Удаление сообщений» и «Блокировка пользователей».
3. Режим приватности отключён через @BotFather (/setprivacy → Disable).
4. GROUP_ID_1 в вашем .env совпадает с ID из /id в группе. Они должны быть идентичны, включая знак минус.
5. Окно бота всё ещё открыто и показывает стартовое сообщение.
6. Вы выполнили «Step 3 - Register Commands», чтобы команды появились в меню.

Команды зарегистрированы, но бот не запущен или работает с неверным ID группы. Убедитесь, что бот запущен (окно лаунчера открыто и показывает стартовое сообщение) и что GROUP_ID_1 указан верно.

Разрешение @упоминания работает только для тех, кто отправил хотя бы одно сообщение в группе с момента запуска бота. Для тех, кто ещё не писал, всегда отвечайте на одно из их сообщений вместо @упоминания. Бот узнаёт username по мере общения людей.

ID группы в вашем .env не совпадает с реальной группой. Используйте /id в группе, чтобы получить правильный ID, обновите GROUP_ID_1 в .env и перезапустите бота.

Так и должно быть. Бот работает, только пока открыто окно лаунчера. Чтобы он работал постоянно, разместите его на сервере. Файл Advanced - Hosting Guide.md внутри папки бота описывает бесплатные варианты, включая Railway и Render.

Убедитесь, что используете Node.js 18 или выше. Лаунчер проверяет это автоматически. Если видите конкретную ошибку, пришлите полный вывод консоли (включая текст ошибки и строки выше) на support@tgbotforge.com вместе с файлом bot.log.

В крупных супергруппах Telegram иногда скрывает ботов из видимого списка участников, даже если они есть. Попробуйте отправить команду напрямую. Если бот отвечает, значит он работает.

Ключ лицензии - это персональный код, открывающий возможности Growth или Pro в мастере. Вы получаете его в письме с чеком от Dodo Payments сразу после оплаты. Введите его на шаге 1 или шаге 4 мастера.

Каждый платный ключ допускает до 3 генераций бота всего. Это пожизненный лимит, а не дневной. Дополнительные генерации рассматриваются поддержкой индивидуально и не гарантированы. Если вам регулярно нужно больше 3 генераций, стандартный путь - покупка нового ключа.

Напишите на support@tgbotforge.com. Мы рассматриваем запросы индивидуально. Дополнительные генерации не гарантированы и зависят от обстоятельств. Стандартный вариант - покупка нового ключа.

Ваш существующий бот продолжит работать. Код принадлежит вам, в нём нет «звонков домой» и удалённого отключения. Вы лишь не сможете генерировать новых ботов истёкшим ключом. Продление подписки восстанавливает доступ к генерации.

Да. Подписчики Pro получают высший приоритет в очереди поддержки. Запросы Growth и Starter обрабатываются по мере возможности после тикетов Pro.

Все продажи окончательны после генерации бота или выдачи ключа лицензии - в силу цифровой природы продукта. Если возникла проблема до генерации, напишите на support@tgbotforge.com, и мы поможем её решить.

Нет. Ключи персональны и не передаются. Передача ключа нарушает Условия использования и приведёт к отзыву ключа без возврата средств.

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

Если что-то работает не так на неизменённом боте, обратитесь в поддержку, и мы поможем. Если вы изменяли код, мы можем попросить сгенерировать чистую версию перед разбором.

Вы можете использовать сгенерированного бота для управления собственными Telegram-сообществами, включая связанные с бизнесом. Вы не вправе перепродавать, распространять или переупаковывать сгенерированный код как собственный продукт.

Доска отзывов на tgbotforge.com/feedback - это публичная доска предложений, где любой может предлагать функции или идеи и голосовать за существующие. Аккаунт не нужен.

Да. Ваш IP-адрес хешируется с SHA-256 перед сохранением - исходный IP никогда не сохраняется. По желанию можно добавить Telegram-username к предложению, но это полностью необязательно и нужно лишь для публичного отображения, чтобы при необходимости связаться.

Можно отправлять до 2 предложений в день с одного IP-адреса. Этот лимит существует для защиты от спама.

Каждый IP-адрес получает один голос на предложение. Можно проголосовать за или против. Повторное нажатие той же кнопки снимает голос. Нажатие противоположной меняет направление. Итоговый счёт (голоса за минус против) определяет сортировку по умолчанию.

Да. Мы регулярно просматриваем предложения и обновляем статус каждого на один из: «На рассмотрении», «Запланировано», «В работе», «Готово» или «Отклонено». Предложения с высоким счётом имеют наибольший шанс на приоритет.

Предложения нельзя удалить самостоятельно, так как они анонимны. Если нужно убрать предложение, напишите на support@tgbotforge.com с текстом предложения, и мы его удалим.