Telegram Web App for automatic contests and giveaways

Development of a professional platform for automatic contests and giveaways in Telegram through a Web App / Mini App.

The project is designed for Telegram channel owners, communities, bloggers, and businesses that need to run giveaways without manual participant verification, spreadsheets, and chaotic application collection. Users participate in contests directly within Telegram, while the administrator manages the giveaways through a convenient web interface.

What has been implemented:

• Telegram bot for user interaction;
• Telegram Web App / Mini App with a responsive interface;
• modern SPA interface for users and administrators;
• admin panel for creating, editing, and managing contests;
• participant registration via Telegram;
• subscription verification for Telegram channels through Bot API;
• integration with YouTube API / OAuth for subscription verification;
• protection against duplicate entries and manipulation;
• automatic winner selection;
• real-time status and counter updates via WebSocket;
• Redis Pub/Sub for real-time events;
• contest analytics and visual graphs;
• modern UI with animations, responsive layout, and effects;
• backend API for Web App functionality;
• Docker infrastructure for launching and deployment.

Technologies:

Python 3.11, FastAPI, aiogram 3.x, PostgreSQL, SQLAlchemy Async ORM, Redis, WebSocket, React 18, TypeScript, Vite, TailwindCSS, React Query, Framer Motion, Recharts, Docker, Docker Compose, Nginx, Telegram Bot API, Telegram Web App, YouTube API, OAuth.

Result:

A ready platform for conducting contests in Telegram: users participate through the Web App, the system automatically verifies conditions, updates statuses in real-time, stores participants in the database, and allows the administrator to transparently select a winner.

This solution is suitable for Telegram channels, bloggers, marketing campaigns, brands, educational projects, and businesses looking to automate contests and increase audience engagement.

#telegrambot #telegramwebapp #telegram #contest #giveaway #python #fastapi #aiogram #react #typescript #postgresql #redis #websocket #docker #backend #api #automation