diff --git a/ai/TOOLS.md b/ai/TOOLS.md index 92ac5569f..5d2bc7250 100644 --- a/ai/TOOLS.md +++ b/ai/TOOLS.md @@ -4,13 +4,12 @@ This document lists all available tools that AlphaHuman can use to interact with ## Overview -AlphaHuman has access to **152 tools** across **4 integrations**. +AlphaHuman has access to **104 tools** across **3 integrations**. **Quick Statistics:** - **Github**: 72 tools - **Gmail**: 7 tools - **Notion**: 25 tools -- **Telegram**: 48 tools ## Available Tools @@ -2650,1208 +2649,6 @@ This skill provides 25 tools for notion integration. --- -### Telegram Tools - -This skill provides 48 tools for telegram integration. - -#### telegram-status - -**Description**: Get current Telegram connection and authentication status. - -**Parameters**: *None* - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "telegram-status", - "parameters": {} -} -``` - ---- - -#### get-me - -**Description**: Get Telegram user information for the currently logged-in account. Returns profile including name, username, and phone number. - -**Parameters**: *None* - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "get-me", - "parameters": {} -} -``` - ---- - -#### get-chats - -**Description**: Get Telegram chat list with optional filtering. Returns chats sorted by pinned status and recent activity. Use this to browse conversations, find specific chats, or filter by type (private, group, channel). - -**Parameters**: -- **limit** (string): Maximum number of chats to return (default: 50, max: 100) -- **offset** (string): Number of chats to skip for pagination -- **search** (string): Search term to filter chats by title or username -- **type** (string): Filter by chat type -- **unread_only** (string): Only return chats with unread messages (true/false) - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "get-chats", - "parameters": { - "limit": "example_limit", - "offset": "example_offset", - "search": "example_search", - "type": "example_type", - "unread_only": "example_unread_only" - } -} -``` - ---- - -#### get-messages - -**Description**: Get messages from a specific Telegram chat. Supports filtering by content type, text search, and pagination. Returns messages in reverse chronological order (newest first). - -**Parameters**: -- **before_id** (string): Get messages before this message ID (for pagination) -- **chat_id** (string) **(required)**: The chat ID to get messages from (required) -- **content_type** (string): Filter by message content type -- **limit** (string): Maximum number of messages to return (default: 50, max: 100) -- **search** (string): Search term to filter messages by text content - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "get-messages", - "parameters": { - "before_id": "example_before_id", - "chat_id": "example_chat_id", - "content_type": "example_content_type", - "limit": "example_limit", - "search": "example_search" - } -} -``` - ---- - -#### get-contacts - -**Description**: Get Telegram contacts and users. Can filter to show only saved contacts or search by name/username. Returns user profiles including status, premium status, and bot flag. - -**Parameters**: -- **contacts_only** (string): Only return users who are saved contacts (true/false) -- **limit** (string): Maximum number of contacts to return (default: 50, max: 100) -- **offset** (string): Number of contacts to skip for pagination -- **search** (string): Search term to filter by name or username - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "get-contacts", - "parameters": { - "contacts_only": "example_contacts_only", - "limit": "example_limit", - "offset": "example_offset", - "search": "example_search" - } -} -``` - ---- - -#### get-chat-stats - -**Description**: Get detailed statistics for a Telegram chat. Returns message counts, content type breakdown, top senders, and activity date range. Useful for understanding chat activity and composition. - -**Parameters**: -- **chat_id** (string) **(required)**: The chat ID to get statistics for (required) - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "get-chat-stats", - "parameters": { - "chat_id": "example_chat_id" - } -} -``` - ---- - -#### send-message - -**Description**: Send a text message to a Telegram chat. Supports replying to a specific message. Returns the sent message details. - -**Parameters**: -- **chat_id** (string) **(required)**: The chat ID to send the message to (required) -- **reply_to_message_id** (string): Message ID to reply to (optional) -- **text** (string) **(required)**: The message text to send (required) - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "send-message", - "parameters": { - "chat_id": "example_chat_id", - "reply_to_message_id": "example_reply_to_message_id", - "text": "example_text" - } -} -``` - ---- - -#### edit-message - -**Description**: Edit a previously sent text message in a Telegram chat. Only messages sent by you can be edited. - -**Parameters**: -- **chat_id** (string) **(required)**: The chat ID containing the message (required) -- **message_id** (string) **(required)**: The message ID to edit (required) -- **text** (string) **(required)**: The new message text (required) - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "edit-message", - "parameters": { - "chat_id": "example_chat_id", - "message_id": "example_message_id", - "text": "example_text" - } -} -``` - ---- - -#### delete-messages - -**Description**: Delete one or more messages from a Telegram chat. By default deletes for all users (revoke). Pass revoke=false to delete only for yourself. - -**Parameters**: -- **chat_id** (string) **(required)**: The chat ID containing the messages (required) -- **message_ids** (string) **(required)**: Comma-separated list of message IDs to delete (required) -- **revoke** (string): Delete for all users (true) or only yourself (false). Default: true - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "delete-messages", - "parameters": { - "chat_id": "example_chat_id", - "message_ids": "example_message_ids", - "revoke": "example_revoke" - } -} -``` - ---- - -#### forward-messages - -**Description**: Forward one or more messages from one Telegram chat to another. The forwarded messages will show the original sender. - -**Parameters**: -- **chat_id** (string) **(required)**: The destination chat ID to forward messages to (required) -- **from_chat_id** (string) **(required)**: The source chat ID to forward messages from (required) -- **message_ids** (string) **(required)**: Comma-separated list of message IDs to forward (required) - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "forward-messages", - "parameters": { - "chat_id": "example_chat_id", - "from_chat_id": "example_from_chat_id", - "message_ids": "example_message_ids" - } -} -``` - ---- - -#### search-chat-messages - -**Description**: Search messages within a specific Telegram chat by keyword. Returns matching messages in reverse chronological order. - -**Parameters**: -- **chat_id** (string) **(required)**: The chat ID to search in (required) -- **from_message_id** (string): Start searching from this message ID (for pagination) -- **limit** (string): Maximum number of results (default: 20, max: 50) -- **query** (string) **(required)**: Search query text (required) - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "search-chat-messages", - "parameters": { - "chat_id": "example_chat_id", - "from_message_id": "example_from_message_id", - "limit": "example_limit", - "query": "example_query" - } -} -``` - ---- - -#### search-messages-global - -**Description**: Search messages across all Telegram chats by keyword. Returns matching messages from any conversation. - -**Parameters**: -- **limit** (string): Maximum number of results (default: 20, max: 50) -- **query** (string) **(required)**: Search query text (required) - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "search-messages-global", - "parameters": { - "limit": "example_limit", - "query": "example_query" - } -} -``` - ---- - -#### pin-message - -**Description**: Pin or unpin a message in a Telegram chat. Pinned messages appear at the top of the chat for all members. - -**Parameters**: -- **chat_id** (string) **(required)**: The chat ID (required) -- **disable_notification** (string): Disable notification for pin (true/false). Default: false -- **message_id** (string) **(required)**: The message ID to pin/unpin (required) -- **unpin** (string): Set to "true" to unpin instead of pin. Default: false - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "pin-message", - "parameters": { - "chat_id": "example_chat_id", - "disable_notification": "example_disable_notification", - "message_id": "example_message_id", - "unpin": "example_unpin" - } -} -``` - ---- - -#### mark-as-read - -**Description**: Mark messages in a Telegram chat as read. If no message_ids are provided, marks all messages in the chat as read by reading the latest message. - -**Parameters**: -- **chat_id** (string) **(required)**: The chat ID to mark as read (required) -- **message_ids** (string): Comma-separated list of message IDs to mark as read. If omitted, marks latest messages. - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "mark-as-read", - "parameters": { - "chat_id": "example_chat_id", - "message_ids": "example_message_ids" - } -} -``` - ---- - -#### get-chat - -**Description**: Get detailed information about a specific Telegram chat by ID. Returns chat type, title, member count, permissions, and other metadata. - -**Parameters**: -- **chat_id** (string) **(required)**: The chat ID to get info for (required) - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "get-chat", - "parameters": { - "chat_id": "example_chat_id" - } -} -``` - ---- - -#### create-private-chat - -**Description**: Open or create a direct message conversation with a Telegram user by their user ID. - -**Parameters**: -- **user_id** (string) **(required)**: The user ID to start a DM with (required) - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "create-private-chat", - "parameters": { - "user_id": "example_user_id" - } -} -``` - ---- - -#### create-group - -**Description**: Create a new Telegram group. Provide a title and at least one user ID to add as a member. - -**Parameters**: -- **title** (string) **(required)**: The group title (required) -- **user_ids** (string) **(required)**: Comma-separated list of user IDs to add to the group (required) - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "create-group", - "parameters": { - "title": "example_title", - "user_ids": "example_user_ids" - } -} -``` - ---- - -#### create-channel - -**Description**: Create a new Telegram channel. Channels are broadcast-only chats where only admins can post. - -**Parameters**: -- **description** (string): Channel description (optional) -- **title** (string) **(required)**: The channel title (required) - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "create-channel", - "parameters": { - "description": "example_description", - "title": "example_title" - } -} -``` - ---- - -#### join-chat - -**Description**: Join a Telegram chat by invite link (e.g., https://t.me/+abc123 or https://t.me/joinchat/abc123). - -**Parameters**: -- **invite_link** (string) **(required)**: The chat invite link (required) - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "join-chat", - "parameters": { - "invite_link": "example_invite_link" - } -} -``` - ---- - -#### leave-chat - -**Description**: Leave a Telegram group or channel by chat ID. - -**Parameters**: -- **chat_id** (string) **(required)**: The chat ID to leave (required) - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "leave-chat", - "parameters": { - "chat_id": "example_chat_id" - } -} -``` - ---- - -#### set-chat-title - -**Description**: Change a Telegram group or channel's title. Requires admin privileges. - -**Parameters**: -- **chat_id** (string) **(required)**: The chat ID (required) -- **title** (string) **(required)**: The new title (required) - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "set-chat-title", - "parameters": { - "chat_id": "example_chat_id", - "title": "example_title" - } -} -``` - ---- - -#### get-chat-invite-link - -**Description**: Get or create an invite link for a Telegram group or channel. Requires admin privileges. - -**Parameters**: -- **chat_id** (string) **(required)**: The chat ID (required) -- **member_limit** (string): Maximum number of members that can join via this link (0 = unlimited) -- **name** (string): Optional name for the invite link - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "get-chat-invite-link", - "parameters": { - "chat_id": "example_chat_id", - "member_limit": "example_member_limit", - "name": "example_name" - } -} -``` - ---- - -#### get-user - -**Description**: Get basic information about a Telegram user by their user ID. - -**Parameters**: -- **user_id** (string) **(required)**: The user ID to look up (required) - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "get-user", - "parameters": { - "user_id": "example_user_id" - } -} -``` - ---- - -#### get-user-profile - -**Description**: Get the full profile for a Telegram user, including bio, common group count, and other extended info. - -**Parameters**: -- **user_id** (string) **(required)**: The user ID to look up (required) - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "get-user-profile", - "parameters": { - "user_id": "example_user_id" - } -} -``` - ---- - -#### search-public-chat - -**Description**: Find a Telegram user, channel, or group by their @username. Returns the matching chat/user info. - -**Parameters**: -- **username** (string) **(required)**: The username to search for, without the @ prefix (required) - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "search-public-chat", - "parameters": { - "username": "example_username" - } -} -``` - ---- - -#### add-contact - -**Description**: Add a Telegram user as a saved contact. Requires the user ID and a first name. - -**Parameters**: -- **first_name** (string) **(required)**: Contact's first name (required) -- **last_name** (string): Contact's last name (optional) -- **phone_number** (string): Contact's phone number (optional) -- **user_id** (string) **(required)**: The user ID to add as contact (required) - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "add-contact", - "parameters": { - "first_name": "example_first_name", - "last_name": "example_last_name", - "phone_number": "example_phone_number", - "user_id": "example_user_id" - } -} -``` - ---- - -#### remove-contact - -**Description**: Remove a Telegram user from your saved contacts. - -**Parameters**: -- **user_id** (string) **(required)**: The user ID to remove from contacts (required) - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "remove-contact", - "parameters": { - "user_id": "example_user_id" - } -} -``` - ---- - -#### block-user - -**Description**: Block or unblock a Telegram user. Blocked users cannot send you messages. - -**Parameters**: -- **unblock** (string): Set to "true" to unblock instead of block. Default: false -- **user_id** (string) **(required)**: The user ID to block/unblock (required) - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "block-user", - "parameters": { - "unblock": "example_unblock", - "user_id": "example_user_id" - } -} -``` - ---- - -#### add-reaction - -**Description**: Add a reaction emoji to a Telegram message. Common reactions: 👍 ❤️ 🔥 🎉 😮 😢 💯 👎 - -**Parameters**: -- **chat_id** (string) **(required)**: The chat ID (required) -- **emoji** (string) **(required)**: The reaction emoji (required) -- **message_id** (string) **(required)**: The message ID to react to (required) - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "add-reaction", - "parameters": { - "chat_id": "example_chat_id", - "emoji": "example_emoji", - "message_id": "example_message_id" - } -} -``` - ---- - -#### remove-reaction - -**Description**: Remove a reaction emoji from a Telegram message. - -**Parameters**: -- **chat_id** (string) **(required)**: The chat ID (required) -- **emoji** (string) **(required)**: The reaction emoji to remove (required) -- **message_id** (string) **(required)**: The message ID (required) - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "remove-reaction", - "parameters": { - "chat_id": "example_chat_id", - "emoji": "example_emoji", - "message_id": "example_message_id" - } -} -``` - ---- - -#### send-sticker - -**Description**: Send a sticker to a Telegram chat by its file ID. Use search-stickers to find sticker IDs. - -**Parameters**: -- **chat_id** (string) **(required)**: The chat ID to send the sticker to (required) -- **reply_to_message_id** (string): Message ID to reply to (optional) -- **sticker_id** (string) **(required)**: The sticker file ID (required). Get from search-stickers. - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "send-sticker", - "parameters": { - "chat_id": "example_chat_id", - "reply_to_message_id": "example_reply_to_message_id", - "sticker_id": "example_sticker_id" - } -} -``` - ---- - -#### send-gif - -**Description**: Send a GIF/animation to a Telegram chat by URL or file ID. - -**Parameters**: -- **caption** (string): Optional caption for the GIF -- **chat_id** (string) **(required)**: The chat ID to send the GIF to (required) -- **reply_to_message_id** (string): Message ID to reply to (optional) -- **url** (string) **(required)**: The GIF URL or file ID (required) - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "send-gif", - "parameters": { - "caption": "example_caption", - "chat_id": "example_chat_id", - "reply_to_message_id": "example_reply_to_message_id", - "url": "example_url" - } -} -``` - ---- - -#### search-stickers - -**Description**: Search for Telegram stickers by emoji or keyword. Returns sticker file IDs that can be used with send-sticker. - -**Parameters**: -- **limit** (string): Maximum number of stickers to return (default: 10, max: 20) -- **query** (string) **(required)**: Emoji or keyword to search for stickers (required) - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "search-stickers", - "parameters": { - "limit": "example_limit", - "query": "example_query" - } -} -``` - ---- - -#### get-chat-folders - -**Description**: List all Telegram chat folders (filters) configured for the account. - -**Parameters**: *None* - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "get-chat-folders", - "parameters": {} -} -``` - ---- - -#### create-chat-folder - -**Description**: Create a new Telegram chat folder. You can specify which chats to include/exclude and filter settings. - -**Parameters**: -- **excluded_chat_ids** (string): Comma-separated list of chat IDs to exclude -- **include_bots** (string): Include bots (true/false). Default: false -- **include_channels** (string): Include channels (true/false). Default: false -- **include_contacts** (string): Include contacts (true/false). Default: false -- **include_groups** (string): Include groups (true/false). Default: false -- **include_non_contacts** (string): Include non-contacts (true/false). Default: false -- **included_chat_ids** (string): Comma-separated list of chat IDs to include -- **title** (string) **(required)**: The folder title (required) - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "create-chat-folder", - "parameters": { - "excluded_chat_ids": "example_excluded_chat_ids", - "include_bots": "example_include_bots", - "include_channels": "example_include_channels", - "include_contacts": "example_include_contacts", - "include_groups": "example_include_groups", - "include_non_contacts": "example_include_non_contacts", - "included_chat_ids": "example_included_chat_ids", - "title": "example_title" - } -} -``` - ---- - -#### edit-chat-folder - -**Description**: Edit an existing Telegram chat folder. Change title, included/excluded chats, or filter settings. - -**Parameters**: -- **excluded_chat_ids** (string): Comma-separated list of chat IDs to exclude (replaces existing) -- **folder_id** (string) **(required)**: The folder ID to edit (required) -- **include_bots** (string): Include bots (true/false) -- **include_channels** (string): Include channels (true/false) -- **include_contacts** (string): Include contacts (true/false) -- **include_groups** (string): Include groups (true/false) -- **include_non_contacts** (string): Include non-contacts (true/false) -- **included_chat_ids** (string): Comma-separated list of chat IDs to include (replaces existing) -- **title** (string): New folder title (optional) - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "edit-chat-folder", - "parameters": { - "excluded_chat_ids": "example_excluded_chat_ids", - "folder_id": "example_folder_id", - "include_bots": "example_include_bots", - "include_channels": "example_include_channels", - "include_contacts": "example_include_contacts", - "include_groups": "example_include_groups", - "include_non_contacts": "example_include_non_contacts", - "included_chat_ids": "example_included_chat_ids", - "title": "example_title" - } -} -``` - ---- - -#### delete-chat-folder - -**Description**: Delete a Telegram chat folder. Chats in the folder are not affected. - -**Parameters**: -- **folder_id** (string) **(required)**: The folder ID to delete (required) - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "delete-chat-folder", - "parameters": { - "folder_id": "example_folder_id" - } -} -``` - ---- - -#### get-chat-members - -**Description**: Get the members of a Telegram group or channel. Can filter by type (recent, administrators, banned, bots). - -**Parameters**: -- **chat_id** (string) **(required)**: The chat ID to get members from (required) -- **filter** (string): Filter members by type -- **limit** (string): Maximum number of members to return (default: 50, max: 200) -- **offset** (string): Number of members to skip for pagination -- **query** (string): Search query to filter members by name - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "get-chat-members", - "parameters": { - "chat_id": "example_chat_id", - "filter": "example_filter", - "limit": "example_limit", - "offset": "example_offset", - "query": "example_query" - } -} -``` - ---- - -#### add-chat-member - -**Description**: Add one or more users to a Telegram group. Requires admin privileges in the group. - -**Parameters**: -- **chat_id** (string) **(required)**: The group chat ID (required) -- **user_ids** (string) **(required)**: Comma-separated list of user IDs to add (required) - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "add-chat-member", - "parameters": { - "chat_id": "example_chat_id", - "user_ids": "example_user_ids" - } -} -``` - ---- - -#### ban-chat-member - -**Description**: Ban (kick) a member from a Telegram group or channel. Requires admin privileges. - -**Parameters**: -- **chat_id** (string) **(required)**: The chat ID (required) -- **user_id** (string) **(required)**: The user ID to ban (required) - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "ban-chat-member", - "parameters": { - "chat_id": "example_chat_id", - "user_id": "example_user_id" - } -} -``` - ---- - -#### promote-chat-member - -**Description**: Promote a member to admin or demote an admin in a Telegram group/channel. Specify individual admin rights to grant. - -**Parameters**: -- **can_change_info** (string): Can change chat info (true/false) -- **can_delete_messages** (string): Can delete messages (true/false) -- **can_edit_messages** (string): Can edit messages in channels (true/false) -- **can_invite_users** (string): Can invite users (true/false) -- **can_manage_chat** (string): Can manage chat settings (true/false) -- **can_pin_messages** (string): Can pin messages (true/false) -- **can_post_messages** (string): Can post in channels (true/false) -- **can_promote_members** (string): Can promote other members (true/false) -- **can_restrict_members** (string): Can restrict members (true/false) -- **chat_id** (string) **(required)**: The chat ID (required) -- **custom_title** (string): Custom admin title (optional) -- **demote** (string): Set to "true" to demote to regular member -- **user_id** (string) **(required)**: The user ID to promote/demote (required) - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "promote-chat-member", - "parameters": { - "can_change_info": "example_can_change_info", - "can_delete_messages": "example_can_delete_messages", - "can_edit_messages": "example_can_edit_messages", - "can_invite_users": "example_can_invite_users", - "can_manage_chat": "example_can_manage_chat", - "can_pin_messages": "example_can_pin_messages", - "can_post_messages": "example_can_post_messages", - "can_promote_members": "example_can_promote_members", - "can_restrict_members": "example_can_restrict_members", - "chat_id": "example_chat_id", - "custom_title": "example_custom_title", - "demote": "example_demote", - "user_id": "example_user_id" - } -} -``` - ---- - -#### get-chat-admins - -**Description**: Get the list of administrators for a Telegram group or channel. - -**Parameters**: -- **chat_id** (string) **(required)**: The chat ID (required) - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "get-chat-admins", - "parameters": { - "chat_id": "example_chat_id" - } -} -``` - ---- - -#### set-chat-permissions - -**Description**: Set the default permissions for all members in a Telegram group. Requires admin privileges. Controls what regular (non-admin) members can do. - -**Parameters**: -- **can_add_link_previews** (string): Can add link previews (true/false) -- **can_change_info** (string): Can change chat info (true/false) -- **can_invite_users** (string): Can invite users (true/false) -- **can_pin_messages** (string): Can pin messages (true/false) -- **can_send_audios** (string): Can send audio (true/false) -- **can_send_basic_messages** (string): Can send text messages (true/false) -- **can_send_documents** (string): Can send documents (true/false) -- **can_send_photos** (string): Can send photos (true/false) -- **can_send_polls** (string): Can send polls (true/false) -- **can_send_videos** (string): Can send videos (true/false) -- **chat_id** (string) **(required)**: The chat ID (required) - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "set-chat-permissions", - "parameters": { - "can_add_link_previews": "example_can_add_link_previews", - "can_change_info": "example_can_change_info", - "can_invite_users": "example_can_invite_users", - "can_pin_messages": "example_can_pin_messages", - "can_send_audios": "example_can_send_audios", - "can_send_basic_messages": "example_can_send_basic_messages", - "can_send_documents": "example_can_send_documents", - "can_send_photos": "example_can_send_photos", - "can_send_polls": "example_can_send_polls", - "can_send_videos": "example_can_send_videos", - "chat_id": "example_chat_id" - } -} -``` - ---- - -#### send-photo - -**Description**: Send a photo to a Telegram chat by URL. Supports optional caption and reply. - -**Parameters**: -- **caption** (string): Optional photo caption -- **chat_id** (string) **(required)**: The chat ID to send the photo to (required) -- **reply_to_message_id** (string): Message ID to reply to (optional) -- **url** (string) **(required)**: The photo URL (required) - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "send-photo", - "parameters": { - "caption": "example_caption", - "chat_id": "example_chat_id", - "reply_to_message_id": "example_reply_to_message_id", - "url": "example_url" - } -} -``` - ---- - -#### send-document - -**Description**: Send a document or file to a Telegram chat by URL. Supports optional caption and reply. - -**Parameters**: -- **caption** (string): Optional document caption -- **chat_id** (string) **(required)**: The chat ID to send the document to (required) -- **reply_to_message_id** (string): Message ID to reply to (optional) -- **url** (string) **(required)**: The document URL (required) - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "send-document", - "parameters": { - "caption": "example_caption", - "chat_id": "example_chat_id", - "reply_to_message_id": "example_reply_to_message_id", - "url": "example_url" - } -} -``` - ---- - -#### get-message - -**Description**: Get a single Telegram message by its chat ID and message ID. Returns the full message content and metadata. - -**Parameters**: -- **chat_id** (string) **(required)**: The chat ID (required) -- **message_id** (string) **(required)**: The message ID (required) - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "get-message", - "parameters": { - "chat_id": "example_chat_id", - "message_id": "example_message_id" - } -} -``` - ---- - -#### get-message-link - -**Description**: Get a shareable link to a specific Telegram message. Works for messages in public groups and channels. - -**Parameters**: -- **chat_id** (string) **(required)**: The chat ID (required) -- **message_id** (string) **(required)**: The message ID (required) - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "get-message-link", - "parameters": { - "chat_id": "example_chat_id", - "message_id": "example_message_id" - } -} -``` - ---- - -#### mute-chat - -**Description**: Mute or unmute a Telegram chat's notifications. Muting prevents notifications but messages still appear in the chat list. - -**Parameters**: -- **chat_id** (string) **(required)**: The chat ID (required) -- **duration** (string): Mute duration in seconds. Use 0 to unmute, 2147483647 for forever. Default: forever. -- **mute** (string): Set to "true" to mute, "false" to unmute. Default: true - -**Usage Context**: Available in all environments - -**Example**: -```json -{ - "tool": "mute-chat", - "parameters": { - "chat_id": "example_chat_id", - "duration": "example_duration", - "mute": "example_mute" - } -} -``` - ---- - - ## Tool Usage Guidelines ### Authentication @@ -3870,9 +2667,9 @@ This skill provides 48 tools for telegram integration. --- **Tool Statistics** -- Total Tools: 152 -- Active Skills: 4 -- Last Updated: 2026-03-06T10:38:25.214Z +- Total Tools: 104 +- Active Skills: 3 +- Last Updated: 2026-03-06T10:39:36.767Z *This file was automatically generated when the app loaded.* *Tools are discovered from the running V8 skills runtime.* \ No newline at end of file