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