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 |
|---|---|---|
| Logic Apps | Standard | All Logic Apps regions except the following: - Azure Government regions - Azure China regions - 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) |
| 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) |
| Contact | |
|---|---|
| Name | Woong Choi |
| URL | https://www.linkedin.com/in/woongchoi/ |
| [email protected] |
| 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
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
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
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
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
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. |