Справка по Алёнке

С чего начать

1. Откройте бота и отправьте /start.
2. Ознакомьтесь с документами и дайте необходимые подтверждения.
3. Подтвердите имя и выберите часовой пояс.
4. Активируйте пробный период отдельной кнопкой, если он доступен.
5. Откройте 📋 Возможности и выберите первую задачу.

Для текстов и работы с отзывами подключение кабинета не требуется. Для баланса, чатов и аналитики сначала подключите Avito API.

Голосовой ввод

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

Когда удобно

• Нужно быстро описать ситуацию по проекту или объявлению.
• Есть несколько показателей, нюансов или ограничений.
• Требуется консультация по Avito без заполнения длинной формы.

Голосовой ввод не отменяет уточнения: если данных не хватает, бот попросит недостающую информацию текстом или кнопками.

Тексты объявлений и статьи

Текст объявления

Алёнка просит минимум три базовых параметра: что продаём, город и цену или диапазон. Если данных не хватает, она задаёт уточняющий вопрос, а не заполняет пробелы выдуманными фактами.

Запуск: кнопка 📝 Текст объявления или соответствующая задача обычными словами при включённом интеллектуальном маршрутизаторе.

Статья

Для статьи укажите тему, аудиторию и площадку. Результат может приходить в виде готового Word-документа.

Статьи-жалобы и публичные обращения

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

1. Опишите историю в одном или нескольких сообщениях.
2. Приложите скриншоты и пояснения, если они важны для фактов.
3. Алёнка соберёт вводные, уточнит спорные места и подготовит структурированный Word-документ.

Цель — аккуратный материал с понятной позицией автора, без чрезмерной эмоциональности и юридически рискованных формулировок.

Отзывы и обжалования

Можно отправить текст отзыва, скриншот либо скриншот с подписью. Бот извлекает видимый текст и предлагает выбрать сценарий:

• Ответ на отзыв — публичная, спокойная реакция для клиента и других посетителей.
• Обжалование — аргументы и материал для обращения в поддержку.

Функция предназначена именно для отзывов. Универсальный анализ любых изображений не следует обещать без отдельной проверки.

Как подключить Avito API

1. В кабинете Avito откройте раздел с настройками API.
2. Создайте приложение и скопируйте Client ID и Client Secret.
3. В боте: 📁 Мои проекты → ➕ Добавить аккаунт.
4. Отправьте данные по шагам.
5. Алёнка проверит доступ и создаст проект с названием кабинета.

Безопасность: по архитектуре секреты хранятся в зашифрованном виде и не должны показываться обратно в чате.

Команды: /connect_avito, /check_avito, /remove_avito.

Как подключить Google Sheets

1. Сначала подключите Avito API и создайте проект.
2. Нажмите ➕ Добавить Google-таблицу.
3. Выберите проект и отправьте ссылку на существующую таблицу.
4. Дайте техническому аккаунту права редактора.
5. Бот проверит чтение и запись и сохранит связь.

Важно: текущий сценарий не создаёт новую таблицу — он подключает уже существующую.

Технический email: report-bot-reader@avito-report-bot.iam.gserviceaccount.com

Команды: /connect_google_sheet, /check_google_sheet, /remove_google_sheet.

Что такое проект

Проект объединяет кабинет Avito и связанные с ним рабочие подключения. Он создаётся автоматически после успешного подключения Avito API.

• Один кабинет — один проект.
• Можно подключить несколько кабинетов.
• К проекту привязывается Google-таблица.
• Через проект запускаются баланс, отчёты, чаты и аналитика.

Команды: /list_projects, /project_status, /archive_project, /check_all.

Баланс и операционный контроль

При проверке Алёнка смотрит два разных показателя:

1. Кошелёк — основные и бонусные деньги.
2. CPA-аванс — сумма для оплаты целевых действий.

Даже при положительном кошельке почти нулевой CPA-аванс может создать проблемы с показом объявлений. Поэтому оба значения важно смотреть вместе.

Команды: /balance, /project_report, /check_all.

Выгрузка чатов в Excel

Выгрузка скачивает последние 100 чатов из выбранного кабинета и присылает Excel без AI-оценки.

В файле

• Вкладка со всеми сообщениями и фильтрами.
• Вкладка с переписками, собранными блоками по чатам.
• Дата, время, роль клиента или менеджера и текст сообщения.

Ориентировочное выполнение: 5–15 минут. Это фоновая задача.

Запуск: 💬 Работа с чатами → 💬 Выгрузить чаты или /export_chats.

Аудит диалогов — AI-РОП

AI-РОП проверяет переписки по универсальным правилам и критериям конкретного бизнеса. Это отдельная тяжёлая функция, а не обычная выгрузка.

Объёмы

Что входит в Excel

• Список чатов: один диалог — одна строка.
• Итог: успех, провал, в работе, без лида либо ошибка AI.
• Балл, риск, проблема, рекомендация и доказательства.
• Сводка, критические диалоги и спорные места.
• Полные переписки для ручной проверки вывода.

В разделе 📋 Мои задания можно посмотреть статус, отменить активную задачу или повторно скачать готовый файл.

Выполнение может занимать от нескольких минут до часа в зависимости от объёма и очереди.

Фоновые задачи и «Мои задания»

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

• В списке заданий видно статус активной обработки.
• Готовый файл можно скачать повторно, если он ещё хранится на сервере.
• Активную задачу можно отменить, если она ещё не завершилась.

Если задача долго не меняет статус, проверьте подключение Avito API, доступ к Google-таблице и наличие нужного тарифа Avito.

AI-отчёт в Google-таблицу

Тяжёлая фоновая задача, которая переносит статистику Avito в три вкладки подключённой таблицы:

• ИИ отчёт {месяц}
• Авто дашборд
• ТОП история

Команды: /run_ai_report, /ai_report_status.

Расписания и напоминания

Поддерживаются обычные напоминания, проверки баланса, отчёты по проекту, проверка таблицы и AI-отчёты.

Примеры:

• «Каждый день в 9:00 проверяй баланс».
• «В 9:00 и 18:00 напомни проверить новые заявки».
• «Каждое утро обновляй AI-отчёт в таблице».

Максимум — до пяти активных расписаний. Минимальный интервал напоминания — пять минут.

/cancel отменяет только текущий диалог настройки. Уже созданное расписание отключается через /disable_schedule.

Команды: /add_reminder, /add_schedule, /list_schedules, /disable_schedule.

Доставка результатов в рабочие Telegram-чаты

Алёнку можно добавить в рабочую Telegram-группу и использовать её как канал доставки результатов: уведомлений, проверок, отчётов и файлов по расписанию.

Как это устроено

1. Пользователь подключает рабочий чат в боте.
2. При создании расписания выбирает доставку в личные сообщения или в рабочую группу.
3. Готовый результат приходит туда, где его увидит команда.

Бот не предназначен для бесконтрольного участия во всей групповой переписке. Рабочий чат используется прежде всего для доставки полезных результатов и уведомлений.

Встроенная справка и база знаний

Есть два уровня:

• Статическая справка — проверенные инструкции по подключению, чатам, проектам и отчётам.
• RAG-ответ — поиск ответа в подключённой базе знаний Avito.

Объём и темы RAG зависят от фактически загруженного индекса. Поэтому корректная формулировка для клиента: «ответы по подключённой базе знаний», а не «Алёнка знает абсолютно всё об Avito».

Тарифы и доступ

Функциональная логика разделяется на три уровня:

• Помощник — контент, отзывы и база знаний.
• Контроль — подключения, баланс, проекты, таблицы и выгрузка чатов.
• Автоаналитика — автоматические AI-отчёты и дайджесты.

AI-РОП подключается отдельно. Доступность конкретных функций также зависит от feature flags и стадии бета-тестирования.

Основные команды

Меню предпочтительнее полного списка slash-команд: оно показывает доступные пользователю сценарии и учитывает текущий этап работы.