Telegram

Connect a Telegram bot to send messages, photos, and files, and to start workflows when the bot receives new messages or commands.

Triggers

New Message

Fires when the bot receives any new message.

Output	Type	Description
messageId	number	Message ID
text	string	Message text
chatId	number	Chat ID
userId	number	Sender's user ID
username	string	Sender's username
date	number	Unix timestamp

New Command Message

Fires when the bot receives a message starting with / (a bot command).

Output	Type	Description
messageId	number	Message ID
command	string	The command text (e.g. /start)
args	string	Any text following the command
chatId	number	Chat ID
userId	number	Sender's user ID

Actions

Send Message

Sends a text message to a chat.

Input	Required	Description
Chat ID	Yes	The target chat, channel, or group ID
Text	Yes	Message text (supports Telegram markdown)

Output	Type	Description
messageId	number	ID of the sent message

Send Photo

Sends a photo to a chat.

Input	Required	Description
Chat ID	Yes	Target chat ID
Photo	Yes	Image file or URL
Caption	No	Text caption

Send Document

Sends a file to a chat.

Input	Required	Description
Chat ID	Yes	Target chat ID
Document	Yes	File to send
Caption	No	Text caption

Edit Message

Edits a previously sent message.

Input	Required	Description
Chat ID	Yes	Chat containing the message
Message ID	Yes	ID of the message to edit
Text	Yes	New message text

Forward Message

Forwards a message from one chat to another.

Input	Required	Description
From Chat ID	Yes	Source chat
Message ID	Yes	Message to forward
To Chat ID	Yes	Target chat

Get Chat

Retrieves information about a chat, channel, or group.

Input	Required	Description
Chat ID	Yes	Chat to look up

Output	Type	Description
chat	object	Chat info with id, title, type, username