Введение
TG Support Bot — многоканальный сервис поддержки клиентов, который принимает обращения из разных мессенджеров и соцсетей и организует работу с ними через единую приватную Telegram-группу с топиками.
Поддерживаемые каналы входящих обращений:
- Telegram — через публичного бота;
- VK — через сообщения сообщества ВКонтакте;
- Max (экс-VK Мессенджер) — через бота платформы;
- Внешний API — интеграция из любого стороннего сервиса;
- Виджет живого чата — встраиваемый виджет для сайта.
Демо и видеоинструкции
Посмотрите видеообзор проекта и инструкции по установке: YouTube · Rutube · VK Видео
Сообщество в Telegram для вопросов и обсуждений: t.me/pt_tg_support
Исходный код: github.com/prog-time/tg-support-bot
Как это работает
Каждое входящее обращение проходит пять шагов:
- Получение сообщения. Клиент пишет в один из подключённых каналов — Telegram-бот, VK, Max, виджет на сайте или через внешний API.
- Создание топика. Бот автоматически создаёт отдельную тему (топик) в приватной Telegram-группе менеджеров. Каждый клиент получает свой собственный топик — история переписки хранится в одном месте.
- Пересылка сообщения. Входящее сообщение вместе с метаданными (канал, имя клиента, тип контента) пересылается в нужный топик.
- Ответ менеджера. Менеджер отвечает прямо в топике Telegram-группы, не покидая привычный интерфейс.
- Доставка ответа. Бот автоматически отправляет ответ обратно клиенту в тот канал, из которого пришло обращение.
INFO
Клиент в любой момент общается только с ботом и не видит менеджеров и внутреннюю структуру группы. Приватность поддержки обеспечивается на уровне архитектуры.
Ключевые возможности
Многоканальность
- Приём обращений из Telegram, VK, Max, виджета сайта и внешнего API.
- Единый интерфейс обработки для всех каналов — менеджеры работают только в Telegram-группе.
- Каждому клиенту автоматически создаётся отдельный топик с историей переписки.
Типы коммуникации
- Текстовые сообщения, фото, видео, документы, голосовые и видеосообщения.
- Отправка контактов и геолокации (где поддерживается платформой).
- Интерактивные кнопки в сообщениях — простой синтаксис прямо из текста ответа.
Автоматизация
- AI-помощник — автоматические ответы на основе базы знаний; поддерживаются OpenAI, DeepSeek, GigaChat.
- Очереди сообщений на базе Redis — надёжная обработка даже при высокой нагрузке.
- Настраиваемые шаблоны ответов и маршрутизация обращений.
Мониторинг
- Grafana + Loki — визуализация метрик и централизованный сбор логов.
- PgAdmin — веб-интерфейс для управления базой данных PostgreSQL.
- Интеграция с Sentry для отслеживания ошибок в реальном времени.
Модерация
- Блокировка пользователей непосредственно из Telegram-группы.
- Возможность закрыть или переоткрыть топик вручную.
- Полный журнал всех входящих и исходящих сообщений.
Стек технологий
| Слой | Технологии |
|---|---|
| Backend | Laravel 12, PHP 8.2, PostgreSQL, Redis |
| Realtime / Frontend | Node.js, Socket.io |
| DevOps | Docker, Docker Compose, Nginx, Certbot |
| Мониторинг | Grafana, Loki, PgAdmin, Sentry |
Поддерживаемые типы сообщений
| Тип | Telegram | VK | Max | Виджет сайта | Внешний API |
|---|---|---|---|---|---|
| Текст | + | + | + | + | + |
| Фото | + | + | + | + | + |
| Видео | + | + | + | — | + |
| Документ / файл | + | + | + | + | + |
| Голосовое сообщение | + | + | + | — | — |
| Видеосообщение (кружок) | + | — | — | — | — |
| Контакт | + | — | — | — | — |
| Геолокация | + | — | — | — | — |
| Стикер | + | — | — | — | — |
Что дальше
- Установка через Docker Compose — быстрый старт на VPS за несколько минут.
- Установка на хостинг — вариант без Docker.
- Конфигурация — полный справочник параметров
.env. - Подключение AI-помощника — настройка автоответов.
- Интерактивные кнопки — отправка кнопок клиенту прямо из ответа.