Share via

Telegram Bot (Independent Publisher)

The Telegram Bot API is an HTTP-based interface created for developers keen on building bots for Telegram.

This connector is available in the following products and regions:

Service Class Regions
Copilot Studio Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name Woong Choi
URL https://www.linkedin.com/in/woongchoi/
Email woong.choi@rapidcircle.com
Connector Metadata
Publisher Woong Choi
Website https://telegram.org/
Privacy policy https://telegram.org/privacy
Categories Communication

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Get Chat

Use this method to get up to date information about the chat
Get Me

Returns basic information about the bot in form of a User object. A simple method for testing your bot's auth token.
Get Updates

Use this method to receive incoming updates using long polling
Send Message

Use this method to send text messages
Send Photo

Use this method to send photos.

Get Chat

Operation ID:
GetChat

Use this method to get up to date information about the chat

Parameters

Name Key Required Type Description
Bot Token
 token True string

Telegram Bot Token. e.g. 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11
Chat ID
 chat_id string

chat_id

Returns

This object represents a message.

Message
Message

Get Me

Operation ID:
GetMe

Returns basic information about the bot in form of a User object. A simple method for testing your bot's auth token.

Parameters

Name Key Required Type Description
Bot Token
 token True string

Telegram Bot Token. e.g. 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

Returns

Name Path Type Description
OK
 ok boolean

Request successful
User
 result User

This object represents a Telegram user or bot

Get Updates

Operation ID:
GetUpdates

Use this method to receive incoming updates using long polling

Parameters

Name Key Required Type Description
Bot Token
 token True string

Telegram Bot Token. e.g. 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

Returns

Name Path Type Description
OK
 ok boolean

Request successful
result
 result array of Update

result

Send Message

Operation ID:
SendMessage

Use this method to send text messages

Parameters

Name Key Required Type Description
Bot Token
 token True string

Telegram Bot Token. e.g. 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11
Chat ID
 chat_id string

chat_id
Text
 text string

Text to send
Parse Mode
 parse_mode string

Mode for parsing entities in the message text.

Returns

Name Path Type Description
ok
 ok boolean

ok
Message
 result Message

This object represents a message.

Send Photo

Operation ID:
SendPhoto

Use this method to send photos.

Parameters

Name Key Required Type Description
Bot Token
 token True string

Telegram Bot Token. e.g. 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11
Chat ID
 chat_id string

chat_id
Photo
 photo string

Phototo send

Returns

This object represents a message.

Message
Message

Definitions

Chat

This object represents a chat

Name Path Type Description
Chat ID
 id integer

Unique identifier for this chat
First Name
 first_name string

First name of the other party in a private chat
Last Name
 last_name string

Last name of the other party in a private chat
User Name
 username string

Username, for private chats, supergroups and channels if available
Chat
 type string

Type of chat, can be either “private”, “group”, “supergroup” or “channel”

Update

This object represents an incoming update.

Name Path Type Description
Update ID
 update_id integer

The update's unique identifier.
Message
 message Message

This object represents a message.

Message

This object represents a message.

Name Path Type Description
Message ID
 message_id integer

Unique message identifier inside this chat
User
 from User

This object represents a Telegram user or bot
Chat
 chat Chat

This object represents a chat
Date
 date integer

Date the message was sent in Unix time
Text
 text string

For text messages, the actual UTF-8 text of the message, 0-4096 characters

User

This object represents a Telegram user or bot

Name Path Type Description
ID
 id integer

Unique identifier for this user or bot
Is Bot
 is_bot boolean

True, if this user is a bot
First Name
 first_name string

User's or bot's first name
Last Name
 last_name string

User's or bot's last name
User Name
 username string

User's or bot's username
Language Code
 language_code string

IETF language tag of the user's language
Can join groups
 can_join_groups boolean

True, if the bot can be invited to groups.
Can read all group messages
 can_read_all_group_messages boolean

True, if privacy mode is disabled for the bot.
Supports inline queries
 supports_inline_queries boolean

True, if the bot supports inline queries.