name: telegram-automationdescription: “Automate Telegram tasks via Rube MCP (Composio): send messages, manage chats, share photos/documents, and handle bot commands. Always search tools first for current schemas.”risk: criticalsource: communitydate_added: “2026-02-27”通过 Rube MCP 实现 Telegram 自动化通过 Rube MCP 使用 Composio 的 Telegram 工具包自动化 Telegram 操作。前置条件Rube MCP 必须已连接RUBE_SEARCH_TOOLS可用通过RUBE_MANAGE_CONNECTIONS使用telegram工具包激活 Telegram 连接始终先调用RUBE_SEARCH_TOOLS获取当前工具模式需要 Telegram 机器人令牌通过 BotFather 创建设置获取 Rube MCP在客户端配置中将https://rube.app/mcp添加为 MCP 服务器。无需 API 密钥——只需添加端点即可工作。通过确认RUBE_SEARCH_TOOLS有响应来验证 Rube MCP 可用使用telegram工具包调用RUBE_MANAGE_CONNECTIONS如果连接不是 ACTIVE活动按照返回的认证链接配置 Telegram 机器人在运行任何工作流之前确认连接状态显示 ACTIVE核心工作流1. 发送消息何时使用用户想向 Telegram 聊天发送文本消息工具序列TELEGRAM_GET_ME- 验证机器人身份和连接 [前置条件]TELEGRAM_GET_CHAT- 获取聊天详情并验证访问权限 [可选]TELEGRAM_SEND_MESSAGE- 发送文本消息 [必需]关键参数chat_id数字聊天 ID 或频道用户名例如 ‘channelname’text消息文本内容parse_mode‘HTML’ 或 ‘MarkdownV2’ 用于格式化disable_notification静默发送无通知声音reply_to_message_id要回复的消息 ID陷阱机器人必须是聊天/群组的成员才能发送消息MarkdownV2 需要转义特殊字符_*[]()~#-|{}.!HTML 模式支持有限标签b、i、code、pre、a消息有 4096 字符限制较长的内容需要拆分2. 发送照片和文档何时使用用户想在 Telegram 聊天中分享图片或文件工具序列TELEGRAM_SEND_PHOTO- 发送图片 [可选]TELEGRAM_SEND_DOCUMENT- 发送文件/文档 [可选]关键参数chat_id目标聊天 IDphoto照片 URL 或 file_id用于 SEND_PHOTOdocument文档 URL 或 file_id用于 SEND_DOCUMENTcaption媒体的可选说明文字陷阱照片说明文字有 1024 字符限制文档说明文字也有 1024 字符限制通过机器人 API 可发送最大 50MB 的文件照片会被 Telegram 压缩发送未压缩图片请使用 SEND_DOCUMENT3. 管理聊天何时使用用户想获取聊天信息或管理聊天设置工具序列TELEGRAM_GET_CHAT- 获取详细的聊天信息 [必需]TELEGRAM_GET_CHAT_ADMINISTRATORS- 列出聊天管理员 [可选]TELEGRAM_GET_CHAT_MEMBERS_COUNT- 获取成员数量 [可选]TELEGRAM_EXPORT_CHAT_INVITE_LINK- 生成邀请链接 [可选]关键参数chat_id目标聊天 ID 或用户名陷阱机器人必须是管理员才能导出邀请链接GET_CHAT 对私聊、群组和频道返回不同的字段非常大的群组的成员数量可能只是近似值管理员列表不包含普通成员4. 编辑和删除消息何时使用用户想修改或移除之前发送的消息工具序列TELEGRAM_EDIT_MESSAGE- 编辑已发送的消息 [可选]TELEGRAM_DELETE_MESSAGE- 删除消息 [可选]关键参数chat_id消息所在的聊天message_id要编辑或删除的消息 IDtext新的文本内容用于编辑陷阱机器人只能编辑自己的消息消息只能在发送后 48 小时内删除在群组中有删除权限的机器人可以删除任何消息编辑消息会移除其已编辑时间戳历史5. 转发消息和获取更新何时使用用户想转发消息或检索最近的更新工具序列TELEGRAM_FORWARD_MESSAGE- 将消息转发到另一个聊天 [可选]TELEGRAM_GET_UPDATES- 获取最近的机器人更新/消息 [可选]TELEGRAM_GET_CHAT_HISTORY- 获取聊天消息历史 [可选]关键参数from_chat_id转发的源聊天chat_id转发的目标聊天message_id要转发的消息offsetGET_UPDATES 的更新偏移量limit要检索的更新数量陷阱转发的消息会显示原始发送者归属GET_UPDATES 返回有限的最近更新窗口聊天历史访问可能受机器人权限和聊天类型限制使用偏移量避免重复处理同一更新6. 管理机器人命令何时使用用户想设置或更新机器人命令菜单工具序列TELEGRAM_SET_MY_COMMANDS- 设置机器人命令列表 [必需]TELEGRAM_ANSWER_CALLBACK_QUERY- 响应内联按钮按下 [可选]关键参数commands带command和description的命令对象数组callback_query_id要响应的回调查询 ID陷阱命令必须以 ‘/’ 开头且为小写命令描述有 256 字符限制回调查询必须在 10 秒内响应否则过期设置命令会替换整个命令列表常见模式聊天 ID 解析从用户名1. 使用 username 格式作为 chat_id用于公共频道/群组 2. 对于私聊需要数字 chat_id 3. 使用用户名调用 GET_CHAT 检索数字 ID从 GET_UPDATES1. 调用 TELEGRAM_GET_UPDATES 2. 从消息对象中提取 chat.id 3. 在后续调用中使用数字 chat_id消息格式化使用parse_mode: HTML支持bbold/b、iitalic/i、codecode/code使用parse_mode: MarkdownV2支持*bold*、_italic_、code在 MarkdownV2 中转义特殊字符_ * [ ] ( ) ~ # - | { } . !无格式的纯文本省略 parse_mode已知陷阱机器人权限机器人必须被添加到群组/频道才能交互需要管理员权限的操作删除消息、导出邀请链接、管理成员机器人不能发起对话用户必须先开始对话速率限制同一群组每秒 30 条消息群组中对同一用户每分钟 20 条消息批量操作应在调用之间实现延迟达到限制时 API 返回 429 Too Many Requests聊天类型私聊与机器人一对一的对话群组多用户聊天必须添加机器人超级群组带管理员功能的增强群组频道仅广播机器人必须是管理员才能发帖消息限制文本消息最大 4096 字符说明文字最大 1024 字符文件上传通过机器人 API 最大 50MB内联键盘按钮每行 8 个快速参考任务工具名关键参数验证机器人TELEGRAM_GET_ME无发送消息TELEGRAM_SEND_MESSAGEchat_id、text、parse_mode发送照片TELEGRAM_SEND_PHOTOchat_id、photo、caption发送文档TELEGRAM_SEND_DOCUMENTchat_id、document、caption编辑消息TELEGRAM_EDIT_MESSAGEchat_id、message_id、text删除消息TELEGRAM_DELETE_MESSAGEchat_id、message_id转发消息TELEGRAM_FORWARD_MESSAGEchat_id、from_chat_id、message_id获取聊天信息TELEGRAM_GET_CHATchat_id获取聊天管理员TELEGRAM_GET_CHAT_ADMINISTRATORSchat_id获取成员数量TELEGRAM_GET_CHAT_MEMBERS_COUNTchat_id导出邀请链接TELEGRAM_EXPORT_CHAT_INVITE_LINKchat_id获取更新TELEGRAM_GET_UPDATESoffset、limit获取聊天历史TELEGRAM_GET_CHAT_HISTORYchat_id设置机器人命令TELEGRAM_SET_MY_COMMANDScommands响应回调TELEGRAM_ANSWER_CALLBACK_QUERYcallback_query_id何时使用此技能适用于执行概述中描述的工作流或操作。局限性仅在任务明确匹配上述范围时使用此技能。不要将输出视为环境特定验证、测试或专家审查的替代品。如果缺少所需的输入、权限、安全边界或成功标准请停下来询问澄清。