Support Bot — ИИ-бот поддержки клиентов для Telegram, WhatsApp и MAX

Описание

Что это

Готовый ИИ-бот службы поддержки. Клиент пишет в мессенджер, бот ищет ответ в базе знаний компании и отвечает сразу. Если ответа в документах нет, бот честно говорит об этом и предлагает позвать сотрудника.

Ответы клиентам

Это ИИ-бот: ответы формирует языковая модель. Сначала поиск находит в документах подходящие фрагменты, затем модель по ним составляет ответ на вопрос клиента. Если фрагментов нет, бот сообщает, что ответа не нашёл, и предлагает оператора. Подключается любая модель с OpenAI-совместимым API: адрес, ключ, модель и системная инструкция меняются в настройках. Точность ответов зависит от выбранной модели и от того, насколько полны документы.

Один бот для трёх мессенджеров: общая база знаний, общие операторы, общая история и одна админ-панель.

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

• Клиент задаёт вопрос. Бот ищет нужный фрагмент в загруженных документах и формулирует короткий ответ.
• Ответа нет. Бот не выдумывает цены и сроки: он сообщает, что не нашёл ответ, и показывает кнопку «Связаться с оператором».
• Оператор подключается. Сотрудник получает карточку обращения с вопросом и историей диалога, отвечает прямо из Telegram, ответ уходит клиенту в его мессенджер.
• Обращение закрыто. Бот снова отвечает сам, вся переписка сохраняется.

База знаний

Загрузите документы в чат с ботом: TXT, MD, PDF или DOCX. После загрузки бот извлекает текст, разбивает его на фрагменты и индексирует для поиска ответов. Список документов, статус обработки, удаление и переиндексация доступны в админ-панели. Поиск работает локально и учитывает формы слов русского и английского языков.

Операторы и обращения

• Добавление операторов по Telegram ID.
• Карточка обращения: канал, клиент, вопрос, время и история диалога.
• Кнопки «Ответить пользователю» и «Завершить обращение».
• Команда /tickets со списком открытых обращений.
• Клиент может отменить обращение, пока его никто не взял.
• Отдельное сообщение вне рабочего времени.

Каналы

• Telegram. Подключается токеном от @BotFather, вебхук не нужен.
• WhatsApp. Официальный WhatsApp Business Cloud API: нужны собственный аккаунт Meta, номер и токен, подпись вебхуков.
• MAX. Официальный Bot API платформы MAX: нужен собственный бот и токен.
• У каждого канала можно задать своё приветствие, подпись и рабочие часы.

Настройки в Telegram

Всё меняется прямо в чате с ботом, без перезапуска:

• название компании, описание, приветствие, текст «нет ответа», подпись;
• контакт, рабочие часы, текст передачи оператору;
• адрес и ключ API, модель, длина ответа, число фрагментов, системная инструкция;
• режим «Чат» или «Меню» с кнопками и оценкой ответов, свои кнопки меню.

В боте есть раздел «Инструкция» с описанием каждого раздела.

Статистика

Пользователи, диалоги, сообщения, вопросы, вопросы без ответа, обращения к оператору и число документов. Список диалогов по каналам с историей переписки.

Безопасность

Ключи и токены каналов хранятся в базе в зашифрованном виде, сообщения с ключами бот сразу удаляет из чата. Подписи вебхуков проверяются. Есть защита от попыток изменить правила бота через сообщение, ограничение частоты запросов и размера файлов. Панель доступна только администраторам.

Запуск

Docker Compose или обычный Python 3.12. База SQLite из коробки, для рабочей нагрузки подключается PostgreSQL. Подробная инструкция с установкой, настройкой каналов и решением типичных ошибок лежит в README.

Для формирования ответов нужен ключ API OpenAI или совместимого сервиса. Аккаунт и расходы на API оплачивает покупатель.

Что входит

• Проект. Исходный код бота, миграции базы данных и шаблон настроек.
• Запуск. Dockerfile и docker-compose.yml.
• Документация. README с установкой, настройкой и устройством проекта.

Лицензия и условия

• Право использования передаётся одному покупателю: одна компания на собственных серверах.
• Код можно менять под свои задачи. Передавать его третьим лицам и перепродавать нельзя.
• Подпись «Сделано в студии разработки ARCHIVE0.RU» в README остаётся.