📚 Документация

Шаг 1: Создание Telegram бота

1. Откройте Telegram и найдите @BotFather
2. Отправьте команду /newbot
3. Введите имя для вашего бота (например, "Мой репетитор английского")
4. Введите username для бота (должен заканчиваться на "bot", например, "my_english_tutor_bot")
5. Скопируйте токен, который выдаст BotFather. Он выглядит примерно так: 1234567890:ABCdefGHIjklMNOpqrsTUVwxyz

Шаг 2: Получение вашего Telegram ID

1. Откройте Telegram и найдите @userinfobot
2. Нажмите "Старт" или отправьте любое сообщение
3. Скопируйте ваш ID - это набор цифр (например, 123456789)

Шаг 3: Регистрация на платформе

1. Нажмите кнопку Зарегистрироваться
2. Заполните форму регистрации:
   • Email (для входа в систему)
   • Ваше полное имя
   • Пароль (минимум 6 символов)

Шаг 4: Создание и запуск бота

1. Войдите в систему используя ваш email и пароль
2. В панели управления нажмите "Создать нового бота"
3. Заполните форму:
   • Имя бота: Любое удобное название для вас
   • Токен Telegram бота: Вставьте токен, который получили от BotFather
   • ID преподавателей: Вставьте ваш Telegram ID (можно указать несколько через запятую)
4. Нажмите "Создать бота"
5. После создания нажмите кнопку Запустить рядом с вашим ботом
6. Дождитесь, пока статус не изменится на Запущен

Обзор веб-интерфейса

Теперь вы можете управлять вашим ботом не только через Telegram, но и через удобный веб-интерфейс на нашей платформе. Это дает вам больше возможностей и удобства в работе с учениками.

Основные преимущества веб-интерфейса

• Удобство: Работайте с большим экраном, используя полноценный компьютер или планшет
• Быстрота: Быстрый доступ ко всем функциям через вкладки панели управления
• Визуализация: Наглядное представление данных, календарь, статистика
• Расширенные функции: Финансовый учет, PDF-отчеты, пакеты уроков

Структура панели управления

После входа в систему вы увидите панель управления с четырьмя основными вкладками:

• Telegram бот: Управление ботом (запуск, остановка, редактирование)
• Панель учителя: Управление учениками и календарем занятий
• Финансовый учет: Учет платежей и пакетов уроков
• Настройки: Настройка уведомлений и параметров бота

Доступ к панели учителя

Перейдите на вкладку "Панель учителя" в панели управления. Здесь собраны все инструменты для ежедневной работы с учениками.

Управление учениками через веб-интерфейс

В веб-интерфейсе управление учениками стало еще проще:

1. Добавление ученика: Нажмите кнопку "Добавить ученика" и заполните форму
2. Просмотр списка: Все ученики отображаются в удобной таблице с:
   • ФИО ученика
   • Telegram username
   • Количество оставшихся уроков (с цветовой индикацией)
   • Заметками
   • Быстрыми действиями
3. Быстрые действия: Для каждого ученика доступны кнопки:
   • "Завершить урок" - списать один урок
   • "Детали ученика" - посмотреть полную информацию
   • "Редактировать" - изменить данные
   • "Удалить" - удалить ученика

Календарь в веб-интерфейсе

Календарь в веб-интерфейсе предоставляет расширенные возможности по сравнению с Telegram-ботом:

• Визуальное представление: Месячный календарь с отображением всех уроков
• Создание уроков: Два типа уроков:
  • Разовый урок - на конкретную дату
  • Постоянный урок - регулярные занятия по определенному дню недели
• Навигация: Легкое переключение между месяцами
• Редактирование: Кликните на урок чтобы изменить дату или время
• Цветовая кодировка: Каждый ученик имеет свой цвет для быстрого распознавания

Генерация PDF-отчетов

Новая функция, доступная только в веб-интерфейсе:

1. Нажмите на кнопку "Отчеты PDF" в панели учителя
2. Выберите период: 7, 14 или 30 дней
3. Система автоматически сгенерирует PDF-отчет с информацией о:
   • Проведенных занятиях
   • Учениках и балансе их уроков
   • Активности учеников

Добавление нового ученика

1. Откройте вашего бота в Telegram (используйте ID преподавателя, который вы указали)
2. Отправьте команду /start
3. Выберите "Добавить ученика"
4. Заполните данные ученика:
   • ФИО: Полное имя ученика
   • Telegram username: Username ученика (без @)
   • Количество уроков: Начальное количество оплаченных уроков
   • Примечание: Любая дополнительная информация
   • Ссылка на урок: Постоянная ссылка на видеозвонок (необязательно)

Приглашение ученика

После добавления ученика:

1. Сообщите ученику username вашего бота
2. Ученик должен найти бота в Telegram и нажать "Старт"
3. Бот автоматически привяжет ученика к его профилю по username
4. Ученик получит доступ к своей информации о занятиях

Управление учениками

Доступные команды для преподавателя:

• Список учеников: Просмотр всех зарегистрированных учеников
• Редактировать ученика: Изменить любые данные ученика
• Списать урок: Уменьшить количество оставшихся уроков на 1
• Добавить уроки: Увеличить количество уроков при продлении
• Удалить ученика: Полностью удалить ученика из системы

Для преподавателя

Календарь позволяет планировать занятия и события прямо в Telegram боте.

Как создать событие:

1. Откройте бота и нажмите кнопку "📅 Календарь"
2. Появится интерактивный календарь месяца
3. Нажмите на нужный день
4. Введите название события (например, "Урок с Анной")
5. Укажите время:
   • В формате ЧЧ:ММ или ЧЧ-ММ (например, "14:30" или "14-30")
   • Или отправьте "-" для целодневного события
6. Выберите ученика из списка (если событие касается конкретного ученика)
7. Добавьте описание или отправьте "-" чтобы пропустить

Управление событиями:

• Просмотр событий: Нажмите "📋 Мои события" для просмотра всех запланированных событий
• Навигация: Используйте кнопки "<<" и ">>" для переключения между месяцами
• Удаление: Откройте событие и нажмите "🗑 Удалить событие"

Для учеников

Ученики могут просматривать свои события через кнопку "📅 Мой календарь":

• Видят только события, назначенные для них
• Получают автоматические уведомления о новых событиях
• Могут просмотреть детали каждого события (время, описание)

Активация финансового учета

Финансовый учет - это опциональная функция, доступная только в веб-интерфейсе. Она позволяет вести учет платежей учеников и создавать пакеты уроков с ценами.

1. Перейдите на вкладку "Финансовый учет" в панели управления
2. Включите переключатель "Статус финансового учета" в верхней части страницы
3. После активации появятся все инструменты финансового учета

Пакеты уроков

Создавайте готовые пакеты уроков с фиксированной ценой:

• Создание пакета: Нажмите "Добавить пакет" и укажите:
  • Название (например, "Стандарт", "Премиум")
  • Количество уроков
  • Цену в рублях
  • Описание (необязательно)
• Редактирование: Изменяйте параметры существующих пакетов
• Удаление: Удаляйте неиспользуемые пакеты

Добавление платежей

Фиксируйте платежи от учеников:

1. Нажмите кнопку "Добавить платеж"
2. Заполните форму:
   • Сумма: Сумма платежа в рублях
   • Пакет уроков: Выберите из списка или оставьте "Разовый платеж"
   • Добавить уроков: Количество уроков, которые нужно добавить ученику
   • Примечание: Любая дополнительная информация
   • Дата платежа: Автоматически устанавливается текущая дата
3. При выборе пакета уроков поля "Сумма" и "Добавить уроков" заполнятся автоматически

История платежей

Просматривайте и фильтруйте историю всех платежей:

• Фильтры: Поиск по имени ученика, период дат
• Информация: Дата, сумма, пакет, количество уроков, примечание
• Удаление: Возможность удалить ошибочный платеж

Настройки уведомлений

Настройте автоматические напоминания для себя и учеников:

Время напоминаний учителю

• Укажите одно или несколько значений времени через запятую
• Формат: ЧЧ:ММ или ЧЧ-ММ
• Пример: 13:00,22:00
• В указанное время вы будете получать список учеников с низким балансом уроков

Время напоминания ученикам при 0 уроках

• Укажите одно значение времени
• Формат: ЧЧ:ММ или ЧЧ-ММ
• Пример: 13:00
• Ученики с нулевым балансом будут получать напоминание о необходимости продления

Синхронизация настроек

Настройки уведомлений синхронизируются между веб-интерфейсом и Telegram-ботом:

• Изменения, сделанные в веб-интерфейсе, сразу применяются в боте
• Изменения, сделанные в боте, отображаются в веб-интерфейсе
• Используется единая база данных для хранения настроек

Что такое обучающие карточки

Обучающие карточки (flashcards) — это интерактивный инструмент для изучения материала, аналогичный популярному сервису Quizlet. Создавайте наборы карточек со словами, выражениями или любыми другими вопросами и ответами.

Создание набора карточек

1. Перейдите на вкладку "Учебный материал" в панели управления
2. Нажмите кнопку "Создать набор карточек"
3. Введите название набора (например, "Irregular Verbs") и описание
4. Нажмите "Создать"

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

1. Нажмите "Редактировать" на созданном наборе
2. Заполните "Лицевую сторону" карточки (вопрос, слово)
3. Заполните "Обратную сторону" карточки (ответ, перевод)
4. Нажмите "Добавить карточку" для создания новых карточек
5. После завершения нажмите "Сохранить изменения"

💡 Совет: Вы можете удалить любую карточку, нажав на значок корзины в правом верхнем углу карточки.

Назначение карточек ученикам

1. Нажмите "Назначить" на нужном наборе
2. Отметьте галочками учеников, которым хотите назначить карточки
3. Нажмите "Сохранить"

Назначенные карточки будут отображаться на общей доске ученика для быстрого доступа.

Публичная ссылка на карточки

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

1. Нажмите "Поделиться" на нужном наборе
2. Скопируйте ссылку
3. Отправьте ссылку ученикам через Telegram, WhatsApp или любой другой мессенджер

Как пользоваться карточками

После открытия набора карточек ученики увидят интерактивный интерфейс с двумя режимами:

Режим карточек (по умолчанию)

• Переворачивание: Нажмите на карточку, чтобы увидеть ответ
• Навигация: Используйте кнопки "Назад" и "Вперед" или стрелки на клавиатуре (←, →)
• Перемешивание: Нажмите кнопку "Перемешать", чтобы изменить порядок карточек
• Автопроигрывание: Нажмите "Автопроигрывание", чтобы карточки автоматически менялись каждые 3 секунды
• Переворот клавишей: Нажмите Пробел или Enter для переворота текущей карточки

Режим списка

• Переключитесь на "Список", чтобы увидеть все карточки сразу
• Полезно для быстрого просмотра всего материала
• Удобно для печати или создания конспектов

Примеры использования

• Изучение слов: Создайте карточки с английскими словами на одной стороне и переводом на другой
• Неправильные глаголы: Лицевая сторона — инфинитив, обратная — три формы глагола и перевод
• Грамматические правила: Вопрос о правиле на одной стороне, объяснение на другой
• Формулы и определения: Подходит для любых предметов, не только для языков

Интерфейс ученика

Когда ученик открывает бота, он видит:

• 📊 Мои уроки: Текущий баланс уроков и история последних 10 занятий
• 📅 Мой календарь: Личный календарь с запланированными занятиями и событиями
• 🏫 Мой класс: Быстрый доступ к онлайн-классу (если настроена)

Автоматические уведомления

Бот автоматически отправляет ученикам:

• ✅ Подтверждение при регистрации
• 🔔 Уведомление о списании урока после занятия
• ⚠️ Предупреждение при остатке 3 уроков или меньше
• ❌ Уведомление об окончании уроков (0 уроков)
• 🎉 Уведомление о продлении и добавлении новых уроков
• 📅 Уведомление о новых событиях в календаре

Автоматическая кнопка для всех учеников

Кнопка "🏫 Мой класс" автоматически доступна всем ученикам в их меню. Эта кнопка ведет на личный класс каждого ученика, где преподаватель может размещать материалы и задания.

Как работает кнопка "Мой класс"

1. Каждый ученик видит кнопку "🏫 Мой класс" в своем меню после отправки команды /start
2. При нажатии на кнопку ученик получает ссылку на свой личный класс
3. Личный класс ученика имеет уникальный URL вида: https://teacherbots.ru/class/b8be8ad10d53
4. В личном классе ученик может видеть все материалы и задания, которые размещает преподаватель

Индивидуальная ссылка на класс (дополнительно)

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

1. В боте выберите ученика из списка
2. Нажмите "Редактировать ученика"
3. Укажите Ссылку на класс для этого ученика (например, ссылку на Google Classroom, Zoom комнату)
4. Эта дополнительная ссылка будет отображаться в карточке ученика

Что такое персональный лендинг

Персональный лендинг — это ваша профессиональная страница-визитка в интернете. Она помогает:

• Привлекать новых учеников через интернет
• Показывать ваш опыт и достижения
• Предоставлять контактную информацию в удобном виде
• Выглядеть профессионально в глазах родителей и учеников

Как создать лендинг

1. Войдите в панель управления
2. Перейдите в раздел "Лендинг" в меню
3. Выберите дизайн шаблона:
   • Современный (Modern) — яркий градиентный дизайн с анимациями
   • Минималистичный (Minimal) — чистый и строгий стиль
   • Профессиональный (Professional) — деловой стиль
4. Придумайте уникальный адрес (URI slug), например: ivan-math или anna_english
5. Заполните информацию о себе:
   • Заголовок и подзаголовок
   • 3 преимущества обучения у вас
   • Раздел "О себе" — опыт, образование
   • Услуги и цены
   • Контакты (Telegram, WhatsApp, Email, VK)
6. Загрузите профессиональное фото
7. Нажмите "Сохранить"

Ваш лендинг будет доступен по адресу

После сохранения ваш лендинг будет доступен по адресу:

teacherbots.ru/ваш-адрес

Например: teacherbots.ru/ivan-math или teacherbots.ru/anna_english

Как использовать лендинг

• Добавьте ссылку в соцсети: Instagram, VK, Facebook — в разделе "О себе" или Bio
• Отправляйте при первом контакте: Когда потенциальный ученик пишет вам, отправьте ссылку на лендинг
• Используйте в рекламе: При запуске таргетированной рекламы направляйте людей на лендинг
• Добавьте в подпись email: Профессиональная подпись с ссылкой на лендинг

Настройка cron-уведомлений

Для автоматической отправки напоминаний:

1. Используйте команду "Настройки" в боте
2. Укажите дни недели для напоминаний (например, "понедельник, среда, пятница")
3. Укажите время отправки (в формате ЧЧ:ММ, например, "18:00")
4. Напишите текст напоминания

Статистика и аналитика

Бот ведет детальную статистику активности учеников. Используйте кнопку "📈 Статистика просмотров" в боте для просмотра:

• Просмотры расписания: Когда и как часто ученики проверяют свои уроки (последние 30 дней)
• Активность по кнопкам: Отслеживание использования функций бота (кнопки "Мои уроки", "Мой календарь", "Мой класс")
• История занятий: Полная история списания уроков с датами и комментариями

Статистика помогает понять, насколько активно ученики используют бота и когда им нужно напомнить о занятиях.

Резервное копирование

Бот не отвечает

1. Проверьте статус бота в панели управления
2. Убедитесь, что статус показывает "Запущен"
3. Попробуйте остановить и снова запустить бота
4. Проверьте правильность токена Telegram бота

Ученик не может найти бота

• Убедитесь, что ученик использует правильный username бота
• Username должен быть точно таким, как вы указали при создании у BotFather
• В Telegram search используйте символ @ перед username

Бот не узнает ученика

• Проверьте, что username ученика в базе совпадает с его настоящим Telegram username
• Username должен быть без символа @ (только текст)
• Попросите ученика проверить свой username в настройках Telegram
• После изменения username, обновите данные в боте

Не приходят уведомления

• Убедитесь, что ученик не заблокировал бота
• Проверьте, что у ученика включены уведомления от ботов в настройках Telegram
• Проверьте настройки cron-уведомлений в боте

Ошибка при создании бота

• Неверный токен: Проверьте, что токен скопирован полностью без пробелов
• Токен уже используется: Один токен можно использовать только для одного бота
• Неверный ID: Telegram ID должен быть числом (например, 123456789)

Сколько ботов я могу создать?

Каждый пользователь может создать только одного бота на платформе.

Сколько учеников может быть у одного бота?

Нет ограничений на количество учеников. Вы можете добавить столько учеников, сколько нужно.

Можно ли указать несколько преподавателей?

Да, при создании бота укажите несколько Telegram ID через запятую (например, "123456789, 987654321").

Безопасны ли мои данные?

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

Что происходит с данными при удалении бота?

При удалении бота все данные, включая информацию об учениках, будут безвозвратно удалены. Сделайте резервную копию перед удалением!

Могу ли я изменить токен бота после создания?

В текущей версии нельзя изменить токен. Вам нужно удалить бота и создать нового с новым токеном.

Бот платный?

Платформа предоставляется бесплатно. Вам нужен только собственный Telegram бот от BotFather.

Как остановить бота на время отпуска?

В панели управления нажмите кнопку "Остановить" рядом с вашим ботом. Это не удалит данные, а просто остановит работу бота.