SuperAPI AI 工具集

telegram-bot-builder

智能体与模型

查看项目

更新于 10-16 08:40

技能介绍

用途:帮助开发者(或智能体)构建面向以色列市场的 Telegram 机器人,围绕 grammY、Telegraf、python-telegram-bot 三种框架及其 Bot API 差异提供指导。

主要能力:

  1. 框架选择:按运行时、部署目标与 Bot API 版本比较。grammY v1.46.0(TypeScript/JS,Bot API v10.3,原生支持 Vercel、Cloudflare Workers、Deno Deploy 等);Telegraf v4.16.3(TypeScript/JS,停在 Bot API 7.1);python-telegram-bot v22.8(Python 3.10+,Bot API 10.0)。需要 10.x 新特性(Stars 订阅、Gifts、Bot Business、Mini Apps 2.0、临时消息)时建议用 grammY。
  2. Bot API 10.3 变化:临时消息改用 ephemeral_message_parameters 对象;键盘新增 disabled/DisabledButton 与 force_reply;新增 can_send_welcome_messages;草稿生成可停止(can_stop/keep_on_stop、MessageGenerationStopped)。
  3. 基础模式:BotFather 创建与配置、token 安全(环境变量、/token 轮换)、群组隐私模式解决方案;内联键盘与 callback data 规则(最多 64 字节,希伯来语每字符 2 字节);中间件与多步对话流程。
  4. webhook 与轮询:二者互斥,未送达的更新 24 小时后过期;allowed_updates 默认排除 chat_member、message_reaction、message_reaction_count。webhook 需 HTTPS 与 443/80/88/8443 端口,并用 secret_token 校验。
  5. 希伯来语处理:RTL 双向文本、方向标记、HTML 解析模式与拉丁命令加希伯来触发词、希伯来语回复键盘。
  6. 限流:约 30 条/秒群发、单聊 1 条/秒、群组 20 条/分钟;付费广播需 100,000 Stars 余额与 100,000 月活用户。

使用方式:安装对应框架(npm install grammy、npm install telegraf、pip install python-telegram-bot),参照 quickstarts 脚手架,配置错误处理与从环境读取 token。

限制:部分细节(如参考资料链接中的具体示例、完整对比文档)资料中仅给出文件名,未提供完整内容;版本号应以官方 changelog 为准。