Telegram Tools - AppConnectHQ Developers

← Tools Reference

Send messages and manage chats via a Telegram bot

Credentials form9 toolshttps://api.telegram.org/bot{bot_token}

GET

telegram_get_me

Get information about the connected bot itself (id, username, capabilities)

/getMe

POST

telegram_send_message

Send a text message to a chat. Rate-limited to ~1 message/second per chat (~20/minute in groups) — a 429 response includes a retry_after (seconds) field

/sendMessage

5 parameters

Param	Type	Required	Description
chat_id	string	required	Target chat: numeric chat ID, or '@channelusername' for a public channel
text	string	required	Message text (up to 4096 characters)
parse_mode	string	optional	Text formatting mode: 'MarkdownV2', 'HTML', or 'Markdown' (legacy)
disable_notification	boolean	optional	Send silently — users receive a notification with no sound
reply_to_message_id	integer	optional	ID of the message this is replying to, if any

POST

telegram_send_photo

Send a photo to a chat, by URL or a previously-uploaded file_id

/sendPhoto

4 parameters

Param	Type	Required	Description
chat_id	string	required	Target chat: numeric chat ID, or '@channelusername' for a public channel
photo	string	required	Public HTTPS URL of the photo, or a Telegram file_id
caption	string	optional	Caption to show under the photo (up to 1024 chars)
parse_mode	string	optional	Caption formatting mode: 'MarkdownV2', 'HTML', or 'Markdown' (legacy)

POST

telegram_send_document

Send a file/document to a chat, by URL or a previously-uploaded file_id

/sendDocument

3 parameters

Param	Type	Required	Description
chat_id	string	required	Target chat: numeric chat ID, or '@channelusername' for a public channel
document	string	required	Public HTTPS URL of the file, or a Telegram file_id
caption	string	optional	Caption to show under the file (up to 1024 chars)

POST

telegram_edit_message_text

Edit the text of a message previously sent by this bot

/editMessageText

4 parameters

Param	Type	Required	Description
chat_id	string	required	Chat the message was sent in
message_id	integer	required	ID of the message to edit
text	string	required	New message text (up to 4096 characters)
parse_mode	string	optional	Text formatting mode: 'MarkdownV2', 'HTML', or 'Markdown' (legacy)

POST

telegram_delete_message

Delete a message sent by this bot (or, if the bot is an admin, by anyone in a group)

/deleteMessage

2 parameters

Param	Type	Required	Description
chat_id	string	required	Chat the message was sent in
message_id	integer	required	ID of the message to delete

GET

telegram_get_chat

Get up-to-date information about a chat (title, type, description, etc.)

/getChat

1 parameter

Param	Type	Required	Description
chat_id	string	required	Target chat: numeric chat ID, or '@channelusername' for a public channel

GET

telegram_get_chat_member

Get information about a specific member of a group, supergroup, or channel

/getChatMember

2 parameters

Param	Type	Required	Description
chat_id	string	required	Target chat: numeric chat ID, or '@channelusername' for a public channel
user_id	integer	required	Numeric Telegram user ID of the member

GET

telegram_get_chat_administrators

List the administrators of a group, supergroup, or channel

/getChatAdministrators

1 parameter

Param	Type	Required	Description
chat_id	string	required	Target chat: numeric chat ID, or '@channelusername' for a public channel