{"id":"ad8cdce0-9e64-466f-a954-7e4e054dbdf6","shortId":"EKqkEd","kind":"skill","title":"telegram-automation","tagline":"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.","description":"# 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://rube.app/mcp` 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/group to send messages\n- MarkdownV2 requires escaping special characters: `_*[]()~>#+-=|{}.!`\n- HTML mode supports limited tags: `<b>`, `<i>`, `<code>`, `<pre>`, `<a>`\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/document [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/messages [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 '/' 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/groups)\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 `<b>bold</b>`, `<i>italic</i>`, `<code>code</code>`\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/channels 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.","tags":["telegram","automation","antigravity","awesome","skills","sickn33","agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows"],"capabilities":["skill","source-sickn33","skill-telegram-automation","topic-agent-skills","topic-agentic-skills","topic-ai-agent-skills","topic-ai-agents","topic-ai-coding","topic-ai-workflows","topic-antigravity","topic-antigravity-skills","topic-claude-code","topic-claude-code-skills","topic-codex-cli","topic-codex-skills"],"categories":["antigravity-awesome-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/sickn33/antigravity-awesome-skills/telegram-automation","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add sickn33/antigravity-awesome-skills","source_repo":"https://github.com/sickn33/antigravity-awesome-skills","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 34460 github stars · SKILL.md body (8,269 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-22T06:51:59.380Z","embedding":null,"createdAt":"2026-04-18T21:46:00.716Z","updatedAt":"2026-04-22T06:51:59.380Z","lastSeenAt":"2026-04-22T06:51:59.380Z","tsv":"'/mcp':89 '1':109,157,175,296,398,502,601,719,803,835 '10':784 '1024':348,356,998 '2':121,185,275,304,407,511,612,731,813,840 '20':927 '256':775 '3':129,196,380,416,621,822,846 '30':919 '4':145,426,483 '4096':269,994 '429':946 '48':559 '5':581 '50mb':362,1003 '6':701 '8':1011 'access':194,682 'action':1168 'activ':54,134,150 'ad':892,973 'add':86,103 'admin':414,476,897,978,987,1096 'administr':411,450,1100 'also':353 'alway':21,64 'anoth':609 'answer':733,762,782,1147,1150 'api':99,368,944,1007 'applic':1162 'approxim':471 'array':745 'ask':1206 'attribut':670 'auth':138 'autom':3,4,29,33 'avail':53,114 'avoid':695 'bold':861,869 'bot':19,76,144,180,245,367,446,546,565,618,687,703,714,726,887,889,908,964,970,984,1006,1022,1140 'botfath':81 'boundari':1214 'broadcast':982 'broadcast-on':981 'bulk':937 'button':739,1010 'call':65,122,823,836,853,943 'callback':734,753,759,778,1148,1151,1153 'cannot':909 'caption':337,339,345,352,997,1045,1054 'channel':213,466,980 'channelnam':216 'channels/groups':812 'char':874 'charact':260,270,349,357,776,995,999 'chat':14,172,188,190,207,210,293,314,317,382,390,394,401,404,410,413,419,429,438,441,456,462,521,523,610,624,627,634,637,640,643,680,690,798,808,816,818,825,849,954,957,969,1032,1042,1051,1060,1070,1079,1082,1087,1091,1092,1095,1099,1101,1108,1111,1118,1121,1131,1135,1137 'chat.id':842 'chat/group':252 'clarif':1208 'clear':1181 'client':96 'code':863,871 'command':20,704,715,723,728,744,747,750,764,771,790,794,1141,1145,1146 'common':796 'composio':10,37 'compress':371 'configur':97,141 'confirm':116,146 'connect':49,56,60,125,131,147,183 'content':220,274,542 'convers':911 'core':155 'count':421,424,468,1105,1110 'creat':79 'criteria':1217 'current':26,72 'delay':941 'delet':486,513,515,538,557,567,570,901,1065,1068 'describ':1169,1185 'descript':752,772 'destin':642 'detail':191,403 'differ':458 'disabl':228 'document':279,307,328,329,336,351,376,1047,1050,1053 'e.g':215 'edit':484,504,506,536,544,549,573,578,1055,1058 'endpoint':105 'enhanc':975 'entir':793 'environ':1197 'environment-specif':1196 'escap':258,872 'execut':1164 'expert':1202 'expir':788 'export':428,452,903,1113,1117 'extract':841 'featur':979 'field':459 'file':289,323,332,359,1001 'file/document':310 'first':24,69,916 'follow':135 'format':227,806,855,884 'forward':582,593,603,605,639,645,650,664,1074,1077 'generat':432 'get':71,83,177,187,189,389,400,402,409,418,422,455,585,614,616,623,626,655,671,824,833,838,1024,1086,1090,1094,1098,1103,1107,1123,1126,1130,1134 'group':464,475,564,926,936,965,976 'groups/channels':894 'handl':18 'histori':580,625,629,681,1132,1136 'hit':953 'hour':560 'html':223,261,859 'id':208,211,238,240,315,318,324,333,439,442,522,530,531,635,641,647,755,756,799,809,819,831,850,1033,1043,1052,1061,1063,1071,1073,1080,1083,1085,1093,1102,1112,1122,1138,1155 'ident':181 'imag':287,302,379 'implement':940 'includ':480 'info':1088 'inform':391,405 'initi':910 'inlin':738,1008 'input':1211 'interact':896 'invit':430,433,453,904,1114,1119 'ital':862,870 'key':100,205,312,436,519,631,742,1019 'keyboard':1009 'known':885 'larg':474 'limit':264,271,350,358,657,675,685,777,918,951,991,1129,1173 'link':139,431,434,454,905,1115,1120 'list':412,477,729,795 'locat':528 'longer':273 'lowercas':770 'manag':13,59,124,381,393,702,906 'mani':948 'markdownv2':225,256,867,876 'match':1182 'max':996,1000,1004 'may':469,683 'mcp':9,32,43,46,85,92,112 'media':342 'member':249,420,423,467,482,907,1104,1109 'menu':716 'messag':12,159,168,199,203,218,237,239,255,266,487,499,505,509,514,517,526,529,534,552,553,572,575,583,594,604,607,628,646,648,665,844,854,902,920,928,990,993,1028,1031,1056,1059,1062,1066,1069,1072,1075,1078,1084 'minut':930 'miss':1219 'mode':222,262,858,866,879,1036 'modifi':494 'multi':967 'multi-us':966 'must':47,246,447,765,780,890,913,971,985 'need':101,899 'new':540 'none':1026 'notif':229,233 'number':658 'numer':209,817,830,848 'object':748,845 'offset':651,653,693,1128 'omit':877 'one':959,961 'one-on-on':958 'oper':35,938 'option':195,303,311,338,415,425,435,510,518,611,620,630,741 'origin':668 'output':1191 'overview':1172 'param':1020 'paramet':206,313,437,520,632,743 'pars':221,857,865,878,1035 'pattern':797 'per':921,929,1012 'permiss':568,688,888,898,1212 'photo':277,299,319,320,327,344,369,1038,1041,1044 'photos/documents':16 'pitfal':244,343,445,545,663,763,886 'plain':881 'post':989 'prerequisit':44,184 'press':740 'previous':497 'privat':461,815,956 'process':696 'public':811 'queri':735,754,760,779,1152,1154 'quick':1014 'rate':917 'recent':597,617,678 'refer':1015 'regular':481 'remov':496,576 'replac':791 'repli':235,242 'request':949 'requir':78,204,257,406,730,821,1210 'resolut':800 'respond':120,736 'retriev':596,662,829 'return':137,457,673,945 'review':1203 'row':1013 'rube':8,31,42,45,50,58,66,84,111,117,123 'rube.app':88 'rube.app/mcp':87 'run':152 'safeti':1213 'schema':27,74 'scope':1184 'search':22,51,67,118 'second':785,922 'send':11,158,166,198,200,230,254,276,298,300,306,308,326,335,375,562,1027,1030,1037,1040,1046,1049 'sender':669 'sent':365,498,508 'sequenc':174,295,397,501,600,718 'server':93 'set':395,711,721,724,789,1139,1143 'setup':82 'share':15,286 'show':149,666 'silent':231 'skill':1160,1176 'skill-telegram-automation' 'slug':1018 'sound':234 'sourc':636 'source-sickn33' 'special':259,873 'specif':1198 'split':272 'start':766,914 'status':148 'stop':1204 'subsequ':852 'substitut':1194 'success':1216 'supergroup':974 'support':263 'tag':265 'target':316,440 'task':6,1016,1180 'telegram':2,5,28,34,39,55,63,75,128,143,171,176,186,197,292,297,305,373,399,408,417,427,503,512,602,613,622,720,732,837,1023,1029,1039,1048,1057,1067,1076,1089,1097,1106,1116,1125,1133,1142,1149 'telegram-autom':1 'test':1200 'text':167,202,217,219,539,541,882,992,1034,1064 'timestamp':579 'token':77 'tool':23,52,68,73,119,173,294,396,500,599,717,1017 'toolkit':40,62,127 'topic-agent-skills' 'topic-agentic-skills' 'topic-ai-agent-skills' 'topic-ai-agents' 'topic-ai-coding' 'topic-ai-workflows' 'topic-antigravity' 'topic-antigravity-skills' 'topic-claude-code' 'topic-claude-code-skills' 'topic-codex-cli' 'topic-codex-skills' 'treat':1189 'twice':700 'type':691,955 'uncompress':378 'updat':586,598,615,652,656,660,672,679,699,713,834,839,1124,1127 'updates/messages':619 'upload':1002 'url':321,330 'use':162,282,374,385,490,589,692,707,804,847,856,864,1158,1174 'user':163,283,386,491,590,708,912,934,968 'usernam':214,444,802,805,827 'valid':1199 'verifi':110,179,193,1021 'via':7,30,41,57,80,366,1005 'vs':463,465 'want':164,284,387,492,591,709 'window':676 'within':558,783 'without':232,883 'work':108 'workflow':154,156,1166","prices":[{"id":"a87fbed9-8146-4ffd-b616-0ac802c6cda4","listingId":"ad8cdce0-9e64-466f-a954-7e4e054dbdf6","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"sickn33","category":"antigravity-awesome-skills","install_from":"skills.sh"},"createdAt":"2026-04-18T21:46:00.716Z"}],"sources":[{"listingId":"ad8cdce0-9e64-466f-a954-7e4e054dbdf6","source":"github","sourceId":"sickn33/antigravity-awesome-skills/telegram-automation","sourceUrl":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/telegram-automation","isPrimary":false,"firstSeenAt":"2026-04-18T21:46:00.716Z","lastSeenAt":"2026-04-22T06:51:59.380Z"}],"details":{"listingId":"ad8cdce0-9e64-466f-a954-7e4e054dbdf6","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"sickn33","slug":"telegram-automation","github":{"repo":"sickn33/antigravity-awesome-skills","stars":34460,"topics":["agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows","antigravity","antigravity-skills","claude-code","claude-code-skills","codex-cli","codex-skills","cursor","cursor-skills","developer-tools","gemini-cli","gemini-skills","kiro","mcp","skill-library"],"license":"mit","html_url":"https://github.com/sickn33/antigravity-awesome-skills","pushed_at":"2026-04-22T06:40:00Z","description":"Installable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.","skill_md_sha":"706f59e39e0bd7010fff63167a632a6ef260a4e4","skill_md_path":"skills/telegram-automation/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/telegram-automation"},"layout":"multi","source":"github","category":"antigravity-awesome-skills","frontmatter":{"name":"telegram-automation","description":"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."},"skills_sh_url":"https://skills.sh/sickn33/antigravity-awesome-skills/telegram-automation"},"updatedAt":"2026-04-22T06:51:59.380Z"}}