🚀 Project #1

🤖 Echo Bot – Copies your message and sends it back to you.
🧠 Lesson:
• How to get a Bot Token
• Setting up a Webhook
• Your first deployment FREE on Vercel

👀 Try Demo: @project1_echobot

👾👾👾 Git Repo project 1 👾👾👾

This project is designed to be hosted on Vercel (which offers a free tier) using GitHub. Since Vercel uses "Serverless Functions," the code is slightly different from a standard bot that runs on your computer. We will use Flask to handle the web requests.

📂 Project Files

You need to create exactly three files.

1. requirements.txt
This tells Vercel which libraries to install.

python-telegram-bot
Flask

2. vercel.json
This configuration file tells Vercel how to handle the Python code.

{
  "version": 2,
  "builds": [
    {
      "src": "api/index.py",
      "use": "@vercel/python"
    }
  ],
  "routes": [
    {
      "src": "/(.*)",
      "dest": "api/index.py"
    }
  ]
}

3. api/index.py
Note: You must create a folder named api and put this file inside it. This is the brain of the bot.

from flask import Flask, request
from telegram import Update, Bot
from telegram.ext import Application, CommandHandler, MessageHandler, filters, ContextTypes
import asyncio
import os

app = Flask(__name__)

# 1. Get the Token from Vercel Environment Variables
TOKEN = os.environ.get("TOKEN")

# 2. Define the Bot Logic
async def start(update: Update, context: ContextTypes.DEFAULT_TYPE):
    await update.message.reply_text("Hello! I am an Echo Bot. I repeat everything you say.")

async def echo(update: Update, context: ContextTypes.DEFAULT_TYPE):
    # This is where the echo magic happens
    user_text = update.message.text
    await update.message.reply_text(f"You said: {user_text}")

# 3. Setup the Application (Using the async ApplicationBuilder)
# We build it once to handle the update
async def main(update_json):
    application = Application.builder().token(TOKEN).build()
    
    # Add handlers
    application.add_handler(CommandHandler("start", start))
    application.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND, echo))
    
    # Process the update
    # We manually initialize and process because we are in a serverless environment
    await application.initialize()
    update = Update.de_json(update_json, application.bot)
    await application.process_update(update)
    await application.shutdown()

# 4. The Webhook Route (What Vercel runs)
@app.route("/", methods=["POST"])
def webhook():
    if request.method == "POST":
        # Get the JSON data sent by Telegram
        update_json = request.get_json(force=True)
        
        # Run the async main function
        asyncio.run(main(update_json))
        
        return "ok"
    return "Bot is running!"

🚀 The "Ezy" Deployment Guide

Follow these steps to put your bot online forever, for free.

Phase 1: Get Your Keys
1. Open Telegram and search for BotFather.
2. Send the command /newbot.
3. Give it a name and a username.
4. Copy the API Token (It looks like 123456:ABC-DEF1234...). Keep this safe!

Phase 2: Setup GitHub
1. Log in to GitHub and create a New Repository.
2. Name it echo-bot (set it to Public or Private).
3. Upload the files mentioned above:
-  requirements.txt
-  vercel.json
-  api/index.py (Make sure index.py is inside a folder named api).

Phase 3: Deploy to Vercel
1. Go to Vercel.com and log in with GitHub.
2. Click "Add New" -> "Project".
3. Select your echo-bot repository and click Import.
4. Crucial Step: Scroll down to Environment Variables.
-  Name: TOKEN
-  Value: (Paste your Bot API Token from Phase 1)
-  Click Add.
5. Click Deploy. Wait for it to finish (you will see confetti!).
6. Once deployed, click on the Domain link (e.g., https://echo-bot.vercel.app). It should say "Bot is running!".
7. Copy this URL.

Phase 4: Connect the Wires (Set Webhook)
Now we need to tell Telegram to send messages to your Vercel URL.
1. Open your web browser.
2. Paste this link into the address bar, but replace the placeholders:
https://api.telegram.org/bot<YOUR_BOT_TOKEN>/setWebhook?url=<YOUR_VERCEL_URL>
Example: https://api.telegram.org/bot12345:ABC.../setWebhook?url=https://echo-bot.vercel.app
3. Hit Enter.
4. You should see a message: {"ok":true, "result":true, "description":"Webhook was set"}.

🎉 Done! Go to your bot in Telegram and say "Hello".

▎🚀 Deploy Your Telegram Bot for FREE

▎Using GitHub + Vercel | Ezy Bots

Want to run your Telegram bot 24/7 for free? This guide will walk you through deploying your Telegram bot using GitHub and Vercel.

▎Perfect For:

• 🤖 Telegram bots (Node.js)
• 💡 Beginners vibe coders
• 💸 Zero hosting costs

---

▎🧠 Requirements

Before you start, ensure you have:
• A Telegram Bot Token (from @BotFather)
• A GitHub account (free)
• A Vercel account (free)
• Your bot code (Node.js recommended)

---

▎📁 Step 1: Prepare Your Bot Code

Your project structure should look like this:

telegram-bot/
├── api/
│   └── index.js
├── package.json
└── vercel.json

▎🔹 api/index.js (Main Bot File)

import fetch from "node-fetch";

export default async function handler(req, res) {
  if (req.method !== "POST") {
    return res.status(200).send("Telegram Bot Running 🚀");
  }

  const TELEGRAM_TOKEN = process.env.BOT_TOKEN;
  const update = req.body;

  if (update.message) {
    const chatId = update.message.chat.id;
    const text = update.message.text;

    await fetch(https://api.telegram.org/bot${TELEGRAM_TOKEN}/sendMessage, {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify({
        chat_id: chatId,
        text: 🤖 Ezy Bots says:\nYou said: ${text},
      }),
    });
  }

  res.status(200).json({ ok: true });
}

▎🔹 package.json

{
  "name": "telegram-bot",
  "version": "1.0.0",
  "type": "module",
  "dependencies": {
    "node-fetch": "^3.3.2"
  }
}

▎🔹 vercel.json

{
  "functions": {
    "api/index.js": {
      "runtime": "nodejs18.x"
    }
  }
}

---

▎🌐 Step 2: Push Code to GitHub

1. Create a new GitHub repository.
2. Upload all files.
3. Ensure the repo is public or private (both work).

---

▎☁️ Step 3: Deploy on Vercel

1. Go to Vercel.
2. Click New Project.
3. Import your GitHub repo.
4. Add Environment Variable:
– BOT_TOKEN = YOUR_TELEGRAM_BOT_TOKEN
5. Click Deploy.

🎉 Your bot backend is now LIVE!

---

▎🔗 Step 4: Set Telegram Webhook

Open your browser and replace values:

https://api.telegram.org/bot<BOT_TOKEN>/setWebhook?url=https://YOUR-VERCEL-APP.vercel.app/api

Example:

https://api.telegram.org/bot123456:ABC/setWebhook?url=https://ezy-bots.vercel.app/api

If you see:

{"ok":true,"result":true}

✅ Webhook connected successfully!

---

▎🤖 Step 5: Test Your Bot

1. Open Telegram.
2. Send /start.
3. Send any message.

Your bot replies instantly! 🚀

---

▎⚠️ FREE PLAN LIMITATIONS (IMPORTANT)

Vercel Limitations:
• ⏱️ Serverless timeout (~10 seconds)
• 📉 Limited function executions per month
• ❌ No long background tasks

Telegram Webhook Limitations:
• ❌ No long polling
• ✅ Best for chat bots, AI bots, quiz bots

---

▎🧠 Tips (Ezy Bots)

• Use Supabase / Firebase for database.
• Always use webhooks, not polling.
• Keep responses fast (<3 seconds).
• Log errors with console.log().

---

With GitHub + Vercel, host Telegram bots:
• 💸 100% Free
• ⚡️ Fast
• 🧠 Beginner friendly

🔥 Follow “ @EzyBots ” for more Telegram Bot Guides!

▎🎉 CapCut Pro v15.3.0 - Unlock Your Creativity! ✨

Download Here: CapCut Pro v15.3.0

▎🚀 MOD Features:

• No Login Required
• Access to Templates, Effects,  Library
• Export Videos up to 1080P (2K  4K not supported)
• Ad-Free Experience
• Unlocks AI Tools  Hidden Features

▎⚠️ Disclaimer:

This modified app is shared for convenience. Original creator: 𝘋𝘚 𝘔𝘖𝘋𝘚.

Unleash your editing skills today! 🎬✨

▎CAPCUT PRO v16.0.0 ✨

Download Link: 
CapCut Pro v16.0.0

Mod Features:
• No login required
• Access to templates, effects, and library
• Export videos up to 4K
• Ad-free experience
• Unlocks AI tools and hidden features

Disclaimer: 
Originally created by 𝘋𝘚 𝘔𝘖𝘋𝘚.

🚀 Project #2 (Cloudflare Edition)

🤖 Tiny Link Bot – Send any long URL, and it instantly replies with a short, shareable link.

🧠 Lesson:
• Cloudflare Workers (JavaScript)
• Fetching external APIs (is.gd)
• Serverless & 100% Free with Cloudflare

👀 Try Demo: @TinyLink_P2Bot

👇 Code & Guide below

▎🚀 Let's Build: Project 2 (Tiny Link Bot)

Here is the complete code and guide for the URL Shortener Bot. This is purely for Cloudflare Workers (no Python, no Vercel).

▎1. The Code (worker.js)

You only need this one file.

export default {
  async fetch(request, env, ctx) {
    // 1. Handle the Webhook (POST request from Telegram)
    if (request.method === "POST") {
      const payload = await request.json();
      
      // Check if it's a message
      if (payload.message && payload.message.text) {
        const chatId = payload.message.chat.id;
        const text = payload.message.text;

        // If command is /start
        if (text === "/start") {
          await sendTelegramMessage(chatId, "🔗 Send me any long URL, and I will shorten it!", env.BOT_TOKEN);
        } 
        // If it looks like a URL (basic check)
        else if (text.startsWith("http")) {
          // Call the Shortener API
          const shortUrl = await shortenUrl(text);
          await sendTelegramMessage(chatId, ✅ Here is your short link:\n${shortUrl}, env.BOT_TOKEN);
        } 
        else {
          await sendTelegramMessage(chatId, "⚠️ That doesn't look like a link. Send a URL starting with http...", env.BOT_TOKEN);
        }
      }
      return new Response("OK");
    }
    
    // 2. Simple landing page for the browser
    return new Response("Bot is running on Cloudflare Workers! 🚀");
  },
};

// --- Helper Functions ---

// Function to send message to Telegram
async function sendTelegramMessage(chatId, text, token) {
  const url = https://api.telegram.org/bot${token}/sendMessage;
  await fetch(url, {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ chat_id: chatId, text: text }),
  });
}

// Function to shorten URL using is.gd (Free, no API key needed)
async function shortenUrl(longUrl) {
  const apiUrl = https://is.gd/create.php?format=json&url=${encodeURIComponent(longUrl)};
  const response = await fetch(apiUrl);
  const data = await response.json();
  
  if (data.shorturl) {
    return data.shorturl;
  } else {
    return "Error shortening link.";
  }
}

▎2. Deployment Guide

You can copy this into your channel. It explains how to deploy using the browser (easiest for beginners).

▎☁️ Project: Cloudflare Link Shortener Bot

Run a bot 100% free on Cloudflare Workers. No servers, just one file!

▎📂 Step 1: Create the Worker

1. Go to dash.cloudflare.com and sign up/login.
2. Click Compute & AI -> Workers Pages -> Create Application -> Start with hello world.
3. Click Create Worker -> Deploy.
4. Now click Edit Code.

▎📝 Step 2: The Code

1. Delete everything in the left side editor.
2. Paste the code above.

3. Click Save and Deploy (top right).

▎🔑 Step 3: Add Bot Token

1. Go back to your Worker's dashboard (click the back arrow).
2. Go to Settings -> Variables.
3. Click Add Variable.
– Name: BOT_TOKEN
– Value: (Paste your Token from @BotFather)
– Click Deploy (or Save).

▎🔗 Step 4: Connect Webhook

Copy your Worker URL (e.g., https://crimson-rain.user.workers.dev).
Replace the details in this link and open it in your browser:

https://api.telegram.org/bot<YOUR_TOKEN>/setWebhook?url=<YOUR_WORKER_URL>

✅ Done! Send a link to your bot to test it.

#EzyBot #Cloudflare #JavaScript

🚀 Project #3 (Cloudflare Edition)

⏳ EzyBots Countdown – Set your exam date, and it automatically sends you a daily motivational poster. You can even upload your own custom wallpaper!

🧠 Lesson:
• Cloudflare KV (Database to save dates)
• Cron Triggers (Scheduled Daily Tasks)
• Sending Photos via Telegram API
• Serverless & 100% Free

👀 Try Demo: @countdown3_bot

👇 Code & Guide below

🚀 Let's Build: Project 2 (The Ultimate Exam Countdown)

Here is the complete code and guide for the EzyBots Countdown Bot. This bot remembers your exam date, sends you a daily progress poster, and even lets you set a custom motivational wallpaper.

This runs 100% on Cloudflare Workers (No servers, No Python).

▎1. The Code (worker.js)

You only need this one file. Delete the existing code and paste this in:
https://t.me/EzyBots/33

▎2. Deployment Guide

This bot uses KV Storage (to save dates) and Cron Triggers (to send daily messages). Follow these steps carefully!

☁️ Project: EzyBots Exam Countdown

📂 Step 1: Create the Worker

1. Go to dash.cloudflare.com.
2. Navigate to Workers & Pages -> Create Application -> Create Worker.
3. Name it ezybots-countdown -> Deploy.
4. Click Edit Code.
5. Delete the existing code and paste the code above.
6. Click Save and Deploy.

🗄 Step 2: Create Database (KV)

Since this bot needs memory, we need a KV Namespace.

1. Go back to the main Cloudflare Dashboard (Workers & Pages).
2. Click KV (on the left sidebar) -> Create a Namespace.
3. Name it: EzyBotDB -> Click Add.
4. Go back to your Worker (ezybots-countdown) -> Bindings.
5. Scroll down to KV Namespace Bindings.
6. Click Add Binding:
   – Variable name: DB (Must be exactly this!)
   – KV Namespace: Select EzyBotDB.
7. Click Save and Deploy.

🔑 Step 3: Add Bot Token

Still in Settings -> Variables.

1. Click Add Variable (Environment Variables).
2. Name: TG_TOKEN
3. Value: (Paste your Token from @BotFather)
4. Click Deploy.

⏰ Step 4: Set Daily Timer

1. Go to Settings -> Triggers.
2. Click Add Cron Trigger.
3. Select Daily or type 30 23 * * *  (This sends the poster at (UTC+5:30) 5:00 AM in Sri Lanka).
4. Click Add Trigger.

🔗 Step 5: Connect Webhook

Replace the details and run this in your browser to turn the bot on:



https://api.telegram.org/bot<YOUR_TOKEN>/setWebhook?url=<YOUR_WORKER_URL>

✅ Done! Type /start to set your date. Type /setimg to upload your own custom wallpaper!

#EzyBots #Cloudflare #Coding #StudentHacks