Send a text message to a Telegram chat.

Supports plain text, Markdown, and HTML formatting. Can reply to an existing message using reply_to_message_id.

Args: params (SendMessageInput): Validated input with chat_id, text, parse_mode, reply_to_message_id, and disable_notification.

Returns: str: JSON with the sent Message object or an error description.

Send a photo to a Telegram chat.

Accepts a local file path, a public HTTP(S) URL, or a Telegram file_id. Optionally include a caption (supports Markdown/HTML).

Args: params (SendPhotoInput): chat_id, photo source, optional caption/parse_mode.

Returns: str: JSON with the sent Message object or an error description.

Send a video to a Telegram chat.

Accepts a local file path, a public HTTP(S) URL, or a Telegram file_id.

Args: params (SendVideoInput): chat_id, video source, optional caption, dimensions.

Returns: str: JSON with the sent Message object or an error description.

Send an audio file to a Telegram chat (shown as music player).

Accepts a local file path, a public HTTP(S) URL, or a Telegram file_id.

Args: params (SendAudioInput): chat_id, audio source, optional caption/performer/title.

Returns: str: JSON with the sent Message object or an error description.

Send any file (document) to a Telegram chat.

Use this for PDFs, ZIPs, code files, or any file type that doesn't fit photo/video/audio. Accepts a local path, URL, or Telegram file_id.

Args: params (SendDocumentInput): chat_id, document source, optional caption.

Returns: str: JSON with the sent Message object or an error description.

Send a voice message (.ogg/Opus) to a Telegram chat.

Accepts a local file path, a public HTTP(S) URL, or a Telegram file_id.

Args: params (SendVoiceInput): chat_id, voice file source, optional caption/duration.

Returns: str: JSON with the sent Message object or an error description.

Send a sticker to a Telegram chat using a file_id or .webp URL.

Args: params (SendStickerInput): chat_id and sticker file_id or URL.

Returns: str: JSON with the sent Message object or an error description.

Send a geographic location (map pin) to a Telegram chat.

Args: params (SendLocationInput): chat_id, latitude, longitude.

Returns: str: JSON with the sent Message object or an error description.

Retrieve recent updates (messages, callbacks, etc.) sent to the bot.

Use the 'offset' parameter to mark previous updates as read and paginate. Call with offset = (last_update_id + 1) to acknowledge processed messages.

Args: params (GetUpdatesInput): offset, limit, allowed_updates filter list.

Returns: str: JSON list of Update objects containing messages and metadata.

Get information about a chat (group, channel, or user).

Returns name, type, description, member count, and more.

Args: params (GetChatInput): chat_id or @username.

Returns: str: JSON with Chat object details.

Get the total number of members in a chat/channel/group.

Args: params (GetChatMembersCountInput): chat_id or @username.

Returns: str: JSON with {"member_count": N}.

Get metadata and download path for a file stored on Telegram servers.

Returns the file_path needed to construct the download URL: https://api.telegram.org/file/bot/<file_path>

Args: params (GetFileInput): file_id of the Telegram file.

Returns: str: JSON with File object including file_path, file_size, and download_url.

Download a file from Telegram using its file_id.

If save_path is provided, writes the file to disk and returns the path. Otherwise returns the file content as base64-encoded string.

Use telegram_get_file_info first if you only need the download URL.

Args: params (DownloadFileInput): file_id, optional save_path.

Returns: str: JSON with saved_path or base64 content + filename and size.

Forward a message from one chat to another.

Args: params (ForwardMessageInput): target chat_id, from_chat_id, message_id.

Returns: str: JSON with the forwarded Message object or an error description.

Delete a message from a chat (bot must have delete permission).

Args: params (DeleteMessageInput): chat_id and message_id to delete.

Returns: str: JSON {"deleted": true} on success or an error description.

Pin a message in a chat (bot must be admin with pin_messages permission).

Args: params (PinMessageInput): chat_id, message_id, disable_notification flag.

Returns: str: JSON {"pinned": true} on success or an error description.

Get information about the configured bot (name, username, capabilities).

Useful to verify the bot token is valid and check bot identity.

Returns: str: JSON with User object representing the bot.