[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-7bcafcd4-4d44-4a9d-9788-d07cd524b031":3,"$f25ibnYpVyZuVeGjKhFsUy7ig6X4elxvBtoJt3QAFqns":43},{"id":4,"title":5,"description":6,"categoryId":7,"moduleId":8,"tags":9,"prompt":10,"icon":11,"source":12,"sourceUrl":13,"authorId":14,"authorName":15,"isPublic":16,"stars":17,"runs":18,"createdAt":19,"updatedAt":19,"module":20,"category":27,"packages":34},"7bcafcd4-4d44-4a9d-9788-d07cd524b031","telegram-automation","通过Rube MCP（Composio）自动化Telegram任务：发送消息、管理聊天、分享照片\u002F文档、处理机器人命令。始终首先搜索当前架构的工具。","cat_prod_automation","mod_productivity","sickn33,productivity","---\nname: telegram-automation\ndescription: \"Automate Telegram tasks via Rube MCP (Composio): send messages, manage chats, share photos\u002Fdocuments, and handle bot commands. Always search tools first for current schemas.\"\nrisk: critical\nsource: community\ndate_added: \"2026-02-27\"\n---\n\n# Telegram Automation via Rube MCP\n\nAutomate Telegram operations through Composio's Telegram toolkit via Rube MCP.\n\n## Prerequisites\n\n- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)\n- Active Telegram connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `telegram`\n- Always call `RUBE_SEARCH_TOOLS` first to get current tool schemas\n- Telegram Bot Token required (created via @BotFather)\n\n## Setup\n\n**Get Rube MCP**: Add `https:\u002F\u002Frube.app\u002Fmcp` as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.\n\n\n1. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds\n2. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `telegram`\n3. If connection is not ACTIVE, follow the returned auth link to configure the Telegram bot\n4. Confirm connection status shows ACTIVE before running any workflows\n\n## Core Workflows\n\n### 1. Send Messages\n\n**When to use**: User wants to send text messages to a Telegram chat\n\n**Tool sequence**:\n1. `TELEGRAM_GET_ME` - Verify bot identity and connection [Prerequisite]\n2. `TELEGRAM_GET_CHAT` - Get chat details and verify access [Optional]\n3. `TELEGRAM_SEND_MESSAGE` - Send a text message [Required]\n\n**Key parameters**:\n- `chat_id`: Numeric chat ID or channel username (e.g., '@channelname')\n- `text`: Message text content\n- `parse_mode`: 'HTML' or 'MarkdownV2' for formatting\n- `disable_notification`: Send silently without notification sound\n- `reply_to_message_id`: Message ID to reply to\n\n**Pitfalls**:\n- Bot must be a member of the chat\u002Fgroup to send messages\n- MarkdownV2 requires escaping special characters: `_*[]()~>#+-=|{}.!`\n- HTML mode supports limited tags: `\u003Cb>`, `\u003Ci>`, `\u003Ccode>`, `\u003Cpre>`, `\u003Ca>`\n- Messages have a 4096 character limit; split longer content\n\n### 2. Send Photos and Documents\n\n**When to use**: User wants to share images or files in a Telegram chat\n\n**Tool sequence**:\n1. `TELEGRAM_SEND_PHOTO` - Send an image [Optional]\n2. `TELEGRAM_SEND_DOCUMENT` - Send a file\u002Fdocument [Optional]\n\n**Key parameters**:\n- `chat_id`: Target chat ID\n- `photo`: Photo URL or file_id (for SEND_PHOTO)\n- `document`: Document URL or file_id (for SEND_DOCUMENT)\n- `caption`: Optional caption for the media\n\n**Pitfalls**:\n- Photo captions have a 1024 character limit\n- Document captions also have a 1024 character limit\n- Files up to 50MB can be sent via bot API\n- Photos are compressed by Telegram; use SEND_DOCUMENT for uncompressed images\n\n### 3. Manage Chats\n\n**When to use**: User wants to get chat information or manage chat settings\n\n**Tool sequence**:\n1. `TELEGRAM_GET_CHAT` - Get detailed chat information [Required]\n2. `TELEGRAM_GET_CHAT_ADMINISTRATORS` - List chat admins [Optional]\n3. `TELEGRAM_GET_CHAT_MEMBERS_COUNT` - Get member count [Optional]\n4. `TELEGRAM_EXPORT_CHAT_INVITE_LINK` - Generate invite link [Optional]\n\n**Key parameters**:\n- `chat_id`: Target chat ID or username\n\n**Pitfalls**:\n- Bot must be an administrator to export invite links\n- GET_CHAT returns different fields for private chats vs groups vs channels\n- Member count may be approximate for very large groups\n- Admin list does not include regular members\n\n### 4. Edit and Delete Messages\n\n**When to use**: User wants to modify or remove previously sent messages\n\n**Tool sequence**:\n1. `TELEGRAM_EDIT_MESSAGE` - Edit a sent message [Optional]\n2. `TELEGRAM_DELETE_MESSAGE` - Delete a message [Optional]\n\n**Key parameters**:\n- `chat_id`: Chat where the message is located\n- `message_id`: ID of the message to edit or delete\n- `text`: New text content (for edit)\n\n**Pitfalls**:\n- Bots can only edit their own messages\n- Messages can only be deleted within 48 hours of sending\n- In groups, bots with delete permissions can delete any message\n- Editing a message removes its 'edited' timestamp history\n\n### 5. Forward Messages and Get Updates\n\n**When to use**: User wants to forward messages or retrieve recent updates\n\n**Tool sequence**:\n1. `TELEGRAM_FORWARD_MESSAGE` - Forward a message to another chat [Optional]\n2. `TELEGRAM_GET_UPDATES` - Get recent bot updates\u002Fmessages [Optional]\n3. `TELEGRAM_GET_CHAT_HISTORY` - Get chat message history [Optional]\n\n**Key parameters**:\n- `from_chat_id`: Source chat for forwarding\n- `chat_id`: Destination chat for forwarding\n- `message_id`: Message to forward\n- `offset`: Update offset for GET_UPDATES\n- `limit`: Number of updates to retrieve\n\n**Pitfalls**:\n- Forwarded messages show the original sender attribution\n- GET_UPDATES returns a limited window of recent updates\n- Chat history access may be limited by bot permissions and chat type\n- Use offset to avoid processing the same update twice\n\n### 6. Manage Bot Commands\n\n**When to use**: User wants to set or update bot command menu\n\n**Tool sequence**:\n1. `TELEGRAM_SET_MY_COMMANDS` - Set the bot's command list [Required]\n2. `TELEGRAM_ANSWER_CALLBACK_QUERY` - Respond to inline button presses [Optional]\n\n**Key parameters**:\n- `commands`: Array of command objects with `command` and `description`\n- `callback_query_id`: ID of the callback query to answer\n\n**Pitfalls**:\n- Commands must start with '\u002F' and be lowercase\n- Command descriptions have a 256 character limit\n- Callback queries must be answered within 10 seconds or they expire\n- Setting commands replaces the entire command list\n\n## Common Patterns\n\n### Chat ID Resolution\n\n**From username**:\n```\n1. Use '@username' format as chat_id (for public channels\u002Fgroups)\n2. For private chats, numeric chat_id is required\n3. Call GET_CHAT with username to retrieve numeric ID\n```\n\n**From GET_UPDATES**:\n```\n1. Call TELEGRAM_GET_UPDATES\n2. Extract chat.id from message objects\n3. Use numeric chat_id in subsequent calls\n```\n\n### Message Formatting\n\n- Use `parse_mode: 'HTML'` for `\u003Cb>bold\u003C\u002Fb>`, `\u003Ci>italic\u003C\u002Fi>`, `\u003Ccode>code\u003C\u002Fcode>`\n- Use `parse_mode: 'MarkdownV2'` for `*bold*`, `_italic_`, `` `code` ``\n- Escape special chars in MarkdownV2: `_ * [ ] ( ) ~ > # + - = | { } . !`\n- Omit parse_mode for plain text without formatting\n\n## Known Pitfalls\n\n**Bot Permissions**:\n- Bots must be added to groups\u002Fchannels to interact\n- Admin permissions needed for: deleting messages, exporting invite links, managing members\n- Bots cannot initiate conversations; users must start them first\n\n**Rate Limits**:\n- 30 messages per second to the same group\n- 20 messages per minute to the same user in groups\n- Bulk operations should implement delays between calls\n- API returns 429 Too Many Requests when limits are hit\n\n**Chat Types**:\n- Private chat: One-on-one with the bot\n- Group: Multi-user chat (bot must be added)\n- Supergroup: Enhanced group with admin features\n- Channel: Broadcast-only (bot must be admin to post)\n\n**Message Limits**:\n- Text messages: 4096 characters max\n- Captions: 1024 characters max\n- File uploads: 50MB max via bot API\n- Inline keyboard buttons: 8 per row\n\n## Quick Reference\n\n| Task | Tool Slug | Key Params |\n|------|-----------|------------|\n| Verify bot | TELEGRAM_GET_ME | (none) |\n| Send message | TELEGRAM_SEND_MESSAGE | chat_id, text, parse_mode |\n| Send photo | TELEGRAM_SEND_PHOTO | chat_id, photo, caption |\n| Send document | TELEGRAM_SEND_DOCUMENT | chat_id, document, caption |\n| Edit message | TELEGRAM_EDIT_MESSAGE | chat_id, message_id, text |\n| Delete message | TELEGRAM_DELETE_MESSAGE | chat_id, message_id |\n| Forward message | TELEGRAM_FORWARD_MESSAGE | chat_id, from_chat_id, message_id |\n| Get chat info | TELEGRAM_GET_CHAT | chat_id |\n| Get chat admins | TELEGRAM_GET_CHAT_ADMINISTRATORS | chat_id |\n| Get member count | TELEGRAM_GET_CHAT_MEMBERS_COUNT | chat_id |\n| Export invite link | TELEGRAM_EXPORT_CHAT_INVITE_LINK | chat_id |\n| Get updates | TELEGRAM_GET_UPDATES | offset, limit |\n| Get chat history | TELEGRAM_GET_CHAT_HISTORY | chat_id |\n| Set bot commands | TELEGRAM_SET_MY_COMMANDS | commands |\n| Answer callback | TELEGRAM_ANSWER_CALLBACK_QUERY | callback_query_id |\n\n## When to Use\nThis skill is applicable to execute the workflow or actions described in the overview.\n\n## Limitations\n- Use this skill only when the task clearly matches the scope described above.\n- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.\n- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.\n","","imported","https:\u002F\u002Fgithub.com\u002Fsickn33\u002Fantigravity-awesome-skills","user_system_seed","SkillOPIC",true,176,283,"2026-05-16 13:43:28",{"id":8,"name":21,"slug":22,"icon":23,"description":24,"sort":25,"createdAt":26},"效率工具","productivity","mdi-lightning-bolt-outline","文档处理、数据分析、自动化工作流",4,"2026-05-16 12:53:40",{"id":7,"name":28,"slug":29,"icon":30,"description":31,"moduleId":8,"sort":32,"skillCount":33,"createdAt":26},"自动化","automation","mdi-robot-outline","工作流自动化、批处理",3,101,[35],{"id":36,"skillId":4,"version":37,"fileName":38,"fileSize":39,"filePath":40,"fileHash":41,"manifest":42,"createdAt":19},"13c71b9d-c448-4ccb-97e9-16f7fa48c037","1.0.0","telegram-automation.zip",3471,"uploads\u002Fskills\u002F7bcafcd4-4d44-4a9d-9788-d07cd524b031\u002Ftelegram-automation.zip","10caf47c0235487adcf40b623514591823d10eff66a55f868fc2584628c360a4","[{\"path\":\"SKILL.md\",\"isDirectory\":false,\"size\":8554}]",{"code":44,"message":45,"data":46},200,"success",{"items":47,"stats":48,"page":51},[],{"averageRating":49,"totalRatings":49,"ratingCounts":50},0,[49,49,49,49,49],{"limit":52,"offset":49,"hasMore":53,"nextOffset":52,"ratedOnly":16},15,false]