How prog-time/tg-support-bot works
TG Support Bot is a multichannel customer-support platform: Telegram, VK, Max, Avito, email, website widgets, and external APIs feed conversations that operators handle in an admin workspace or Telegram group topics. The main workflow stores messages and routes operator replies back through the originating channel; AI-assisted replies are an additional branch. The graph reflects README-documented capabilities and relationships visible in the supplied excerpts and SOURCE INDEX; unsampled channel internals are represented at their controller or service paths without asserting unverified calls.
Main entry points: TelegramBotController.php Telegram updates · Message.php Message history · WidgetController.php Website widget API · TgMessageService.php Telegram group topics
Components 27
Channels and intake
- Telegram updates
app/Modules/Telegram/Controllers/TelegramBotController.php - VK updates
app/Modules/Vk/Controllers/VkBotController.php - Max updates
app/Modules/Max/Controllers/MaxBotController.php - Avito updates
app/Modules/Avito/Controllers/AvitoBotController.php - Email inbox
app/Modules/Email/Console/PollInboxCommand.php - Website widget API
app/Modules/External/Controllers/WidgetController.php - External traffic API
app/Modules/External/Controllers/ExternalTrafficController.php
Conversation handling
- Support conversations
app/Models/BotUser.php - Message history
app/Models/Message.php - Telegram group topics
app/Modules/Telegram/Services/Tg/TgMessageService.php
Operator workspace
- Manager chat workspace
app/Livewire/Chat/ConversationPage.php - AI assistant
app/Modules/Ai/Services/AiAssistantService.php - AI answer delivery
app/Modules/Ai/Actions/DeliverAiAnswerToUser.php
Platform services
- Channel messaging
app/Modules/Telegram/Jobs/SendTelegramMessageJob.php - Channel settings
app/Services/Settings/SettingsService.php - External source registry
app/Models/ExternalSource.php - Avito messaging
app/Modules/Avito/Services/AvitoMessageService.php - Email messaging
app/Modules/Email/Services/EmailMessageService.php - VK messaging
app/Modules/Vk/Services/VkMessageService.php - Max messaging
app/Modules/Max/Services/MaxMessageService.php
Other components
- Telegram users
- VK users
- Max users
- Avito users
- Email users
- Website users
- External API sources
Connections 25
- Telegram users → Telegram updates: send updates
README.md - VK users → VK updates: send updates
README.md - Max users → Max updates: send updates
README.md - Avito users → Avito updates: send messages
README.md - Email users → Email inbox: send email
README.md - Website users → Website widget API: send messages
README.md - External API sources → External traffic API: send traffic
README.md - Telegram updates → Support conversations: resolve user
app/Modules/Telegram/Controllers/TelegramBotController.php - Telegram updates → Telegram group topics: handle update
app/Modules/Telegram/Controllers/TelegramBotController.php - Telegram updates → AI assistant: dispatch AI reply
app/Modules/Telegram/Controllers/TelegramBotController.php - Website widget API → External source registry: resolve source
app/Modules/External/Controllers/WidgetController.php - Website widget API → Message history: submit messages
app/Modules/External/Controllers/WidgetController.php - External traffic API → External source registry: authenticate source
- Telegram group topics → Message history: record messages
README.md - Support conversations → Message history: organize history
app/Models/BotUser.php - Manager chat workspace → Message history: manage conversations
README.md - Telegram group topics → Channel messaging: route replies
README.md - Manager chat workspace → Channel messaging: send operator replies
README.md - AI assistant → AI answer delivery: generate answers
app/Modules/Ai/Jobs/SendAiReplyJob.php - AI answer delivery → Channel messaging: deliver answers
app/Modules/Ai/Actions/AiAcceptMessage.php - Channel settings → Telegram updates: configure routing
app/Modules/Telegram/Controllers/TelegramBotController.php - Avito updates → Avito messaging: handle messages
- Email inbox → Email messaging: process inbox
- VK updates → VK messaging: handle messages
- Max updates → Max messaging: handle messages