ONEENERGY Support Bot - Руководство пользователя

Общие сведения

ONEENERGY Support Bot - это Telegram-бот, созданный для поддержки клиентов компании ONEENERGY. Бот предоставляет удобный доступ к каталогу продукции, информации о гарантии и возврате товара, а также позволяет связаться с операторами поддержки.

Important

Бот может быть переделан под любой другой бренд и категорию товаров

🤖 Начать общение с ботом

Содержание

1. Функции для пользователей
2. Функции для администраторов
3. Установка и настройка
4. Структура базы данных
5. Системные требования

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

Начало работы

При запуске бота командой /start пользователь получает приветственное сообщение и основное меню с кнопками для доступа к основным функциям.

Пример приветственного сообщения:

👋 Добро пожаловать в бот поддержки ONEENERGY!

Здесь вы можете получить информацию о наших продуктах, гарантии и возврате.

Ознакомиться с нашим ассортиментом можно в магазинах:
[Wildberries] [Ozon] [Яндекс.Маркет]

Выберите действие:
[Наш ассортимент] [Гарантия] [Возврат] [👨‍💼 Связаться с оператором]

Просмотр ассортимента товаров

Пользователь может просматривать товары, выбирая последовательно:

1. Бренд
2. Категорию товара
3. Конкретный товар

Пример навигации по каталогу:

Выберите бренд:
[⬅️ Назад] [ONEENERGY] [Другой бренд]

Выберите категорию товаров ONEENERGY:
[⬅️ Назад] [Зарядные устройства] [Аккумуляторы]

Выберите товар из категории Зарядные устройства:
[⬅️ Назад] [Зарядка 65W] [Зарядка 100W]

После выбора товара пользователь получает:

• Фотографию товара (если добавлена)
• Подробное описание
• Кнопки для покупки на маркетплейсах (Ozon, Wildberries, Яндекс.Маркет)

Пример отображения товара:

🔋 ONEENERGY Power Bank 10000 mAh

✅ Быстрая зарядка
✅ Компактный размер
✅ Поддержка USB-C PD

Идеально подходит для зарядки смартфонов, планшетов и других устройств в пути.

[🛒 Купить на Ozon] [🛒 Купить на Wildberries] [🛒 Купить на Яндекс.Маркет]

Информация о гарантии и возврате

Пользователь может получить информацию о гарантии и правилах возврата товара через соответствующие кнопки в главном меню.

Пример информации о гарантии:

📝 Информация о гарантии

Гарантия на товар 2 года. Возврат товара возможен только при наличии брака или надлежащего качества с сохранением его товарного вида (не нарушением упаковки).

В соответствии с Постановлением Правительства РФ от 31.12.2020 N 2463 (ред. от 17.05.2024) "Об утверждении Правил продажи товаров по договору розничной купли-продажи, перечня товаров длительного пользования, на которые не распространяется требование потребителя о безвозмездном предоставлении ему товара, обладающего этими же основными потребительскими свойствами, на период ремонта или замены такого товара, и перечня непродовольственных товаров надлежащего качества, не подлежащих обмену, а также о внесении изменений в некоторые акты Правительства Российской Федерации" с пунктом 11 перечня непродовольственных товаров надлежащего качества, не подлежащих обмену наш товар относится к технически сложному товару, на который установлен срок годности не менее 1 года.

В соответствии со статьей 25 закона о защите прав потребителя данный товар подлежит возврату, если указанный товар не был в употреблении, сохранены его товарный вид, потребительские свойства, пломбы, фабричные ярлыки. В иных случаях возврат возможен только при наличии технического брака, подтвержденного СЦ.

Пример информации о возврате:

📦 Политика возврата

Возврат осуществляется через оформление заявки на возврат по браку в личном кабинете маркетпейса, в котором был приобретен товар.

Связь с оператором

Пользователь может обратиться к оператору поддержки, нажав на кнопку "👨‍💼 Связаться с оператором".

Пример диалога с оператором:

Бот: Вы подключены к оператору. Напишите ваш вопрос:
[⬅️ Назад]

Пользователь: Здравствуйте! У меня возникла проблема с зарядным устройством, после недели использования оно перестало работать.

Бот: Сообщение отправлено оператору. Ожидайте ответа.

(Некоторое время спустя)

Бот: 📩 Ответ от оператора:

Здравствуйте! Мы сожалеем о возникшей проблеме. Пожалуйста, оформите возврат по гарантии через маркетплейс, где был приобретен товар. Если у вас возникнут трудности, свяжитесь с нами снова, мы поможем.

👨‍💼 Функции для администраторов

Добавление товаров

Администраторы могут добавлять новые товары в базу данных с помощью команды:

/add_product [Бренд] [Категория] [Название] [ID сообщения] [Ссылки (опционально)] [ID фото (опционально)]

Пример добавления товара:

/add_product [ONEENERGY] [Зарядные устройства] [Зарядка 65W] [123456] [ozon:https://ozon.ru/link wb:https://wildberries.ru/link ym:https://market.yandex.ru/link] [789012]

Ответ бота:

✅ Товар успешно добавлен:
Бренд: ONEENERGY
Категория: Зарядные устройства
Название: Зарядка 65W
ID сообщения: 123456

Удаление товаров

Администраторы могут удалять товары из базы данных с помощью команды:

/delete_product [Бренд] [Категория] [Название товара]

Пример удаления товара:

/delete_product [ONEENERGY] [Зарядные устройства] [Зарядка 65W]

Ответ бота:

✅ Товар 'Зарядка 65W' из категории 'Зарядные устройства' бренда 'ONEENERGY' успешно удален

Ответы пользователям

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

/reply [ID пользователя] [текст ответа]

Пример ответа администратора:

/reply 1234567890 Здравствуйте! Спасибо за ваш вопрос. Мы рекомендуем попробовать перезагрузить устройство и использовать другой кабель для зарядки. Если проблема сохраняется, пожалуйста, свяжитесь с нами снова.

Ответ бота:

✅ Ответ отправлен пользователю 1234567890.

Логирование действий

Все действия пользователей и администраторов логируются в специальном канале для удобного мониторинга:

Пример лога действия пользователя:

📋 #USER_ACTION | 2024-06-01 15:30:45

💬 Сообщение оператору
👤 От: user123
🆔 ID: 1234567890
📝 Текст: Здравствуйте! У меня возникла проблема с зарядным устройством.

Пример лога ответа оператора:

📋 #OPERATOR_ACTION | 2024-06-01 15:45:12

🔄 Ответ оператора
👨‍💼 Оператор: admin_user (987654321)
👤 Пользователю: 1234567890
📝 Текст: Здравствуйте! Спасибо за ваш вопрос. Мы рекомендуем...

Установка и настройка

Требования

• Python 3.11 или выше
• Библиотеки из requirements.txt
• Telegram Bot API токен

Конфигурация

Бот использует следующие переменные окружения (в файле .env):

BOT_TOKEN=ваш_токен_телеграм_бота
OPERATORS=id_оператора_1,id_оператора_2
FILES_CHANNEL_ID=id_канала_для_файлов
LOG_CHANNEL_ID=id_канала_для_логов

Запуск

Бот настроен для запуска на платформе Amvera. Для локального запуска используйте:

python bot/chat_bot.py

📦 Структура базы данных

База данных SQLite включает следующие таблицы:

1. brands - бренды товаров
2. categories - категории товаров
3. products - информация о товарах

📚 Системные требования

• Python 3.11+
• Доступ в интернет
• Дисковое пространство: минимум 100 МБ
• Оперативная память: минимум 256 МБ

---

© ONEENERGY Support Bot, 2025. Все права защищены.