用途:帮助开发者(或智能体)构建面向以色列市场的 Telegram 机器人,围绕 grammY、Telegraf、python-telegram-bot 三种框架及其 Bot API 差异提供指导。
主要能力:
- 框架选择:按运行时、部署目标与 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。
- Bot API 10.3 变化:临时消息改用 ephemeral_message_parameters 对象;键盘新增 disabled/DisabledButton 与 force_reply;新增 can_send_welcome_messages;草稿生成可停止(can_stop/keep_on_stop、MessageGenerationStopped)。
- 基础模式:BotFather 创建与配置、token 安全(环境变量、/token 轮换)、群组隐私模式解决方案;内联键盘与 callback data 规则(最多 64 字节,希伯来语每字符 2 字节);中间件与多步对话流程。
- webhook 与轮询:二者互斥,未送达的更新 24 小时后过期;allowed_updates 默认排除 chat_member、message_reaction、message_reaction_count。webhook 需 HTTPS 与 443/80/88/8443 端口,并用 secret_token 校验。
- 希伯来语处理:RTL 双向文本、方向标记、HTML 解析模式与拉丁命令加希伯来触发词、希伯来语回复键盘。
- 限流:约 30 条/秒群发、单聊 1 条/秒、群组 20 条/分钟;付费广播需 100,000 Stars 余额与 100,000 月活用户。
使用方式:安装对应框架(npm install grammy、npm install telegraf、pip install python-telegram-bot),参照 quickstarts 脚手架,配置错误处理与从环境读取 token。
限制:部分细节(如参考资料链接中的具体示例、完整对比文档)资料中仅给出文件名,未提供完整内容;版本号应以官方 changelog 为准。