AI Customer Support Telegram Bot — Полный исходный код

Полностью готовый к производству бот поддержки клиентов для Telegram, совмещающий ИИ-ассистента, лёгкую базу знаний и передачу сложных бесед оператору в одном аккуратном коде. Создан для агентств и фрилансеров, которые разворачивают боты поддержки для клиентов, или для Anyone, кто хочет автоматизировать свой собственный Telegram-канал поддержки без необходимости строить инфраструктуру с нуля.

Как это работает:
Telegram → ИИ → База знаний → PostgreSQL → Панель администратора (в чате)

Ключевые возможности:

• 🧠 Ответы на основе ИИ через любой API, совместимый с OpenAI (OpenAI, OpenRouter, Groq или локальная модель) — смена провайдера одним изменением URL

• 📚 Встроенная FAQ / база знаний с полнотекстовым поиском по ключевым словам, которая обеспечивает опору ИИ на ваши реальные политики, без необходимости векторной БД

• 🙋 Передача оператору одной командой — клиент вводит /operator, разговор попадает в Telegram-группу вашей службы поддержки, и администраторы отвечают с помощью нативного Telegram-«Ответа» — без лишних инструментов

• 🗂 Полная история переписки — каждое сообщение (пользователь, ИИ и оператор) заносится в PostgreSQL

• 🛠 Админ-команды прямо в Telegram — статистика, управление FAQ, рассылки, история по пользователям и многое другое

• ⚙️ Живое редактирование системного промпта — изменяйте тон ИИ, правила или бизнес-контекст с помощью /setprompt, повторно разворачивать не нужно

• 📊 Встроенная статистика — пользователи, сообщения, новые регистрации, открытые запросы операторов

• 🐳 Docker & docker-compose — весь стек (бот + PostgreSQL) запускается одной командой

• 🔐 .env.example с документированными всеми переменными, плюс подробное руководство по установке и README

Технологический стек: Python 3.12, aiogram 3 (асинхр.), SQLAlchemy 2.0 + asyncpg, PostgreSQL 16, Docker.

Что включено:

• Полный, прокомментированный исходный код (33 файла, чистая модульная структура: обработчики, модели БД, уровень ИИ, утилиты)

• Dockerfile + docker-compose.yml для мгновенного развёртывания

• .env.example со всеми конфигурационными переменными

• Пример набора FAQ + seed-скрипт

• Подробное руководство в README и полный PDF-гайд по настройке/использованию

Отличная отправная точка для: бот-поддержка для электронной коммерции, службы поддержки SaaS, внутренняя IT-поддержка, или как белый ярлык base, который вы настраиваете и перепродаёте своим клиентам.