Как сделать бота-расписание в Телеграме

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

Чтобы сделать бота-расписание в Телеграме, необходимо зарегистрировать его через BotFather, написать обработчики команд, подключить хранилище данных и настроить вывод событий по датам.

Что такое бот-расписание в Телеграме

Бот-расписание в Телеграме — это программа, которая хранит события и показывает их по выбранной дате, дню недели, группе или другой категории.

Такой бот можно использовать для:

• школьных уроков;
• занятий в колледже или вузе;
• курсов и кружков;
• рабочих смен;
• тренировок;
• приема специалистов;
• мероприятий;
• внутренних задач команды.

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

Какие функции нужны боту с расписанием

Для первой версии достаточно нескольких возможностей:

• запуск по команде /start;
• выбор и сохранение группы;
• вывод расписания на сегодня;
• показ событий на завтра;
• просмотр графика на неделю;
• сообщение об отсутствии событий;
• обработка неизвестных команд.

По мере развития проекта можно добавить:

• поиск расписания по дате;
• четные и нечетные недели;
• сведения о преподавателе и аудитории;
• отмены и переносы;
• автоматические уведомления;
• административное редактирование;
• несколько категорий пользователей.

Сначала лучше собрать минимальную версию и проверить основную логику. После этого проект проще расширять.

Как работает Telegram-бот с расписанием

Telegram-бот с расписанием получает запрос, ищет подходящие события в хранилище и отправляет пользователю сформированный список.

Последовательность выглядит так:

1. Пользователь запускает бота.
2. Выбирает группу или категорию.
3. Нажимает кнопку нужного дня.
4. Приложение получает запрос.
5. Бот ищет события для выбранной группы и даты.
6. Записи сортируются по времени.
7. Готовое расписание отправляется в чат.

Что делает Telegram

Telegram принимает команды и нажатия кнопок, передает приложению обновления и доставляет сформированный ответ пользователю.

Также платформа предоставляет идентификаторы пользователя и чата, которые необходимы для сохранения настроек и отправки сообщений.

Что делает приложение бота

Приложение должно:

• обрабатывать команды;
• сохранять выбранную группу;
• определять дату;
• получать события из базы;
• учитывать отмены и переносы;
• формировать читаемый ответ;
• проверять права администратора;
• отправлять уведомления.

BotFather только регистрирует нового бота и выдает токен. Он не создает команды, кнопки и функции расписания.

Что понадобится для создания бота

Для разработки нужны:

• аккаунт в Телеграме;
• бот, созданный через BotFather;
• токен доступа;
• установленный Python;
• библиотека для Telegram Bot API;
• редактор кода;
• хранилище данных;
• компьютер для тестирования;
• сервер или другое постоянно работающее устройство.

Python подходит для учебного проекта благодаря понятному синтаксису и наличию библиотек для работы с сообщениями, кнопками, датами и базами данных.

Как зарегистрировать бота через BotFather

Создание нового бота

Порядок регистрации:

1. Найдите официальный BotFather.
2. Откройте диалог.
3. Отправьте команду /newbot.
4. Укажите отображаемое имя.
5. Придумайте уникальное имя пользователя.
6. Сохраните полученный токен.

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

Как защитить токен

Токен дает доступ к управлению ботом. Его нельзя публиковать в коде, скриншотах или открытом репозитории.

Безопаснее хранить токен в переменной окружения:

TELEGRAM_BOT_TOKEN=ваш_токен

Если токен стал доступен посторонним, его следует заменить через BotFather.

Какие команды добавить

Минимальный набор пользовательских команд:

Команда	Назначение
/start	Запуск бота и выбор группы
/today	Расписание на сегодня
/tomorrow	Расписание на завтра
/week	События на неделю
/date	Расписание на выбранную дату
/group	Изменение группы
/notify	Настройка уведомлений
/help	Справка

Для администраторов можно добавить отдельные команды:

Команда	Назначение
/add	Добавление события
/edit	Изменение записи
/delete	Удаление события
/cancel	Отмена занятия

Перед выполнением административной команды приложение должно проверить права пользователя.

Как организовать меню с кнопками

Обычная клавиатура

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

• «Сегодня»;
• «Завтра»;
• «Неделя»;
• «Выбрать группу»;
• «Уведомления».

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

Inline-кнопки

Inline-кнопки прикрепляются к конкретному сообщению. С их помощью можно:

• выбрать день;
• переключить неделю;
• указать группу;
• открыть подробности;
• подтвердить удаление;
• перейти к следующей дате.

При нажатии приложение получает значение callback_data. Его необходимо проверять. Для сложных объектов лучше передавать короткий идентификатор, а остальные данные получать из базы.

Где хранить расписание

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

Способ	Преимущество	Ограничение
Данные в коде	Просто для демонстрации	Для изменений нужен перезапуск
JSON-файл	Не требуется база	Неудобен при одновременной записи
SQLite	Подходит для небольшого проекта	Не рассчитана на любую нагрузку
Серверная база	Удобна для развития	Требует отдельной настройки

Для небольшой рабочей версии подойдет SQLite.

Какие данные хранить о событии

Запись расписания может включать:

• идентификатор;
• группу;
• название;
• дату;
• время начала и окончания;
• преподавателя или ответственного;
• аудиторию или место;
• правило повторения;
• статус;
• комментарий.

Какие данные хранить о пользователе

Для работы обычно достаточно:

• идентификатора пользователя;
• идентификатора чата;
• выбранной группы;
• часового пояса;
• настройки уведомлений;
• роли.

Не следует собирать данные, которые не нужны для работы проекта.

Как представить учебное расписание

Расписание по дням недели

Этот вариант подходит, если занятия повторяются каждую неделю:

Понедельник

09:00 — Математика, аудитория 204
10:40 — Физика, аудитория 118
12:20 — История, аудитория 305

Расписание по календарным датам

Хранение по датам удобно, если график часто меняется. Такой подход упрощает работу с праздниками, переносами и разовыми мероприятиями.

Четные и нечетные недели

Для циклического графика необходимо определить:

• дату начала отсчета;
• правило нумерации недель;
• первую неделю цикла;
• обработку каникул и праздников.

Разовые изменения лучше хранить отдельно от основного повторяющегося расписания.

Как обработать выбор группы

Пользователь выбирает группу после запуска бота или через команду /group.

Последовательность:

1. Бот показывает доступные варианты.
2. Пользователь нажимает кнопку.
3. Приложение проверяет выбранное значение.
4. Группа сохраняется в базе.
5. Следующие запросы используют эту настройку.

Если групп много, не следует выводить их все одним сообщением. Можно использовать поиск, постраничный список или последовательный выбор факультета, курса и группы.

Как сделать расписание на неделю

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

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

При формировании необходимо учитывать:

• начало недели;
• выбранную группу;
• часовой пояс;
• переносы;
• отмены;
• сортировку по времени.

Как добавлять и изменять события

Редактирование через команды

Администратор может использовать команду:

/add группа дата начало окончание название

Такой способ требует строгой проверки формата. Ошибочная дата или пропущенное поле не должны сохраняться.

Пошаговый диалог

Более удобный вариант:

1. Выбрать группу.
2. Указать дату.
3. Ввести время.
4. Добавить название.
5. Указать аудиторию.
6. Проверить итог.
7. Подтвердить сохранение.

Проверка прав администратора

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

После изменения желательно сохранить дату, автора и тип действия.

Как учитывать отмены и переносы

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

Можно использовать статусы:

• запланировано;
• перенесено;
• отменено;
• заменено;
• завершено.

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

Как добавить уведомления

Просмотр расписания и автоматические уведомления — разные функции.

Для уведомлений нужно хранить:

• идентификатор чата;
• связанное событие;
• время отправки;
• часовой пояс;
• настройки пользователя;
• статус отправки.

Бот может:

• присылать утренний график;
• напоминать перед занятием;
• сообщать об отмене;
• отправлять расписание на завтра.

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

Как учитывать часовые пояса

Часовой пояс нужен для правильного определения текущего дня и времени уведомлений.

Время сервера может отличаться от времени пользователя. Поэтому приложение должно хранить регион пользователя или переводить даты в единый внутренний формат.

Например, если выбран регион Europe/Moscow, команда «Сегодня» должна определять дату по московскому времени независимо от расположения сервера.

Как запустить бота круглосуточно

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

Для постоянной работы нужны:

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

Получать обновления можно через long polling или webhook. Выбор зависит от архитектуры проекта.

Частые ошибки при разработке

Основные проблемы:

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

Каждая такая ошибка может ухудшить работу бота или привести к неправильному отображению данных.

Частые вопросы

Можно ли сделать бота-расписание без программирования?

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

Где лучше хранить расписание?

Для демонстрации подойдут данные в коде или JSON-файл. Для небольшого рабочего проекта удобнее SQLite. При росте количества пользователей может потребоваться отдельная серверная база.

Как сделать разные расписания для групп?

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

Как учитывать четные и нечетные недели?

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

Может ли бот сообщать об изменениях?

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

Будет ли бот работать после выключения компьютера?

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

Из каких частей состоит бот-расписание

Бот-расписание состоит из обработчиков команд, меню, хранилища событий, настроек пользователей и механизма формирования ответов. Для расширенной версии также понадобятся роли администраторов, обработка переносов, планировщик уведомлений и учет часовых поясов.

Начать лучше с выбора группы и команды /today. После проверки основной логики можно подключить базу данных, Inline-кнопки, недельное расписание и автоматические уведомления.