GradeSentinel
Документация · v2.5

Руководство пользователя

Всё, что нужно знать, чтобы подключить дневник, пригласить родственников и начать получать оценки в Telegram.

⏱ Время чтения 6 минут Обновлено 8 мая 2026

1. С чего начать

GradeSentinel — это Telegram-бот. У вас уже есть Telegram, поэтому ничего устанавливать не нужно. Вся работа происходит в чате с ботом.

1

Откройте бот в Telegram

Перейдите по ссылке t.me/GradeSentinel_bot или найдите бота в поиске Telegram. Нажмите кнопку START внизу экрана.

2

Выберите язык

При первом запуске бот спросит язык интерфейса: Русский, Oʻzbek или English. Язык можно сменить позже в меню → «Язык».

3

Авторизация по номеру телефона

Бот попросит поделиться контактом. Это нужно, чтобы привязать аккаунт к семье. Telegram автоматически предложит кнопку — просто нажмите её.

Что такое «семья»? Это группа родственников и детей, которые получают уведомления об одних и тех же дневниках. Один родитель может состоять в нескольких семьях (например, со супругом и со своими родителями).

2. Роли в семье

В системе три роли. Сначала вы становитесь главой первой семьи — потом можете добавить родственников любой ролью.

ДействиеГлаваРодственникАдмин
Получать уведомления
Смотреть оценки /grades
AI-отчёт
Добавлять детей
Создавать инвайт-ссылки
Удалять ребёнка из семьи
Управлять подпиской
Рассылка всем пользователям

3. Создание первой семьи

В главном меню нажмите кнопку 👨‍👩‍👧 Создать семью. Бот попросит ввести название — обычно это фамилия. Например: «Каримовы».

Создание семьи
Введите название семьи (например, «Каримовы»): 10:24
Каримовы 10:24 ✓✓
✅ Семья «Каримовы» создана.
Теперь добавьте первого ребёнка.
➕ Добавить ребёнка 🔗 Пригласить родственника
10:24

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

4. Добавление ребёнка и его дневника

Это самый важный шаг. Бот должен получить ссылку на Google Таблицу, в которой ведётся дневник ребёнка.

1

Получите ссылку у школы

Школа выдаёт каждому ученику свой Google-лист с оценками. Обычно его шлёт классный руководитель в родительский чат. Откройте таблицу — она должна открыться у вас в браузере с возможностью просмотра.

2

Скопируйте URL

Нажмите на адресную строку браузера и скопируйте весь адрес — он начинается с https://docs.google.com/spreadsheets/...

3

Отправьте ссылку боту

В меню нажмите ➕ Добавить ребёнка. Введите ФИО ребёнка, затем вставьте ссылку. Бот проверит доступ и сразу покажет, какие листы он нашёл («Сегодня», «Все оценки», «Четверти»).

Доступ к таблице. Если бот пишет «нет доступа» — попросите классного руководителя открыть просмотр для адреса gradesentinel@*.iam.gserviceaccount.com (выдаётся при регистрации) или сделать таблицу доступной по ссылке всем «как читателю».

5. Пригласить второго родителя

Глава семьи может пригласить любое количество родственников: второго родителя, бабушку, старшего брата.

1

Сгенерируйте инвайт-ссылку

Меню → 🔗 Пригласить. Бот пришлёт одноразовую ссылку вида t.me/GradeSentinel_bot?start=inv_AB12CD со сроком жизни 48 часов.

2

Отправьте ссылку

Любым способом — в WhatsApp, Telegram, SMS. Получатель кликает по ссылке, попадает в бота, проходит авторизацию по телефону и автоматически добавляется в вашу семью.

После активации ссылка становится недействительной. Если родственников несколько — генерируйте отдельную ссылку каждому.

6. Какие уведомления приходят

Новая оценка

Приходит в течение 5 минут после того, как учитель добавит её в дневник.

📚 Новая оценка
У Алишера по математике: 5
Контрольная работа · 2 четверть 10:24

Изменённая оценка

Если учитель исправил оценку в дневнике — бот сообщит об изменении.

✏️ Оценка изменена
У Камилы по истории: было 3 → стало 4 14:02

Вечерняя сводка (19:00)

Каждый день в 19:00 по Ташкенту — общий дайджест всех оценок за день по каждому ребёнку. Не приходит, если оценок не было.

Тихие часы 22:00–07:00

С 22:00 до 07:00 (Ташкент, UTC+5) бот не присылает уведомления — они копятся в очереди и приходят утром в 7:00 одним сообщением. Это поведение нельзя отключить.

7. AI-аналитика

На платных тарифах бот умеет делать аналитический отчёт через Claude AI: какие предметы «проседают», есть ли тренд на улучшение, на что обратить внимание.

Отчёт по запросу

Команда /ai_report или кнопка 🧠 AI-анализ в меню. Бот возьмёт оценки за последние 14 дней и вернёт отчёт за 10–20 секунд.

Еженедельный AI-отчёт

Каждое воскресенье в 19:00 — автоматический отчёт за неделю. Приходит главе семьи и всем родственникам с активной подпиской.

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

8. Подписка и оплата

Меню → 💳 Подписка. Доступны три тарифа:

  • 1 месяц — 29 900 UZS
  • 3 месяца — 79 900 UZS (экономия 11%)
  • 12 месяцев — 249 900 UZS (экономия 30%)

Оплата проходит через Click или Payme прямо в окне Telegram. После оплаты подписка активируется автоматически — без перезапуска бота.

Без автопродления. Подписка просто истекает в указанную дату — деньги не списываются повторно. За 3 дня до окончания бот напомнит и предложит продлить.

9. Команды бота

/startГлавное меню
/helpСправка по роли
/gradesОценки за сегодня
/ai_reportAI-анализ за 14 дней
/manage_familyУправление семьёй
/subscriptionПодписка и тарифы
/statusВаша статистика
/langСменить язык

10. Если что-то не работает

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

  • Проверьте, активна ли подписка: /subscription. Без подписки мониторинг отключён.
  • Убедитесь, что у бота есть доступ к Google Таблице.
  • Проверьте, что сейчас не тихие часы (22:00–07:00) — оценки копятся и придут утром.
  • Учитель действительно выставил оценку? Откройте таблицу вручную и убедитесь.

Не открывается дашборд (Mini App)

  • Обновите Telegram до последней версии.
  • Откройте дашборд через кнопку в меню бота, а не по прямой ссылке — без подписи Telegram авторизация не сработает.

Связаться с поддержкой

Меню → 💬 Поддержка. Сообщение уходит в закрытую группу администраторов, ответ приходит в чат с ботом обычно в течение 1–2 часов в рабочее время.

Никогда не отправляйте боту пароли от Google-аккаунта или школьной системы. Боту нужна только ссылка на таблицу с открытым доступом.