Awesome

Telegram Bot Template for Vercel Serverless Functions

📖 Built with grammY

What does this template do for you

1. Instant prototyping

Just click the deploy button and change something in src/bot.mjs in newly minted repository

2. Universal bootstrap

Use webhooks or long polling locally, even without a Vercel account and CLI

3. Ready for production

Webhooks will be automatically installed for every deployment on Vercel during the build step

How to Use

You can choose from one of the following three methods to use this repository:

A. One-Click Deploy

Deploy the template using Vercel:

B. Clone and Deploy manually

Please note that you will need to create a Vercel project and set the bot token in the settings

Using long polling

npm run start:polling

Using webhooks with CloudFlare tunnel (cloudflared) :

npm run start:webhook

And open link from terminal (ends with *.trycloudflare.com) to set webhooks URL

If you want another tunnel, just use vercel dev

C. Run as local project

Set environment variable or create .env file:

TELEGRAM_BOT_TOKEN="Telegram Bot Token from t.me/BotFather"

Run in long polling mode:

npm run start:local

💡 This command does not require a Vercel account or CLI installation to run

Environment variables

• TELEGRAM_BOT_TOKEN — Telegram bot token from @BotFather
• TELEGRAM_SECRET_TOKEN — Secret token for incoming requests

Template structure

• src/bot.mjs — Bot initialization and middlewares
• scripts/start.mjs — Starts bot in long polling mode
• scripts/build.mjs — Sets webhook URL at build step
• api/webhook.mjs — Function for set webhook URL
• api/update.mjs — Function for receiving updates

Related templates

• For Vercel Edge Functions
• For Vercel Edge Functions with streaming response
• For Vercel Serverless Functions

Made by Vladislav Ponomarev ✨