SuperAPI AI 工具集

telegram

编程与开发

查看项目

更新于 10-15 21:10

技能介绍

用途:通过 Telegram Bot API 向个人、群组或频道发送通知与消息,适合脚本或自动化流程中的消息推送。

主要能力:支持发送到默认聊天、按别名发送到指定聊天、向多个聊天广播;支持 Markdown 与 HTML 解析模式、链接、多行消息;提供 getMe 验证机器人、getUpdates 获取聊天 ID、jq 读取聊天别名等辅助操作。

使用方式:先执行 source .skill.config 加载凭据,凭据存于 .skill.config(已 gitignore),包含 TELEGRAM_BOT_TOKEN 与 TELEGRAM_CHAT_ID。多聊天别名存于 telegram-chats.json(已 gitignore),结构为 chats 下每个别名含 id、name、description。发送示例:source .skill.config && curl -s -X POST "https://api.telegram.org/bot$TELEGRAM_BOT_TOKEN/sendMessage" -d "chat_id=$TELEGRAM_CHAT_ID" -d "text=Hello from OpenCode!"。按别名发送时先用 jq -r '.chats.house.id' skills/telegram/telegram-chats.json 取 ID。首次配置需通过 @BotFather 创建机器人获取 token,用 getUpdates 获取个人或群组 chat id,再写入配置文件。

限制与注意:Markdown 中字面量 _、*、`、[ 需转义;含特殊字符的消息用 --data-urlencode;chat id 为数字(个人)或以 - 开头(群组/频道),超级群组通常以 -100 开头;群聊需先把机器人加入群组。资料未提供收费、价格、平台支持范围及发送频率限制等信息。