Serverless Telegram Bot: Deploy Webhook Bot on Cloudflare Workers

Project Specifications & Benefits

• $0 Hosting Infrastructure: Cloudflare Workers Free Tier covers 100,000 CPU requests every day.
• Zero Maintenance: Serverless code requires no OS updates, port configurations, or daemon managers (like PM2).
• Secure Webhook Pipeline: Encrypted HTTPS endpoints protect incoming metadata payload transfers.
• Ultra-Fast Execution: Edge runtime architecture routes and processes transactions in milliseconds.

Architecture: Webhook routing on Edge Compute

Unlike polling loop bots that constantly query Telegram's servers, webhook bots wait sleepily until a user triggers a message. Telegram's servers then send a POST request containing the JSON update to Cloudflare's edge handler, which executes the code and replies immediately:

Serverless execution diagram: Requests route from clients through Telegram API to Cloudflare edges.

Step 1: Creating a Telegram Bot and Obtaining the API Token

Use the official Telegram BotFather to register a new bot instance and generate an authentication HTTP API token:

Telegram chat interface displaying token credentials returned by BotFather.

1. Open Telegram and search for the user @BotFather.
2. Start a chat session and send the command: /newbot.
3. Follow the prompts to enter a bot name and a unique username ending in _bot.
4. Copy the generated HTTP API access token (e.g. 123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ). Keep this token completely private!

Step 2: Writing the Serverless Webhook Handler Code

Open your VS Code editor, create a JavaScript file named index.js, and paste the code block below. This serverless function intercepts incoming POST payloads from Telegram, parses user messages, and pushes replies via HTTPS fetch requests:

JavaScript router code inside VS Code configured to process Telegram message events.

// index.js

export default {

 async fetch(request, env) {

 if (request.method !== "POST") {

 return new Response("Send POST requests only.", { status: 405 });

 }



 try {

 const payload = await request.json();

 if (payload.message) {

 const chatId = payload.message.chat.id;

 const text = payload.message.text || "";



 // Construct simple echo/reply logic

 let replyText = `You said: "${text}". Welcome to Serverless Telegram!`;

 if (text.startsWith("/start")) {

 replyText = "Hello! I am running 24/7 serverless on Cloudflare Workers edge network.";

 }



 // Call Telegram API to send message back

 const botToken = env.TELEGRAM_TOKEN;

 const url = `https://api.telegram.org/bot${botToken}/sendMessage`;

 await fetch(url, {

 method: "POST",

 headers: { "Content-Type": "application/json" },

 body: JSON.stringify({

 chat_id: chatId,

 text: replyText,

 }),

 });

 }

 return new Response("OK", { status: 200 });

 } catch (err) {

 return new Response(err.toString(), { status: 500 });

 }

 }

};

Step 3: Deploying to Cloudflare Workers via Wrangler CLI

Use the official Cloudflare CLI tool (Wrangler) to publish your serverless worker file to the internet edge:

# Initialize a new wrangler project

npx wrangler init



# Deploy the code file to the cloud

npx wrangler deploy

Terminal output showing Wrangler CLI completing deployment to Cloudflare edges.

Upon successful deployment, copy the output URL (e.g. https://my-telegram-bot.yourusername.workers.dev). This address is your public Webhook URL.

npx wrangler secret put TELEGRAM_TOKEN

Step 4: Activating the Telegram Webhook Connection

Instruct Telegram's servers to route incoming bot events directly to your Cloudflare Worker URL. Run this API request URL inside your web browser or terminal shell:

https://api.telegram.org/bot[YOUR_TELEGRAM_TOKEN]/setWebhook?url=[YOUR_WORKER_URL]

Telegram Bot Hosting Performance Comparison

Frequently Asked Questions (FAQs)

Final Verdict

Deploying Telegram Webhook handlers to Cloudflare Workers delivers an enterprise-grade bot backend for $0. Eliminate active VPS bills while enjoying automated scaling and zero server maintenance overhead.

Disclaimer: This article is strictly for educational purposes and does not constitute technical or financial advice. Always adhere to platform usage terms.