用途:向 Telegram 发送即时消息,并安排未来的定时提醒;提醒在 Convex Cloud 中持续运行,无需自行管理服务器。
主要能力:发送纯文本消息、发送带附件的消息、按时间表达式安排提醒、查看待发送提醒列表、取消消息、查看历史记录。时间使用用户配置的时区,Convex 后端内部存 UTC,客户端脚本借助 chrono-node 做转换。
必要用法:先完成初始化配置。用户需提供 Bot Token(通过 @BotFather 获取)、数字 User ID(通过 @userinfobot 获取)和 Convex Deploy Key。随后安装依赖并保存配置,写入 .env.local,用 npx convex env set 设置 TELEGRAM_BOT_TOKEN 与 TELEGRAM_USER_ID,再执行 npx convex deploy。常用命令:tsx scripts/send_message.ts [message_text] 发送文本;带附件时在消息后追加文件路径;tsx scripts/schedule_message.ts [time expression] [title] [message_text] [file_path] 安排提醒;tsx scripts/list_scheduled.ts 列出待发送;tsx scripts/cancel_message.ts <message_id> 取消;tsx scripts/view_history.ts [limit] 查看历史。
适用场景:需要定期或指定时间向 Telegram 推送提醒、通知、备忘和文件的个人自动化场景。
限制:用户必须先与其机器人开始聊天,机器人才能发消息;文件以文档形式发送,不是内联图片;单文件最大 50MB(Telegram 限制);定时最小粒度为 1 分钟;不支持编辑已发送消息,需取消后重新安排;速率限制为每用户每分钟 20 条消息。资料未提供收费与价格信息。