A modern, open-source, and developer-friendly Telegram bot designed to bring conversations to life through automated emoji reactions with a focus on performance, flexibility, and ease of deployment.

⚡ Fast • 🎨 Flexible • 🚀 Self-Hosted

📑 Table of Contents

• 🌸 Overview
• ✨ Features
• 🎥 Quick Start
• ⚙️ Configuration
• 🤖 Commands
• 🚀 Deployment
• 🤝 Contributing
• 📄 License
• 💬 Updates & Support
• 🙌 Credits
• 👨‍💻 Connect With Me

---

🌸 Overview

Auto Reaction Bot is a modern, open-source Telegram bot built to automatically react to messages across private chats, groups, and channels. Designed with flexibility, performance, and ease of use in mind, it provides a clean and developer-friendly solution for creating more engaging conversations through customizable emoji reactions.

💡 Simple to deploy, easy to customize, and built for reliable long-term use.

🤔 Why Choose This Project?

• ⚡ Boost Engagement — Keep conversations active with automatic emoji reactions.
• 🎨 Highly Customizable — Configure reaction emojis and behavior for every chat.
• 🚀 Deploy Anywhere — Run seamlessly on Cloudflare, Vercel, Docker, Railway, Render, VPS, and more.
• 🔧 Developer Friendly — Clean, well-structured codebase that's easy to customize and extend.

🔄 How It Works

1. 📩 Message Is Received — The bot detects new messages from private chats, groups, or channels.
2. ⚙️ Rules Are Evaluated — It checks chat settings, reaction configuration, permissions, and randomization.
3. 😊 Reaction Is Added — A suitable emoji reaction is applied automatically based on your configuration.
4. 🚀 Conversations Stay Engaging — Chats remain interactive and lively without manual effort.

---

✨ Features

• 🤖 Automatic Reactions — React to messages across private chats, groups, and channels.
• 🎨 Fully Customizable — Configure emojis, random levels, and chat-specific reaction settings.
• 👥 Multi-Bot Support — Run multiple bots from a single deployment with independent configurations.
• 🔒 Community Management — Force Subscribe, Welcome/Goodbye messages, and chat controls.
• 📊 Monitoring & Analytics — Live statistics, reaction logs, and chat activity insights.
• 📢 Broadcast & Administration — Broadcast messages and manage chats with powerful owner controls.
• 🛡️ Secure by Design — Webhook validation, rate limiting, and permission-based access.
• 📸 Rich User Experience — Interactive menus, photo messages, and inline buttons.
• ⚙️ Developer Friendly — Clean, modular, and easy-to-customize source code.

---

🎥 Quick Start

New to this project?

Watch this short video to understand what the bot is, why it's useful, how it works, explore its key features, and learn the required configuration before deployment.

📺 Watch on YouTube: Project Overview

---

📝 Configuration

Variable	Description
BOT_TOKEN	Telegram Bot Token
BOT_USERNAME	Telegram Bot Username
BOT_TOKENS	Multi-Bot Configuration
EMOJI_LIST	Default Reaction Emojis
RANDOM_LEVEL	Default Reaction Randomness
OWNER_ID	Telegram User ID
FORCE_SUBSCRIBE_CHANNELS	Force Subscribe Channels
RESTRICTED_CHATS	Restricted Chat IDs
BOT_PHOTO	Bot Photo
WEBHOOK_SECRET	Webhook Secret Token
UPSTASH_REDIS_REST_URL	Upstash Redis URL (Optional)
UPSTASH_REDIS_REST_TOKEN	Upstash Redis Token (Optional)
PORT	Server Port

📝 Notes

🤖 Multi-Bot Support Use BOT_TOKEN + BOT_USERNAME for a single bot, or BOT_TOKENS for multiple bots.

Format:

BOT_TOKENS=token1:BotOne,token2:BotTwo

🎲 Random Level Accepts values from 0–10.

• 0 → Always react
• 5 → Balanced (Recommended)
• 10 → Very rare reactions

🔒 Force Subscribe Supports multiple channels. Use @username for public channels and the private channel ID for private channels.

Format:

FORCE_SUBSCRIBE_CHANNELS=@PublicChannel,-1001234567890

💾 Persistent Storage Configure UPSTASH_REDIS_REST_URL and UPSTASH_REDIS_REST_TOKEN for persistent storage.

🌐 Create a free database: https://console.upstash.com

🛡️ Webhook Secret If WEBHOOK_SECRET is not set, a secure secret is generated automatically.

📚 Setup Guides

• 🔑 Telegram API ID & API Hash — Watch Tutorial
• 🤖 Bot Token — Watch Tutorial

---

🎮 Commands

👤 User Commands

/start - Start the bot and view the main menu.
/help - Display all available commands.
/about - Learn more about the project.
/ping - Check the bot's response time.
/stats - View bot statistics.
/reactions - View configured reaction emojis.
/donate - Support the development of the project.

👥 Chat Admin Commands

/pause - Pause reactions in the current chat.
/resume - Resume reactions in the current chat.
/welcome - Configure welcome messages.
/goodbye - Configure goodbye messages.
/setreactions - Configure reaction emojis.
/randomlevel - Set the reaction frequency.

🔒 Owner Commands

/log - View recent logs.
/chats - View connected chats.
/leave - Remove the bot from a chat.
/restrict - Restrict a chat.
/unrestrict - Remove chat restrictions.
/broadcast - Broadcast messages.
/setwebhook - Configure the webhook.

🚀 Deployment

Deploy Auto Reaction Bot on Cloudflare Workers or Vercel using the official one-click deployment buttons below.

Tip

Ensure your deployment is live before configuring the webhook.

📡 Webhook Setup

🤖 Single Bot

Open the URL below after replacing the placeholders with your own values.

https://api.telegram.org/bot<BOT_TOKEN>/setWebhook?url=<DEPLOYMENT_URL>&secret_token=<WEBHOOK_SECRET>

Example

https://api.telegram.org/bot1234567890:ABCDEF/setWebhook?url=https://mybot.workers.dev&secret_token=123

🤖🤖 Multi Bot

If you're using BOT_TOKENS, open the endpoint below after deployment.

https://your-domain.com/set-webhooks

Example

https://mybot.workers.dev/set-webhooks

Each bot automatically receives its own webhook endpoint.

https://mybot.workers.dev/bot/AutoReactionBot
https://mybot.workers.dev/bot/MySecondBot

---

🤝 Contributing

Contributions are always appreciated! ❤️

🐞 Report Bugs	💡 Suggest Features	🚀 Submit PRs
Found an issue?	Have an idea?	Ready to contribute?
Open Issue	Open Discussion	Fork & Submit

Important

Before opening an issue, please ensure you're using the latest version and have followed the deployment guide.

---

📄 License

Warning

This project is intended strictly for educational purposes only. The author is not responsible for any misuse or abuse. Please comply with all applicable laws and the terms of any third-party services. If you modify or redistribute this project, please provide proper credit to the original repository.

See the LICENSE file for complete details.

---

🫂 Updates & Support

---

🙌 Credits

This repository is based on the original work of the following developers:

• Original Developer: Shinei Nouzen
• Inspired by: Auto-Reaction-Bot by Malith Rukshan

Note

This repository is maintained by TechifyBots, with improvements to the project presentation and user experience.

👤 Connect With Me

Rahul Dhankhar
_{Open Source Maintainer • TechifyBots}