Скрипт Скрипт | Бот обратной связи

Приветствую!​

Часто сталкиваетесь с ситуацией, когда невозможно связаться с человеком в Telegram из-за блокировки, спамблока или отсутствия привязанного аккаунта на форуме? Я спешу поделиться решением, которое поможет наладить общение, даже если стандартные методы не работают. Этот бот станет настоящей находкой для тех, кто получает много сообщений, порой по странным или даже конфликтным причинам, и хочет иметь контролируемый канал связи.

Основная идея заключается в создании надёжного моста для коммуникации между двумя пользователями Telegram через бота. Один пользователь отправляет сообщение боту, и оно мгновенно доставляется второму. Затем второй пользователь может отправить ответ, который получит первый. Такая система позволяет организовать множество параллельных диалогов, обеспечивая конфиденциальность и надёжность обмена сообщениями.

Функционал для администратора

Не забыли мы и об администраторах. Для них предусмотрена мощная и удобная панель управления, обеспечивающая полный контроль и максимальную эффективность:
* **Все диалоги:** Администратор получает полный обзор всех активных переписок с пользователями в одном месте, с возможностью **поиска по ключевым словам и фильтрации** для быстрого нахождения нужных диалогов.
* **Ответ на сообщение:** Ответить на любое обращение невероятно просто — достаточно нажать на специальную кнопку под сообщением. Также возможно **переслать диалог другому администратору** или **добавить внутренние заметки**, видимые только другим админам.
* **Управление диалогами:** Помимо стандартного ответа, диалоги можно **"закрывать" и архивировать** после решения вопроса, сохраняя порядок в списке активных переписок.
* **Комплексная система блокировок:** Администратор может легко заблокировать любого пользователя, обеспечивая порядок и защиту от нежелательного общения.
* **Пагинация:** Для максимального комфорта при работе с большим количеством диалогов, список разделён на удобные страницы с интуитивными кнопками навигации.

Функционал для пользователей

Для удобства каждого пользователя разработан интуитивно понятный функционал, значительно расширяющий возможности коммуникации:
* **Команда `/start`:** При её активации бот тепло приветствует вас и сразу же открывает доступ к главному меню.
* **Написать сообщение:** Всего одно нажатие кнопки, и вы сможете отправить своё обращение администратору или любому другому назначенному собеседнику, **приложив необходимые файлы (скриншоты, *********) или записав голосовое сообщение**. Кроме того, есть возможность **выбрать тему сообщения из предложенных вариантов**, а также отправить запрос **полностью анонимно**, если это предусмотрено.
* **Статусы сообщений:** Пользователь всегда видит актуальный статус своего обращения: "получено", "прочитано", "в работе" или "решено", что позволяет быть в курсе прогресса и снижает тревожность.
* **История диалогов:** Больше не нужно переживать о потерянных сообщениях! Вся ваша переписка с администратором сохраняется и доступна для просмотра в удобной истории.
* **Мой профиль:** Здесь вы найдёте всю ключевую информацию о своём аккаунте в боте, чтобы всегда быть в курсе.
* **Оценка качества:** После завершения диалога у вас появится возможность оценить работу администратора, помогая улучшать качество обслуживания.
* **ЧаВо (FAQ) / База знаний:** Быстрый доступ к ответам на часто задаваемые вопросы поможет оперативно найти решение типовых проблем, не дожидаясь ответа администратора.
* **Приоритет сообщений:** Вы можете пометить особо важные обращения как "срочные", чтобы привлечь к ним внимание администратора.

Дополнительные функции

Мы также реализовали ряд дополнительных возможностей, которые делают бота ещё более мощным, удобным и конкурентоспособным на рынке:
* **Расширенная система тем:** Пользователи смогут выбирать тему сообщения перед отправкой, а администраторы легко управлять этими темами, их описаниями и приоритетом.
* **Улучшенная админ-панель:** Возможность управления другими администраторами (добавление/удаление), гибкое назначение диалогов ответственным лицам, массовые рассылки сообщений всем пользователям и гибкая настройка тем сообщений.
* **Гибкая система блокировок:** Администраторы могут блокировать пользователей, а сами пользователи – при желании временно или навсегда заблокировать себя в боте.
* **Продвинутые уведомления:** Администраторы будут мгновенно получать уведомления о новых сообщениях, включая **напоминания о неактивных диалогах**, а пользователи — об ответах.
* **Подробная статистика:** Отображение количества ответов для каждого сообщения, статуса их прочтения, а также общих показателей активности и загруженности администраторов.
* **Высокий уровень безопасности:** Тщательная проверка прав администратора перед выполнением команд и подтверждение для всех критических действий (например, удаление данных).
* **Интуитивно понятный интерфейс:** Удобное меню, чёткие кнопки для всех основных действий и подробные сообщения с красивым форматированием.
* **Надёжная обработка ошибок:** Защита от некорректного ввода данных и своевременные уведомления об ошибках для пользователя и администратора.
* **Продуманная база данных:** Автоматическое создание при первом запуске, нормализованная структура таблиц и внешние ключи для обеспечения целостности и надёжности данных.
* **Мультиязычность:** Возможность выбора языка интерфейса для максимального удобства глобальной аудитории.

Инструкция по запуску

Запустить бота очень просто:
1. Создайте файл config.json и разместите его в той же папке, что и скрипт бота, со следующим содержимым:
{
"BOT_TOKEN": "ВАШ_ТОКЕН_БОТА",
"ADMIN_ID": ВАШ_ID_В_TELEGRAM
}
2. Установите зависимости, откройте командную строку (терминал) и выполните команду:
pip install python-telegram-bot
3. Запуск бота: Ещё одна простая команда, и ваш бот готов к работе:
python feedback_bot.py

Бот автоматически позаботится о создании базы данных `feedback.db` при первом запуске и зарегистрирует администратора, указанного в вашем конфигурационном файле.

Cкриншоты

(переделал меню на инлайн)

Скачать >>>>

GitHub
https://github.com/Vamp1reAchao/LiveBot/tree/main​

Что будет в новом обновлении?

1. Богатый медиа-функционал:
- Отправка видео и GIFs: Иногда скриншота мало, нужно показать короткий ролик или GIF, чтобы объяснить проблему или идею.
- Превью ссылок: Если пользователь отправляет ссылку, бот может автоматически генерировать превью страницы для админа, чтобы он сразу - - - понимал контекст.

2. Умные подсказки/автодополнение:
- Предлагаемые темы: Когда юзер начинает писать, бот может предлагать темы из списка (например, по ключевым словам в начале сообщения), чтобы ускорить выбор и облегчить категоризацию для админа.
- Автоматические ответы на ЧаВо: Если юзер задает вопрос, который есть в FAQ, бот может предложить ответ из базы знаний *до* отправки сообщения админу, чтобы не отвлекать его по типовым вопросам.

3. Персонализация/Управление профилем пользователя:
- Изменение никнейма в боте: Если пользователь хочет, чтобы его отображали иначе в диалогах с админом (не по его ТГ-имени).
- Настройка уведомлений: Пользователь может сам выбрать, о каких событиях он хочет получать уведомления (например, только о новых ответах, или обо всех изменениях статуса).

4. Геймификация/Мотивация (легкая):
- Система "баллов" или "уровней": За каждое полезное обращение или быструю оценку ответа. Баллы могут давать какие-то бонусы (например, приоритет в очереди, если он будет реализован, или просто "значок лояльности" в профиле).

Для администраторов (чтобы им было ещё удобнее и эффективнее):

5. "Горячие" шаблоны ответов:
- Админ может настроить готовые шаблоны для часто задаваемых вопросов или типовых ситуаций, чтобы отвечать одним нажатием кнопки. Это существенно ускоряет работу.

6. Назначение диалогов:
- Если админов несколько, возможность "передавать" диалог конкретному админу или "забрать" его себе.
- Очередь обработки: Диалоги можно разделить на активные, ожидающие ответа, в работе, закрытые.

7. Глубокая аналитика и отчетность:
- Отчеты по темам: Какие темы сообщений наиболее популярны?
- Время ответа: Среднее и максимальное время ответа администраторов.
- Пиковые часы нагрузки: Когда больше всего обращений?
- Оценка качества админов: По среднему баллу, который ставят пользователи.
- Экспорт данных: Возможность выгрузки диалогов или статистики в CSV/Excel.

8. Интеграция с внешними сервисами:
- Webhooks для уведомлений: Отправка уведомлений о новых сообщениях или важных событиях в другие системы (Slack, Discord, внешние CRM).
- API для управления: Возможность управлять диалогами, блокировками и т.д. из внешней системы, а не только через ТГ.

9. Управление пользователями:
- "Черный список" по ключевым словам: Автоматическая блокировка сообщений, содержащих нежелательные слова.
- Просмотр истории действий пользователя в боте: Сколько раз писал, какие темы выбирал, когда был заблокирован/разблокирован.

10. Локализация админ-панели:
- Если админы из разных стран, возможность выбора языка интерфейса для них тоже.

Для всех (общие улучшения, которые усилят бота):

11. Режим обслуживания/Технические работы:
- Возможность включить режим, когда бот не принимает новые сообщения и выдает уведомление о технических работах.
- Автоматическое уведомление пользователей о завершении тех. работ.

12. "Пинги" для админа:
- Если сообщение помечено как "срочное", или долго нет ответа, бот может отправлять напоминания админу (наприме


04.06.2025 next update

Last update (03.06.2025)

для юзеров:
– добавил вложения и голосовухи, так что теперь можно кидать фотки, файлы и записывать голос.
– прикрутил анонимный режим, если кто-то хочет написать, но не светиться.
– сделал оценку диалогов, чтобы после общения можно было поставить админу звёздочки.
– добавил ЧаВо/базу знаний, чтобы люди могли сами найти ответы на типовые вопросы.
– показал статусы сообщений, так что теперь видно, когда твоё сообщение получено, прочитано или в работе.
– дал возможность помечать сообщения как срочные, чтобы админ сразу видел приоритет.

для админов:
– улучшил управление диалогами, теперь их можно "закрывать" и "архивировать".
– добавил внутренние заметки к диалогам, чтобы админы могли помечать что-то для себя.
– сделал переадресацию/назначение диалогов, чтобы можно было кинуть переписку другому админу.
– улучшил поиск по диалогам по ключевым словам и дате.
– добавил "горячие" кнопки/типы запросов, чтобы сразу понимать, о чём пишет юзер.
– реализовал мультиязычность, чтобы бот понимал всех.
– настроил уведомления о неактивности, чтобы никто не забывал про диалоги.
– теперь для продолжения диалога не нужно нажимать кнопку "ответить ещё раз", диалог ведётся до того, пока администратор или пользователь не закроет обращение
- теперь админы могут оставлять комменты под профиль юзера, что бы знать с кем имеют дело. (юзеры их не видят)

О любых багах или ваших идеях для обновлений пишите комменты под тему ​