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

Полное руководство по использованию платформы ботов-репетиторов

Шаг 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 по username и нажмите "Старт".

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

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

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

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

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

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

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

  • Осталось занятий: Текущий баланс уроков
  • Ссылка на урок: Быстрый доступ к видеозвонку (если настроена)
  • История занятий: Последние записи о проведенных уроках
Автоматические уведомления

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

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

Настройка 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.

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

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

Вернуться на главную Начать работу