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.