*сделано с помощью ИИ
✨ Основные функции
🛠️ Пошаговая инструкция по установке
📖 Использование и возможности панели
Для пользователей: Всё максимально просто. Пишут боту — создается тикет. Получают ответ прямо в чате с ботом.
Для администраторов в Telegram:
[💡] Что умеет WebApp Панель:
⚠️ Важные нюансы
🛠️ Стек технологий: Node.js (Telegraf, Express) + React 18 (Vite, Tailwind CSS) + Better-sqlite3
Скриншоты работы бота и панели смотрите ниже во вложении!
🟣 Telegram Support Bot 🟣
Современный бот для технической поддержки с WebApp-панелью администратора ✨ Основные функции
- 🪐 Создание тем: При первом обращении пользователя бот автоматически создаёт новую тему (форумный топик) в группе поддержки.
- 📂 Всеядность медиа: Поддерживает текст, фото, видео, документы, голосовые и аудио сообщения, стикеры в обе стороны.
- 💬 Удобный реплай: Администраторы могут отвечать пользователю, просто отправляя сообщения прямо в созданную тему.
- 🔒 Закрытие тикетов: Команда /close мгновенно закрывает тикет и уведомляет пользователя.
- 🖥️ WebApp-панель: Полная настройка и управление ботом через стильный веб-интерфейс (доступно только админу).
- ⚙️ Расширенный функционал:
- Полная кастомизация: Изменение любых текстовых ответов бота прямо из панели.
- Модерация: Блокировка и разблокировка неадекватных пользователей.
- Режим ТО: Включение технического обслуживания в один клик.
- Маркетинг: Массовая рассылка сообщений по всей базе пользователей.
- Быстрые ответы: Создание и использование шаблонов.
- 📊 Статистика: Наглядная аналитика работы саппорта на главном экране WebApp.
- 🎨 Дизайн: Трендовый фиолетово-чёрный интерфейс с плавными анимациями.
🛠️ Пошаговая инструкция по установке
Убедитесь, что у вас установлены Node.js (v16+) и npm/yarn.
Проверить версию:
Установка бэкенда:
Установка фронтенда (WebApp):
Проверить версию:
Код:
node --version
npm --version Установка бэкенда:
Код:
npm install Установка фронтенда (WebApp):
Код:
cd webapp
npm install
cd .. Скопируйте файл .env.example в .env и заполните его:
Код:
# Токен вашего бота (получаем у @BotFather)
BOT_TOKEN=1234567890:ABCDefGhijklmnoPQRStuvwxyz123456
# ID супергруппы поддержки (начинается с -100)
SUPPORT_GROUP_ID=-1001234567890
# ID пользователя, который будет администратором
ADMIN_USER_ID=12345678
# URL для WebApp (при локальном тесте через скрипт подставляется автоматически!)
WEBAPP_URL=https://your-domain.com
# Порт для веб-сервера
PORT=3000 4.1 Создаём бота в Telegram
1. Напишите в [@BotFather](https://t.me/BotFather) -> /newbot
2. Задайте имя и юзернейм, скопируйте токен в BOT_TOKEN.
4.2 Получаем ID группы поддержки
1. Создайте группу в Telegram и в настройках включите "Темы" (Topics).
2. Добавьте бота в группу и дайте права админа (отправка сообщений, медиа, управление темами).
3. Узнайте ID группы с помощью [@getidsbot](https://t.me/getidsbot) (ID должен начинаться с -100).
4.3 Получаем ID администратора
1. Напишите в [@userinfobot](https://t.me/userinfobot) и скопируйте свой ID в ADMIN_USER_ID.
1. Напишите в [@BotFather](https://t.me/BotFather) -> /newbot
2. Задайте имя и юзернейм, скопируйте токен в BOT_TOKEN.
4.2 Получаем ID группы поддержки
1. Создайте группу в Telegram и в настройках включите "Темы" (Topics).
2. Добавьте бота в группу и дайте права админа (отправка сообщений, медиа, управление темами).
3. Узнайте ID группы с помощью [@getidsbot](https://t.me/getidsbot) (ID должен начинаться с -100).
4.3 Получаем ID администратора
1. Напишите в [@userinfobot](https://t.me/userinfobot) и скопируйте свой ID в ADMIN_USER_ID.
🚀 Режим разработки (с автоматическим ngrok):
💎 Продакшен запуск:
Сначала собираем Frontend:
Запускаем бота:
Код:
npm run dev 💎 Продакшен запуск:
Сначала собираем Frontend:
Код:
cd webapp
npm run build
cd .. Код:
npm start 📖 Использование и возможности панели
Для пользователей: Всё максимально просто. Пишут боту — создается тикет. Получают ответ прямо в чате с ботом.
Для администраторов в Telegram:
- /admin — Открыть WebApp панель управления.
- /close — Закрыть тикет (отправлять строго внутри темы тикета).
- /имя_шаблона — Быстрый ответ из заготовленных шаблонов.
[💡] Что умеет WebApp Панель:
- 📊 Статистика: Счётчики пользователей, банов, открытых и закрытых тикетов.
- ⚙️ Кастомизация текста: Изменение приветствия, сообщений о закрытии, бане или тех. работах на лету.
- 👥 Менеджмент: Просмотр списка пользователей, выдача бан-молотка.
- 📋 Конструктор шаблонов: Создание быстрых ответов с поддержкой форматирования и Inline-кнопок.
- 📢 Рассылка: Массовые пуши по всей базе с двойным подтверждением для защиты от случайного нажатия.
⚠️ Важные нюансы
- Группа обязательно должна быть супергруппой с включенными темами, иначе бот упадет в ошибку.
- База данных SQLite создается сама при первом старте — настраивать сервер БД не нужно.
- Режим тех. обслуживания полностью перекрывает доступ к боту для всех, кроме юзера с ADMIN_USER_ID.
- Инлайн-кнопки в рассылках и шаблонах сохраняются в формате JSON автоматически через удобный визуальный редактор.
Код:
Support/
├── bot.js # Основной файл бота (Telegraf + Express)
├── start-dev.js # Скрипт для запуска в dev-режиме
├── get-ngrok-url.js # Работа с ngrok
├── reset-config.js # Сброс конфигурации
├── package.json # Зависимости backend
├── .env.example # Пример конфигурации
├── support_bot.db # SQLite база данных
└── webapp/ # Панель администратора (React)
├── dist/ # Сборка фронта
├── src/
│ ├── App.jsx # Логика панели
│ └── main.jsx # Точка входа React
├── index.html
└── vite.config.js 🛠️ Стек технологий: Node.js (Telegraf, Express) + React 18 (Vite, Tailwind CSS) + Better-sqlite3
Скриншоты работы бота и панели смотрите ниже во вложении!
Для просмотра скрытого содержимого вы должны войти или зарегистрироваться.
Вложения
-
photo_1_2026-05-31_09-56-36.jpg144.2 KB · Просмотры: 123 -
photo_10_2026-05-31_09-56-36.jpg86.1 KB · Просмотры: 113 -
photo_9_2026-05-31_09-56-36.jpg61.7 KB · Просмотры: 107 -
photo_8_2026-05-31_09-56-36.jpg171 KB · Просмотры: 101 -
photo_7_2026-05-31_09-56-36.jpg61.7 KB · Просмотры: 98 -
photo_6_2026-05-31_09-56-36.jpg65.8 KB · Просмотры: 91 -
photo_5_2026-05-31_09-56-36.jpg63.2 KB · Просмотры: 83 -
photo_4_2026-05-31_09-56-36.jpg157.9 KB · Просмотры: 74 -
photo_3_2026-05-31_09-56-36.jpg132.8 KB · Просмотры: 66 -
photo_2_2026-05-31_09-56-36.jpg134.9 KB · Просмотры: 112
Последнее редактирование: