👉 Deploy Your Telegram Bot in Minutes with Spring Boot + Docker (Free Template Inside)

Alexander Garanin — Thu, 31 Jul 2025 21:31:33 +0000

Build a fully functional Telegram bot with Webhook support using Java and Spring Boot — in just minutes. No complex setup, no boilerplate from scratch.

🚀 Why You’ll Love This Template

If you're a:

🔹 Java beginner exploring backend dev
🔹 Startup dev trying to ship an MVP quickly
🔹 Engineer needing a scalable foundation for bots

…this project helps you go from zero to bot in one evening.

🔍 Who Is This Guide For?

Beginner Java developers – who want to create a bot quickly without complex configuration.
Experienced programmers – who need a scalable bot that can integrate with enterprise systems.
Startup teams – when a fast MVP launch is critical.
Teachers and students - Spring Boot is a great fit for learning backend development.

💡 What’s Included

✅ Spring Boot 3 + Java 21

✅ /start and /calc command handling

✅ Webhook endpoint via REST

✅ Clean architecture (Controller / Service / Client)

✅ Dockerfile + docker-compose.yml

✅ GitHub Actions CI

✅ Clear folder structure and YAML config

💬 Sample Commands

/start
/calc 2 * 3
/calc 12 / 4

🟢 Quick Start in 2 Minutes

1. Clone the repository

git clone https://github.com/garaninsoft/telegram-bot-spring-boot-quickstart.git
cd telegram-bot-spring-boot-quickstart

2. Add your bot token

Open src/main/resources/application.yml and paste your Telegram Bot Token::

telegram:
  bot:
    token: your_token_here

3. Run the app via Docker 🐳 (recommended)

docker compose build
docker compose up

4. Set up Telegram Webhook

Use ngrok for local testing:

ngrok http 8080

Set the Webhook:

curl -X POST \
  https://api.telegram.org/bot<YOUR_BOT_TOKEN>/setWebhook \
  -d url=https://<your-ngrok-url>/webhook

✅ Done! Open Telegram, talk to your bot, and try /start.

📦 Get the Code

🔗 GitHub (Free)
💰Gumroad (Pro version with CI, Docker & frontend)

🧑‍💻 Support Option

Need help deploying to VPS, Railway, Render, or Fly.io?
Grab the Support pack to get:

1-on-1 help with setup
CI/CD pipeline setup via GitHub Actions
Docker mentoring
Telegram API questions answered

🔗 Let’s Connect

Telegram: @garanin_soft

DEV Community: Alexander Garanin