vk-sales-bot/docs/user_guide.md

Руководство оператора "Сотрудник первой линии"

Быстрый старт

1. Убедитесь, что установлен Python 3.11+ и все зависимости (pip install -r requirements.txt).
2. Скопируйте .env.example в .env и укажите токен группы VK.
3. Запустите бота: python main.py
4. Проверьте статус: напишите боту /status (только для администраторов, указанных в ADMIN_IDS).

Управление

• /status – проверить, работает ли бот.
• /export – создать копию файла лидов с меткой времени.
• /backup – вручную создать резервную копию.
• /stats – показать статистику (всего лидов, за сегодня, по статусам).
• /reload – перезагрузить текстовые фразы без перезапуска.

Просмотр данных

Файл с лидами находится в data/leads.xlsx. Резервные копии – в data/backups/.

Решение проблем

• Бот не отвечает: проверьте токен и права доступа группы (нужны messages и groups).
• Ошибка записи в файл: убедитесь, что папка data существует и доступна для записи.
• Бот не видит сообщения: группа должна быть публичной или добавьте бота в беседу.