Исходники - Бот - [WebApp] Telegram Support (TICKET) bot | Бот для связи с администрацией канала/группы телеграм. | End Way — сообщество разработчиков и готовых решений
  • Больше материалов без ожидания и лишних условий
    Доступ к скрытым публикациям на 2 месяца, 3 месяца или навсегда. Ограничения «Команда форума» и «Личный» сохраняются.

    Сравнить варианты доступа →

    🔔 EndWay в Telegram

    Следите за новостями и релизами:
    EndWay | EndSoft

Исходники Бот [WebApp] Telegram Support (TICKET) bot | Бот для связи с администрацией канала/группы телеграм.

c4act6e

Сеньор
Автор темы
29 Июл 2024
16
25
*сделано с помощью ИИ
🟣 Telegram Support Bot 🟣​
Современный бот для технической поддержки с WebApp-панелью администратора




✨ Основные функции

  • 🪐 Создание тем: При первом обращении пользователя бот автоматически создаёт новую тему (форумный топик) в группе поддержки.
  • 📂 Всеядность медиа: Поддерживает текст, фото, видео, документы, голосовые и аудио сообщения, стикеры в обе стороны.
  • 💬 Удобный реплай: Администраторы могут отвечать пользователю, просто отправляя сообщения прямо в созданную тему.
  • 🔒 Закрытие тикетов: Команда /close мгновенно закрывает тикет и уведомляет пользователя.
  • 🖥️ WebApp-панель: Полная настройка и управление ботом через стильный веб-интерфейс (доступно только админу).
  • ⚙️ Расширенный функционал:
    • Полная кастомизация: Изменение любых текстовых ответов бота прямо из панели.
    • Модерация: Блокировка и разблокировка неадекватных пользователей.
    • Режим ТО: Включение технического обслуживания в один клик.
    • Маркетинг: Массовая рассылка сообщений по всей базе пользователей.
    • Быстрые ответы: Создание и использование шаблонов.
  • 📊 Статистика: Наглядная аналитика работы саппорта на главном экране WebApp.
  • 🎨 Дизайн: Трендовый фиолетово-чёрный интерфейс с плавными анимациями.



🛠️ Пошаговая инструкция по установке

Убедитесь, что у вас установлены Node.js (v16+) и npm/yarn.

Проверить версию:
Код:
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.

🚀 Режим разработки (с автоматическим ngrok):
Код:
npm run dev

💎 Продакшен запуск:
Сначала собираем Frontend:
Код:
cd webapp
npm run build
cd ..
Запускаем бота:
Код:
npm start



📖 Использование и возможности панели

Для пользователей: Всё максимально просто. Пишут боту — создается тикет. Получают ответ прямо в чате с ботом.

Для администраторов в Telegram:
  • /admin — Открыть WebApp панель управления.
  • /close — Закрыть тикет (отправлять строго внутри темы тикета).
  • /имя_шаблона — Быстрый ответ из заготовленных шаблонов.

[💡] Что умеет WebApp Панель:
  • 📊 Статистика: Счётчики пользователей, банов, открытых и закрытых тикетов.
  • ⚙️ Кастомизация текста: Изменение приветствия, сообщений о закрытии, бане или тех. работах на лету.
  • 👥 Менеджмент: Просмотр списка пользователей, выдача бан-молотка.
  • 📋 Конструктор шаблонов: Создание быстрых ответов с поддержкой форматирования и Inline-кнопок.
  • 📢 Рассылка: Массовые пуши по всей базе с двойным подтверждением для защиты от случайного нажатия.



⚠️ Важные нюансы
  1. Группа обязательно должна быть супергруппой с включенными темами, иначе бот упадет в ошибку.
  2. База данных SQLite создается сама при первом старте — настраивать сервер БД не нужно.
  3. Режим тех. обслуживания полностью перекрывает доступ к боту для всех, кроме юзера с ADMIN_USER_ID.
  4. Инлайн-кнопки в рассылках и шаблонах сохраняются в формате 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.jpg
    photo_1_2026-05-31_09-56-36.jpg
    144.2 KB · Просмотры: 123
  • photo_10_2026-05-31_09-56-36.jpg
    photo_10_2026-05-31_09-56-36.jpg
    86.1 KB · Просмотры: 113
  • photo_9_2026-05-31_09-56-36.jpg
    photo_9_2026-05-31_09-56-36.jpg
    61.7 KB · Просмотры: 107
  • photo_8_2026-05-31_09-56-36.jpg
    photo_8_2026-05-31_09-56-36.jpg
    171 KB · Просмотры: 101
  • photo_7_2026-05-31_09-56-36.jpg
    photo_7_2026-05-31_09-56-36.jpg
    61.7 KB · Просмотры: 98
  • photo_6_2026-05-31_09-56-36.jpg
    photo_6_2026-05-31_09-56-36.jpg
    65.8 KB · Просмотры: 91
  • photo_5_2026-05-31_09-56-36.jpg
    photo_5_2026-05-31_09-56-36.jpg
    63.2 KB · Просмотры: 83
  • photo_4_2026-05-31_09-56-36.jpg
    photo_4_2026-05-31_09-56-36.jpg
    157.9 KB · Просмотры: 74
  • photo_3_2026-05-31_09-56-36.jpg
    photo_3_2026-05-31_09-56-36.jpg
    132.8 KB · Просмотры: 66
  • photo_2_2026-05-31_09-56-36.jpg
    photo_2_2026-05-31_09-56-36.jpg
    134.9 KB · Просмотры: 112
Последнее редактирование:
  • 11
Реакции: 10 users

c4act6e

Сеньор
Автор темы
29 Июл 2024
16
25
УПД: обновлять есть куда и есть что, как минимум:
  • Антиспам,
  • Автозакрытие тикета через время,
  • Проверка на рекламу,
  • Проверка отправлен ли альбом (сейчас с этим баг, считает каждое фото в альбоме - как отдельное сообщение)
 

c4act6e

Сеньор
Автор темы
29 Июл 2024
16
25
Совет: если вам пишет после первого запуска такое:
Код:
Error: listen EADDRINUSE: address already in use :::3000
    at Server.setupListenHandle [as _listen2] (node:net:1908:16)
    at listenInCluster (node:net:1965:12)
    at Server.listen (node:net:2067:7)
    at Function.listen (D:\Code\NEW_Support\node_modules\express\lib\application.js:635:24)
    at Object.<anonymous> (D:\Code\NEW_Support\bot.js:491:5)
    at Module._compile (node:internal/modules/cjs/loader:1529:14)
    at Module._extensions..js (node:internal/modules/cjs/loader:1613:10)
    at Module.load (node:internal/modules/cjs/loader:1275:32)
    at Module._load (node:internal/modules/cjs/loader:1096:12)
    at Function.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:164:12)
    at emitErrorNT (node:net:1944:8)
    at process.processTicksAndRejections (node:internal/process/task_queues:82:21) {
  errno: -4091,
  port: 3000
}

Node.js v20.19.3
❌ Bot server exited with code 1

Решение:
В консоли пишем: netstat -ano | findstr :3000 и видим что-то подобное:
Код:
  TCP    0.0.0.0:3000           0.0.0.0:0              LISTENING       14420
  TCP    [::]:3000              [::]:0                 LISTENING       14420

Пишем: taskkill /F /PID 14420 (ВМЕСТО ЭТИХ ЦИФР ПИШЕТЕ ТЕ, ЧТО У ВАС ПОСЛЕ LISTENING)
 
  • 1
Реакции: 1 user

c4act6e

Сеньор
Автор темы
29 Июл 2024
16
25
Не прошло и часа.
Новая версия, что добавил:
  • Антиспам,
  • Добавленна поддержка всех типов сообщений,
  • Блокировка определенных типов сообщений,
  • Автозакрытие тикета,
  • Теперь альбом бот считывает как одно сообщение, а не разделяет на несколько,
  • Багфикс.

 
  • 7
Реакции: 6 users

c4act6e

Сеньор
Автор темы
29 Июл 2024
16
25
upd: Новая версия, пару новых фич, багфикс
Что добавленно/измененно:,
  • Переменные для указания Ника, Имени, Фамилии, ID пользователя.
  • При создании топика добавляются инлайн-кнопки "Заблокировать" и "Просмотр профиля" пользователя.
  • Переработал создание шаблона.
  • Теперь при закрытии топика админом (или автоматом) - бот закрывает тему, если пользователь заново напишет - бот будет искать его топик, если не найдет - создает новый.
  • Багфикс
ВАЖНО: УДАЛИТЕ СТАРУЮ БАЗУ ДАННЫХ ДЛЯ КОРРЕКТНОЙ РАБОТЫ!!!
 
  • 2
Реакции: 1 users

c4act6e

Сеньор
Автор темы
29 Июл 2024
16
25
Новая версия:
  • Проверка подключена ли группа для тикетов, только после подключения бот будет работать полноценно.
  • Добавленны анимированные иконки
  • Багфикс с сохранением данных в БД.
  • Добавил видео-обзор работы
 

c4act6e

Сеньор
Автор темы
29 Июл 2024
16
25
Версия 1.3а:
Маленькое обновление, добавлял себе, но вспомнил про вас.

  • Автоответ по ключевому слову и настройка этого всего.


    Как работает: вы добавляете ключевое слово, к примеру, "работать" --- какой-то юзер пишет в бота "Привет, я хочу работать с вами", бот сразу же отправляет этому пользователю заранее заготовленный текст, при этом топик создается и в топике вас информирует, что был автоответ.
 
Активность:
Пока что здесь никого нет