📚 Telegram Study Bot

Automated daily study schedule reminders & planning

🤖 Bot Status

Webhook: /api/telegram

Cron: /api/cron/schedule

✅ API endpoints ready

✅ Setup Checklist

  • ☐ Get bot token from BotFather
  • ☐ Add TELEGRAM_BOT_TOKEN to env
  • ☐ Set webhook URL in Telegram
  • ☐ Configure cron job (7 AM)

Features

🚀 Manual Start

Send /start anytime to begin planning (perfect for testing)

⏰ Daily 7 AM Reminder

Automatic prompts every morning to select your study subjects

📋 Custom Time Slots

Set your own study time slots (1-10 slots supported) with custom times

🎯 7 Subjects

Choose from: Aerodynamics, Space Dynamics, Propulsion, Structures, Flight Mechanics, Math, Aptitude

Quick Start (5 minutes)

1

Get Bot Token

Search "BotFather" on Telegram, type/newbot

2

Set Environment Variable

Add to .env.local:

TELEGRAM_BOT_TOKEN=your_token_here
3

Run Locally

Executenpm run dev

4

Test Your Bot

Search your bot on Telegram and click Start!

Get Started

🚀 Start Using the Bot

Ready to use the bot right away? Here's how:

  1. Find the bot on Telegram: @your_bot_username
  2. Send /start to begin
  3. Choose your study subjects for each time slot
  4. Get your personalized schedule instantly!

Pro tip: The bot remembers your previous choices and offers to reuse them for faster setup.

📦 GitHub Repository

View the source code, contribute, or deploy your own instance:

Author: @kayspace
⭐ View on GitHub🍴 Fork

Setup Guides

⚡

Quick Start

5-minute setup guide

📚

Full Guide

Complete setup & deployment

🕐

Cron Setup

Daily 7 AM reminders config

Environment Setup

Create a .env.local file:

TELEGRAM_BOT_TOKEN=your_bot_token_from_botfather
CRON_SECRET=your-secret-key-change-this

See .env.example for reference

Project Structure

lib/
├── telegram-bot.ts    # Telegram API wrapper
├── schedule.ts        # Schedule logic & storage
└── handlers.ts        # Message & button handlers

app/
└── api/
    ├── telegram/route.ts    # Webhook (receives messages)
    └── cron/schedule.ts     # Daily 7 AM trigger

Ready to Start? 🚀

Follow the Quick Start guide to get your bot running in 5 minutes

Message BotFather →