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 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

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.