Tools

Telegram

Learn how to use Telegram with Composio

Overview

Enum

TELEGRAM

Description

Telegram is a cloud-based messaging app with a focus on security and speed. Build bots to send messages, manage chats, and interact with users.

Authentication Details

bot_token
stringRequired

Actions

Use this method to send answers to callback queries sent from inline keyboards. the answer will be displayed to the user as a notification at the top of the chat screen or as an alert.

Action Parameters

cache_time
integer
callback_query_id
stringRequired
show_alert
boolean
text
string
url
string

Action Response

data
object
error
string
successful
boolean
Delete a message, including service messages, with certain limitations.

Action Parameters

chat_id
integerRequired
message_id
integerRequired

Action Response

data
object
error
string
successful
boolean
Edit text messages sent by the bot.

Action Parameters

chat_id
integer
disable_web_page_preview
boolean
inline_message_id
string
message_id
integer
parse_mode
string
reply_markup
string
text
stringRequired

Action Response

data
object
error
string
successful
boolean
Forward messages of any kind. service messages can't be forwarded.

Action Parameters

chat_id
integerRequired
disable_notification
boolean
from_chat_id
integerRequired
message_id
integerRequired

Action Response

data
object
error
string
successful
boolean
Get up to date information about the chat (current name of the user for one-on-one conversations, current username of a user, group or channel, etc.).

Action Parameters

chat_id
integerRequired

Action Response

data
object
error
string
successful
boolean
Get a list of administrators in a chat. on success, returns an array of chatmember objects that contains information about all chat administrators except other bots.

Action Parameters

chat_id
integerRequired

Action Response

data
object
error
string
successful
boolean
Get chat history messages. note: this uses the getupdates method with specific parameters to retrieve historical messages.

Action Parameters

chat_id
integerRequired
limit
integer
message_id
integer
offset
integer

Action Response

data
object
error
string
successful
boolean
Get the number of members in a chat. the bot must be an administrator in the chat for this to work.

Action Parameters

chat_id
integerRequired

Action Response

data
object
error
string
successful
boolean
Get basic information about the bot using the bot api getme method.

Action Parameters

Action Response

data
object
error
string
successful
boolean
Use this method to receive incoming updates using long polling. an array of update objects is returned.

Action Parameters

allowed_updates
array
limit
integer
offset
integer
timeout
integer

Action Response

data
object
error
string
successful
boolean
Send general files (documents) to a telegram chat using the bot api.

Action Parameters

caption
string
chat_id
integerRequired
disable_content_type_detection
boolean
disable_notification
boolean
document
stringRequired
parse_mode
string
reply_markup
string
reply_to_message_id
integer
thumbnail
string

Action Response

data
object
error
string
successful
boolean
Send point on the map location to a telegram chat using the bot api.

Action Parameters

chat_id
integerRequired
disable_notification
boolean
heading
integer
horizontal_accuracy
number
latitude
numberRequired
live_period
integer
longitude
numberRequired
proximity_alert_radius
integer
reply_markup
string
reply_to_message_id
integer

Action Response

data
object
error
string
successful
boolean
Send a text message to a telegram chat using the bot api.

Action Parameters

chat_id
integerRequired
disable_notification
boolean
disable_web_page_preview
boolean
parse_mode
string
reply_markup
string
reply_to_message_id
integer
text
stringRequired

Action Response

data
object
error
string
successful
boolean
Send photos to a telegram chat using the bot api.

Action Parameters

caption
string
chat_id
integerRequired
disable_notification
boolean
parse_mode
string
photo
stringRequired
reply_markup
string
reply_to_message_id
integer

Action Response

data
object
error
string
successful
boolean
Send a native poll to a telegram chat using the bot api.

Action Parameters

allows_multiple_answers
boolean
chat_id
integerRequired
close_date
integer
correct_option_id
integer
disable_notification
boolean
explanation
string
explanation_parse_mode
string
is_anonymous
boolean
is_closed
boolean
open_period
integer
options
arrayRequired
question
stringRequired
reply_markup
string
reply_to_message_id
integer
type
string

Action Response

data
object
error
string
successful
boolean
Use this method to change the list of the bot's commands. see https://core.telegram.org/bots#commands for more details about bot commands.

Action Parameters

commands
arrayRequired
language_code
string
scope
string

Action Response

data
object
error
string
successful
boolean