Telegram

Use as a Trigger

See trigger events, setup, and event payloads for Telegram.

Configuration

Send Message

Operation

Send Message

Bot Token*

••••••••

Chat ID*

Enter Telegram Chat ID

Message*

Enter the message to send

Send Message (telegram_message)

Send messages to Telegram channels or users through the Telegram Bot API. Enables direct communication and notifications with message tracking and chat confirmation.

Input

Parameter	Type	Required	Description
`botToken`	string	Yes	Your Telegram Bot API Token
`chatId`	string	Yes	Target Telegram chat ID
`text`	string	Yes	Message text to send

Output

Parameter	Type	Description
`message`	string	Success or error message
`message_id`	number	Unique Telegram message identifier
`id`	number	Chat ID
`is_bot`	boolean	Whether the chat is a bot or not
`first_name`	string	Chat username (if available)

Send Photo

Operation

Send Photo

Bot Token*

••••••••

Chat ID*

Enter Telegram Chat ID

Photo*

Enter photo URL or file_id

Photo to send. Pass a file_id or HTTP URL

Caption

Enter optional caption

Media caption (optional)

Send Photo (telegram_send_photo)

Send photos to Telegram channels or users through the Telegram Bot API.

Input

Parameter	Type	Required	Description
`botToken`	string	Yes	Your Telegram Bot API Token
`chatId`	string	Yes	Target Telegram chat ID
`photo`	string	Yes	Photo to send. Pass a file_id or HTTP URL
`caption`	string	No	Photo caption (optional)

Output

Parameter	Type	Description
`message`	string	Success or error message
`message_id`	number	Unique Telegram message identifier
`id`	number	Chat ID
`is_bot`	boolean	Whether the chat is a bot or not
`first_name`	string	Chat username (if available)

Send Video

Operation

Send Video

Bot Token*

••••••••

Chat ID*

Enter Telegram Chat ID

Video*

Enter video URL or file_id

Video to send. Pass a file_id or HTTP URL

Caption

Enter optional caption

Media caption (optional)

Send Video (telegram_send_video)

Send videos to Telegram channels or users through the Telegram Bot API.

Input

Parameter	Type	Required	Description
`botToken`	string	Yes	Your Telegram Bot API Token
`chatId`	string	Yes	Target Telegram chat ID
`video`	string	Yes	Video to send. Pass a file_id or HTTP URL
`caption`	string	No	Video caption (optional)

Output

Parameter	Type	Description
`message`	string	Success or error message
`message_id`	number	Unique Telegram message identifier
`id`	number	Sender ID
`is_bot`	boolean	Whether the chat is a bot or not
`first_name`	string	Sender

Send Audio

Operation

Send Audio

Bot Token*

••••••••

Chat ID*

Enter Telegram Chat ID

Audio*

Enter audio URL or file_id

Audio file to send. Pass a file_id or HTTP URL

Caption

Enter optional caption

Media caption (optional)

Send Audio (telegram_send_audio)

Send audio files to Telegram channels or users through the Telegram Bot API.

Input

Parameter	Type	Required	Description
`botToken`	string	Yes	Your Telegram Bot API Token
`chatId`	string	Yes	Target Telegram chat ID
`audio`	string	Yes	Audio file to send. Pass a file_id or HTTP URL
`caption`	string	No	Audio caption (optional)

Output

Parameter	Type	Description
`message`	string	Success or error message
`message_id`	number	Unique Telegram message identifier
`id`	number	Sender ID
`is_bot`	boolean	Whether the chat is a bot or not
`first_name`	string	Sender

Send Animation

Operation

Send Animation

Bot Token*

••••••••

Chat ID*

Enter Telegram Chat ID

Animation*

Enter animation URL or file_id

Animation (GIF) to send. Pass a file_id or HTTP URL

Caption

Enter optional caption

Media caption (optional)

Send Animation (telegram_send_animation)

Send animations (GIFs) to Telegram channels or users through the Telegram Bot API.

Input

Parameter	Type	Required	Description
`botToken`	string	Yes	Your Telegram Bot API Token
`chatId`	string	Yes	Target Telegram chat ID
`animation`	string	Yes	Animation to send. Pass a file_id or HTTP URL
`caption`	string	No	Animation caption (optional)

Output

Parameter	Type	Description
`message`	string	Success or error message
`message_id`	number	Unique Telegram message identifier
`id`	number	Sender ID
`is_bot`	boolean	Whether the chat is a bot or not
`first_name`	string	Sender

Send Document

Operation

Send Document

Bot Token*

••••••••

Chat ID*

Enter Telegram Chat ID

Document

Upload document file

Document file to send (PDF, ZIP, DOC, etc.). Max size: 50MB

Document

Reference document from previous blocks

Reference a document file from a previous block

Caption

Enter optional caption

Media caption (optional)

Send Document (telegram_send_document)

Send documents (PDF, ZIP, DOC, etc.) to Telegram channels or users through the Telegram Bot API.

Input

Parameter	Type	Required	Description
`botToken`	string	Yes	Your Telegram Bot API Token
`chatId`	string	Yes	Target Telegram chat ID
`files`	file[]	No	Document file to send (PDF, ZIP, DOC, etc.). Max size: 50MB
`caption`	string	No	Document caption (optional)

Output

Parameter	Type	Description
`message`	string	Success or error message
`message_id`	number	Unique Telegram message identifier
`id`	number	Sender ID
`is_bot`	boolean	Whether the chat is a bot or not
`first_name`	string	Sender

Delete Message

Operation

Delete Message

Bot Token*

••••••••

Chat ID*

Enter Telegram Chat ID

Message ID*

Enter the message ID to delete

The unique identifier of the message you want to delete

Delete Message (telegram_delete_message)

Delete messages in Telegram channels or chats through the Telegram Bot API. Requires the message ID of the message to delete.

Input

Parameter	Type	Required	Description
`botToken`	string	Yes	Your Telegram Bot API Token
`chatId`	string	Yes	Target Telegram chat ID
`messageId`	string	Yes	Message ID to delete

Output

Parameter	Type	Description
`message`	string	Success or error message
`ok`	boolean	API response success status

Usage Instructions

Integrate Telegram into the workflow. Can send and delete messages. Can be used in trigger mode to trigger a workflow when a message is sent to a chat.

Notes

Category: tools
Type: telegram

Telegram

Use as a Trigger

On this page