telegram-automation

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.

By sickn33 · 504 installs

npx skills add sickn33/agentic-awesome-skills --skill telegram-automation

Source repository · Upstream listing

Telegram Automation via Rube MCP Automate Telegram operations through Composio's Telegram toolkit via Rube MCP. Prerequisites Rube MCP must be connected (RUBE SEARCH TOOLS available) Active Telegram connection via RUBE MANAGE CONNECTIONS with toolkit telegram Always call RUBE SEARCH TOOLS first to get current tool schemas Telegram Bot Token required (created via @BotFather) Setup Get Rube MCP : Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works. 1. Verify Rube MCP is available by confirming RUBE SEARCH TOOLS responds 2. Call RUBE MANAGE CONNECTIONS with toolkit telegram 3. If connection is not ACTIVE, follow the returned auth link to configure the Telegram bot 4. Confirm connection status shows ACTIVE before running any workflows Core Workflows 1. Send Messages When to use : User wants to send text messages to a Telegram chat Tool sequence : 1. TELEGRAM GET ME Verify bot identity and connection [Prerequisite] 2. TELEGRAM GET CHAT Get chat details and verify access [Optional] 3. TELEGRAM SEND MESSAGE Send a text message [Required] Key parameters : chat id : Numeric chat ID or channel username (e.g., '@channelname') text : Message text content parse mode : 'HTML' or 'MarkdownV2' for formatting disable notification : Send silently without notification sound reply to message id : Message ID to reply to Pitfalls : Bot must be a member of the chat/group to send messages MarkdownV2 requires escaping special characters: []()~ + = {}.! HTML mode supports limited tags: <b , <i , <code , <pre , <a Messages have a 4096 character limit; split longer content 2. Send Photos and Documents When to use : User wants to share images or files in a Telegram chat Tool sequence : 1. TELEGRAM SEND PHOTO Send an image [Optional] 2. TELEGRAM SEND DOCUMENT Send a file/document [Optional] Key parameters : chat id : Target chat ID photo : Photo URL or file id (for SEND PHOTO) document : Document URL or file id (for SEND DOCUMENT) caption : Optional caption for the media Pitfalls : Photo captions have a 1024 character limit Document captions also have a 1024 character limit Files up to 50MB can be sent via bot API Photos are compressed by Telegram; use SEND DOCUMENT for uncompressed images 3. Manage Chats When to use : User wants to get chat information or manage chat settings Tool sequence : 1. TELEGRAM GET CHAT Get detailed chat information [Required] 2. TELEGRAM GET CHAT ADMINISTRATORS List chat admins [Optional] 3. TELEGRAM GET CHAT MEMBERS COUNT Get member count [Optional] 4. TELEGRAM EXPORT CHAT INVITE LINK Generate invite link [Optional] Key parameters : chat id : Target chat ID or username Pitfalls : Bot must be an administrator to export invite links GET CHAT returns different fields for private chats vs groups vs channels Member count may be approximate for very large groups Admin list does not include regular members 4. Edit and Delete Messages When to use : User wants to modify or remove previously sent messages Tool sequence : 1. TELEGRAM EDIT MESSAGE Edit a sent message [Optional] 2. TELEGRAM DELETE MESSAGE Delete a message [Optional] Key parameters : chat id : Chat where the message is located message id : ID of the message to edit or delete text : New text content (for edit) Pitfalls : Bots can only edit their own messages Messages can only be deleted within 48 hours of sending In groups, bots with delete permissions can delete any message Editing a message removes its 'edited' timestamp history 5. Forward Messages and Get Updates When to use : User wants to forward messages or retrieve recent updates Tool sequence : 1. TELEGRAM FORWARD MESSAGE Forward a message to another chat [Optional] 2. TELEGRAM GET UPDATES Get recent bot updates/messages [Optional] 3. TELEGRAM GET CHAT HISTORY Get chat message history [Optional] Key parameters : from chat id : Source chat for forwarding chat id : Destination chat for forwarding message id : Message to forward offset : Update offset for GET UPDATES limit : Number of updates to retrieve Pitfalls : Forwarded messages show the original sender attribution GET UPDATES returns a limited window of recent updates Chat history access may be limited by bot permissions and chat type Use offset to avoid processing the same update twice 6. Manage Bot Commands When to use : User wants to set or update bot command menu Tool sequence : 1. TELEGRAM SET MY COMMANDS Set the bot's command list [Required] 2. TELEGRAM ANSWER CALLBACK QUERY Respond to inline button presses [Optional] Key parameters : commands : Array of command objects with command and description callback query id : ID of the callback query to answer Pitfalls : Commands must start with '/' and be lowercase Command descriptions have a 256 character limit Callback queries must be answered within 10 seconds or they expire Setting commands replaces the entire command list Common Patterns Chat ID Resolution From username : From GET UPDATES : Message Formatting Use parse mode: 'HTML' for <b bold</b , <i italic</i , <code code</code Use parse mode: 'MarkdownV2' for bold , italic , code Escape special chars in MarkdownV2: [ ] ( ) ~ + = { } . ! Omit parse mode for plain text without formatting Known Pitfalls Bot Permissions : Bots must be added to groups/channels to interact Admin permissions needed for: deleting messages, exporting invite links, managing members Bots cannot initiate conversations; users must start them first Rate Limits : 30 messages per second to the same group 20 messages per minute to the same user in groups Bulk operations should implement delays between calls API returns 429 Too Many Requests when limits are hit Chat Types : Private chat: One on one with the bot Group: Multi user chat (bot must be added) Supergroup: Enhanced group with admin features Channel: Broadcast only (bot must be admin to post) Message Limits : Text messages: 4096 characters max Captions: 1024 characters max File uploads: 50MB max via bot API Inline keyboard buttons: 8 per row Quick Reference Task Tool Slug Key Params Verify bot TELEGRAM GET ME (none) Send message TELEGRAM SEND MESSAGE chat id, text, parse mode Send photo TELEGRAM SEND PHOTO chat id, photo, caption Send document TELEGRAM SEND DOCUMENT chat id, document, caption Edit message TELEGRAM EDIT MESSAGE chat id, message id, text Delete message TELEGRAM DELETE MESSAGE chat id, message id Forward message TELEGRAM FORWARD MESSAGE chat id, from chat id, message id Get chat info TELEGRAM GET CHAT chat id Get chat admins TELEGRAM GET CHAT ADMINISTRATORS chat id Get member count TELEGRAM GET CHAT MEMBERS COUNT chat id Export invite link TELEGRAM EXPORT CHAT INVITE LINK chat id Get updates TELEGRAM GET UPDATES offset, limit Get chat history TELEGRAM GET CHAT HISTORY chat id Set bot commands TELEGRAM SET MY COMMANDS commands Answer callback TELEGRAM ANSWER CALLBACK QUERY callback query id When to Use This skill is applicable to execute the workflow or actions described in the overview. Limitations Use this skill only when the task clearly matches the scope described above. Do not treat the output as a substitute for environment specific validation, testing, or expert review. Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.