SuperAPI AI 工具集

telegram-bot-builder

通用与其它

查看项目

更新于 10-16 05:42

技能介绍

用途:帮助设计并实现真正被日常使用的 Telegram 机器人,强调机器人应像有用的助手而非笨拙界面,并覆盖 Telegram 生态中可行、流行与可盈利的做法。

主要能力:Telegram Bot API、机器人架构、命令设计、内联键盘、机器人变现、用户引导、机器人分析与 Webhook 管理。

架构与栈:可选 Node.js 的 telegraf(多数项目)或 grammY(TypeScript、现代),Python 的 python-telegram-bot(快速原型)或 aiogram(异步、可扩展)。给出基于 telegraf 的基础初始化示例,包含 bot.start、bot.help、bot.on('text')、bot.launch() 以及通过 SIGINT/SIGTERM 优雅关闭。建议目录结构:src/bot.js、commands、handlers、keyboards、middleware、services,以及 .env 与 package.json。

交互:内联键盘通过 Markup.inlineKeyboard 与 Markup.button.callback 构建菜单、确认、分页等,bot.action 处理回调并可用 answerCbQuery 与 editMessageText 更新。常见键盘模式包括单列菜单、多列 Yes/No 与分页、网格分类选择、URL 按钮。文中给出分页键盘与使用限额函数的代码片段。

变现:模式包括 Freemium、订阅、按次付费、广告、联盟;通过 replyWithInvoice 创建发票,用 provider_token、currency、prices 等参数,并由 successful_payment 激活高级权限。示例 Freemium 为免费每日 10 次、付费解锁无限制与高级功能。

反模式:避免阻塞操作(应先确认再后台处理并发送更新)、缺少错误处理(应使用全局错误处理、优雅提示、日志与限流)、骚扰式消息(应尊重注意力、合并消息、允许通知控制)。

适用场景:需要创建具备自然对话、可维护结构并可能商业化的 Telegram 机器人项目。

限制:资料未提供具体部署平台、价格、效果数据或完整生产配置,部分内容需结合实际项目自行验证。