Telegram-бот підтримки клієнтів зі ШІ: повний вихідний код

Повноцінний, готовий до промислового використання бот підтримки клієнтів для Telegram, що поєднує ШІ-асистента, легку базу знань і передачу оператору-людині в одній чистій кодовій базі. Створений для агенцій і фрилансерів, які постачають боти підтримки клієнтам, або для всіх, хто хоче автоматизувати власний канал підтримки в Telegram, не будуючи інфраструктуру з нуля.

Як це працює:
Telegram → ШІ → База знань → PostgreSQL → Панель адміністратора (в чаті)

Ключові можливості:

• 🧠 Відповіді на основі ШІ через будь-який OpenAI-сумісний API (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 + скрипт початкового наповнення

• Докладний README і повний PDF-посібник із налаштування та використання

Чудова відправна точка для: ботів підтримки для інтернет-магазинів, служб підтримки SaaS, ботів внутрішньої ІТ-підтримки або як white-label основа, яку ви налаштовуєте й перепродаєте власним клієнтам.