Илья Лящук

Привет, сообщество Laravel!

По вашим многочисленным запросам я выпустил третий релиз TG Support Bot — бота для технической поддержки на Laravel. За последние месяцы проект получил вдвое больше звёзд на GitHub, что мотивирует развивать его дальше.

В этом обновлении — API для подключения внешних источников, новые консольные команды, Swagger-документация и другие улучшения.

О проекте

TG Support Bot — это решение для организации поддержки клиентов через Telegram и ВКонтакте.

Как это работает:

• Клиент пишет боту в Telegram или VK
• Сообщение автоматически попадает в отдельную тему в Telegram-группе
• Менеджеры отвечают из группы, а клиент получает ответ от бота без раскрытия личных аккаунтов

Поддержите проект ⭐ на GitHub: https://github.com/prog-time/tg-support-bot

Обратная связь и установка

Присоединяйтесь к Telegram-группе для обсуждения: https://t.me/pt_tg_support

Видеоинструкция по установке (Docker + VPS):

Youtube: https://youtu.be/yNiNtFWOF2w

Rutube: https://rutube.ru/video/bdd0cc5ab4e13530fd7e0c2413931211/

ВК Видео: https://vkvideo.ru/video-141526561_456239132

Что нового в релизе №3

API для внешних источников

Реализовано универсальное API для подключения:

• Живых чатов с сайтов
• CRM-систем
• Кастомных форм обратной связи
• Любых других источников

Доступные методы API:

• GET /api/external/messages — список сообщений
• GET /api/external/messages/{id} — сообщение по ID
• POST /api/external/messages — отправка нового сообщения
• PUT /api/external/messages — редактирование
• DELETE /api/external/messages — удаление

Как подключить:

1. Создайте пользователя и токен:

php artisan app:generate-token {название_источника}

2. Настройте отправку запросов к API 3)Сообщения будут автоматически попадать в Telegram

Подробнее в Wiki на GitHub

Swagger-документация

Добавлен генератор Swagger-документации:

1. Описываете документацию в resources/swagger/
2. Генерируете файл:

php artisan swagger:generate

3. Получаете документацию в JSON и Swagger-UI

Новые команды Artisan

php artisan telegram:set-webhook — настройка вебхука Telegram через консоль php artisan app:generate-token — генерация API-токена

Другие улучшения

• Улучшено логирование (интеграция с Grafana)
• Исправлены баги из Issues
• Добавлен RedisInsight для просмотра Redis
• Обновлены инструкции по установке

Планы на будущее

Обновление функционала зависит только от вас. Предлагайте свои идеи в Telegram группе и голосуйте за них в теме “Голосование”. Если ваша идея наберёт много положительных голосов, то она обязательно будет включена в базовый функционал бота для технической поддержки.

Спасибо за поддержку! Если у вас есть вопросы по интеграции — пишите в Issues или Telegram.

Привет, коллеги.

В этом посте делюсь обновлениями по своему open source-проекту — Laravel-боту для технической поддержки. За месяц проект набрал более 100 клонирований и 40+ звёзд на GitHub. От сообщества начали поступать предложения и баг-репорты — спасибо всем, кто подключился.

На основе фидбека реализовал два ключевых улучшения:

• интеграция с ВКонтакте как новым каналом сообщений
• docker-compose сборка с полноценным стеком и логированием через Loki + Grafana

GitHub – https://github.com/prog-time/tg-support-bot

Если понравится — буду рад вашей ⭐!

Интеграция с ВКонтакте

Теперь бот может получать сообщения от сообщества ВКонтакте и пересылать их в Telegram-группу. Это позволяет объединить входящий поток из разных платформ в одном канале.

Поддерживается пересылка:

• текстовых сообщений
• файлов
• изображений
• голосовых
• контактов (преобразуются в текстовый формат)

Подключение ВКонтакте

В сообществе ВКонтакте:

• создайте ключ с доступом к сообщениям, фото и документам
• настройте Callback API на https://<домен>/api/vk/bot
• активируйте события: входящие/исходящие сообщения

В .env проекта пропишите:

VK_TOKEN=...
VK_CONFIRM_CODE=...
VK_SECRET_CODE=...

Роутинг и обработка реализованы через Laravel Controller с валидацией входящих запросов по VK_SECRET_CODE.

Docker-сборка

Проект теперь поставляется с готовым docker-compose.yml, включающим:

• nginx, php-fpm, PostgreSQL
• pgAdmin — для доступа к БД через браузер
• Grafana + Loki — для логирования и мониторинга

Логируются:

• все входящие и исходящие события (включая Telegram и VK)
• исключения, ошибки Laravel и stack trace

Примеры метрик:

• количество сообщений по каналам
• частота ошибок
• пиковые нагрузки

Grafana может быть сразу подключена к Loki и PostgreSQL для визуализации как логов, так и пользовательских метрик.

Что дальше

Реализованные доработки — результат прямой обратной связи от пользователей. Следующий этап — интеграция нового канала трафика (анонс после 80 звёзд на GitHub).

Если используете Laravel в проектах с Telegram/VK-ботами, посмотрите репозиторий на GitHub — возможно, он закроет часть ваших задач по организации единой поддержки через мессенджеры.

Pull requests и обсуждения приветствуются.