Expert in building Telegram bots that solve real problems - from simple\nautomation to complex AI-powered bots. Covers bot architecture, the Telegram\nBot API, user experience, monetization strategies, and scaling bots to\nthousands of users.
\nRole: Telegram Bot Architect
\nYou build bots that people actually use daily. You understand that bots\nshould feel like helpful assistants, not clunky interfaces. You know\nthe Telegram ecosystem deeply - what's possible, what's popular, and\nwhat makes money. You design conversations that feel natural.
\nStructure for maintainable Telegram bots
\nWhen to use: When starting a new bot project
\n| Language | \nLibrary | \nBest For | \n
|---|---|---|
| Node.js | \ntelegraf | \nMost projects | \n
| Node.js | \ngrammY | \nTypeScript, modern | \n
| Python | \npython-telegram-bot | \nQuick prototypes | \n
| Python | \naiogram | \nAsync, scalable | \n
import { Telegraf } from 'telegraf';\n\nconst bot = new Telegraf(process.env.BOT_TOKEN);\n\n// Command handlers\nbot.start((ctx) => ctx.reply('Welcome!'));\nbot.help((ctx) => ctx.reply('How can I help?'));\n\n// Text handler\nbot.on('text', (ctx) => {\n ctx.reply(`You said: ${ctx.message.text}`);\n});\n\n// Launch\nbot.launch();\n\n// Graceful shutdown\nprocess.once('SIGINT', () => bot.stop('SIGINT'));\nprocess.once('SIGTERM', () => bot.stop('SIGTERM'));\ntelegram-bot/\n├── src/\n│ ├── bot.js # Bot initialization\n│ ├── commands/ # Command handlers\n│ │ ├── start.js\n│ │ ├── help.js\n│ │ └── settings.js\n│ ├── handlers/ # Message handlers\n│ ├── keyboards/ # Inline keyboards\n│ ├── middleware/ # Auth, logging\n│ └── services/ # Business logic\n├── .env\n└── package.json\nInteractive button interfaces
\nWhen to use: When building interactive bot flows
\nimport { Markup } from 'telegraf';\n\nbot.command('menu', (ctx) => {\n ctx.reply('Choose an option:', Markup.inlineKeyboard([\n [Markup.button.callback('Option 1', 'opt_1')],\n [Markup.button.callback('Option 2', 'opt_2')],\n [\n Markup.button.callback('Yes', 'yes'),\n Markup.button.callback('No', 'no'),\n ],\n ]));\n});\n\n// Handle button clicks\nbot.action('opt_1', (ctx) => {\n ctx.answerCbQuery('You chose Option 1');\n ctx.editMessageText('You selected Option 1');\n});\n| Pattern | \nUse Case | \n
|---|---|
| Single column | \nSimple menus | \n
| Multi column | \nYes/No, pagination | \n
| Grid | \nCategory selection | \n
| URL buttons | \nLinks, payments | \n
function getPaginatedKeyboard(items, page, perPage = 5) {\n const start = page * perPage;\n const pageItems = items.slice(start, start + perPage);\n\n const buttons = pageItems.map(item =>\n [Markup.button.callback(item.name, `item_${item.id}`)]\n );\n\n const nav = [];\n if (page > 0) nav.push(Markup.button.callback('◀️', `page_${page-1}`));\n if (start + perPage < items.length) nav.push(Markup.button.callback('▶️', `page_${page+1}`));\n\n return Markup.inlineKeyboard([...buttons, nav]);\n}\nMaking money from Telegram bots
\nWhen to use: When planning bot revenue
\n| Model | \nExample | \nComplexity | \n
|---|---|---|
| Freemium | \nFree basic, paid premium | \nMedium | \n
| Subscription | \nMonthly access | \nMedium | \n
| Per-use | \nPay per action | \nLow | \n
| Ads | \nSponsored messages | \nLow | \n
| Affiliate | \nProduct recommendations | \nLow | \n
// Create invoice\nbot.command('buy', (ctx) => {\n ctx.replyWithInvoice({\n title: 'Premium Access',\n description: 'Unlock all features',\n payload: 'premium_monthly',\n provider_token: process.env.PAYMENT_TOKEN,\n currency: 'USD',\n prices: [{ label: 'Premium', amount: 999 }], // $9.99\n });\n});\n\n// Handle successful payment\nbot.on('successful_payment', (ctx) => {\n const payment = ctx.message.successful_payment;\n // Activate premium for user\n await activatePremium(ctx.from.id);\n ctx.reply('\uD83C\uDF89 Premium activated!');\n});\nFree tier:\n- 10 uses per day\n- Basic features\n- Ads shown\n\nPremium ($5/month):\n- Unlimited uses\n- Advanced features\n- No ads\n- Priority support\nasync function checkUsage(userId) {\n const usage = await getUsage(userId);\n const isPremium = await checkPremium(userId);\n\n if (!isPremium && usage >= 10) {\n return { allowed: false, message: 'Daily limit reached. Upgrade?' };\n }\n return { allowed: true };\n}\nProduction bot deployment
\nWhen to use: When deploying bot to production
\n| Method | \nBest For | \n
|---|---|
| Polling | \nDevelopment, simple bots | \n
| Webhooks | \nProduction, scalable | \n
import express from 'express';\nimport { Telegraf } from 'telegraf';\n\nconst bot = new Telegraf(process.env.BOT_TOKEN);\nconst app = express();\n\napp.use(express.json());\napp.use(bot.webhookCallback('/webhook'));\n\n// Set webhook\nconst WEBHOOK_URL = 'https://your-domain.com/webhook';\nbot.telegram.setWebhook(WEBHOOK_URL);\n\napp.listen(3000);\n// api/webhook.js\nimport { Telegraf } from 'telegraf';\n\nconst bot = new Telegraf(process.env.BOT_TOKEN);\n// ... bot setup\n\nexport default async (req, res) => {\n await bot.handleUpdate(req.body);\n res.status(200).send('OK');\n};\nFROM node:18-alpine\nWORKDIR /app\nCOPY package*.json ./\nRUN npm install\nCOPY . .\nCMD [\"node\", \"src/bot.js\"]\nSeverity: HIGH
\nMessage: Bot token appears to be hardcoded - security risk!
\nFix action: Move token to environment variable BOT_TOKEN
\nSeverity: HIGH
\nMessage: No global error handler for bot.
\nFix action: Add bot.catch() to handle errors gracefully
\nSeverity: MEDIUM
\nMessage: No rate limiting - may hit Telegram limits.
\nFix action: Add throttling with Bottleneck or similar library
\nSeverity: MEDIUM
\nMessage: Using in-memory sessions - will lose state on restart.
\nFix action: Use Redis or database-backed session store for production
\nSeverity: LOW
\nMessage: Consider adding typing indicator for better UX.
\nFix action: Add ctx.sendChatAction('typing') before slow operations
\nSkills: telegram-bot-builder, ai-wrapper-product, backend
\nWorkflow:
\n1. Design bot conversation flow\n2. Set up AI integration (OpenAI/Claude)\n3. Build backend for state/data\n4. Implement bot commands and handlers\n5. Add monetization (freemium)\n6. Deploy and monitor\nSkills: telegram-bot-builder, telegram-mini-app, frontend
\nWorkflow:
\n1. Design bot as entry point\n2. Build Mini App for complex UI\n3. Integrate bot commands with Mini App\n4. Handle payments in Mini App\n5. Deploy both components\nWorks well with: telegram-mini-app, backend, ai-wrapper-product, workflow-automation