Action

Perform operations through your connected Telegram account

The Action block executes concrete Telegram operations on behalf of your linked account. It is the main tool for automating chats and groups.

Message actions

Send messages

Send text, audio, or media to one or many chats

Parameters:

Recipient chat ID(s)One id or @username, a list, or {{ [id1, id2] }} for several chats
Message textBody of the message to send
MediaPath to media—a URL or a variable from the Trigger block, for example.
Media spoilerHide media behind a spoiler

Mark all messages read

Mark every message in a chat as read

Parameters:

Chat IDChat whose messages should be marked read

Forward messages

Forward one or many messages from one chat to another

Parameters:

Destination chat IDChat that should receive the forwarded messages
Source chat IDChat that originally contained the messages
Message IDsJSON array of message IDs to forward
Hide senderDo not show the original author on the forward
Strip captionsRemove media captions
With my reaction (coming soon)In development

Note: Provide message IDs as a JSON array: ["123", "124", "125"]

Edit message

Change the text of a message you already sent

Parameters:

Chat IDChat that contains the message
Message IDID of the message to edit
New textReplacement text

Delete messages

Remove one or more messages from a chat

Parameters:

Chat IDChat where messages should be deleted
Message IDsJSON array of message IDs to delete
Revoke for everyoneDelete the messages for all participants

Note: Provide message IDs as a JSON array: ["123", "124", "125"]

Get message IDs

List message IDs from a chat and optionally export them to variables

Parameters:

Chat IDChat to read message IDs from
OffsetMessage ID cursor for pagination (optional)
LimitMaximum number of messages (optional)
Export to variablesVariable names that will store the returned IDs

Tip: Export IDs into variables for follow-up blocks such as forward or delete.

Get chat participants

List group/supergroup members with pagination. If the member list is hidden, result has participants_hidden=true

Parameters:

Chat IDGroup or supergroup
LimitParticipants per request (default 200, max 2000)
OffsetPagination offset (0, 200, 400…)
SearchSearch by name or username (optional)
FilterFilter: all, admins, bots, recent, banned, kicked
Export to variablesVariable names that will store the JSON result

Comment on channel post

Leave a comment under a channel post. Works only in broadcast channels on posts with comments enabled.

Parameters:

ChannelChannel id or @username
Post IDID of the channel post to comment on
Comment textComment text (or use media)
MediaOptional media attachments for the comment

User management

Remove (kick) user

Remove a user from a chat or group—they can rejoin if allowed

Parameters:

Chat IDChat to remove the user from
User IDUser to remove

Change user permissions (includes banning)

Adjust a member’s rights in a chat or supergroup

Parameters:

Chat IDChat where permissions change
User IDMember whose rights you are editing
Until dateDate/time when the restriction should expire (optional—omit for permanent changes)

Permissions:

• View messages
• Send messages
• Send media
• Send stickers
• Send links
• Send polls
• Change chat info
• Invite users
• Pin messages

Change administrator rights

Promote or demote admins inside a chat or group

Parameters:

Chat IDChat where admin rights change
User IDAdministrator whose rights you are editing

Administrator capabilities:

• Anonymous
• Manage calls
• Delete messages
• Ban users
• Invite users
• Pin messages
• Add admins

Chat management

Delete conversation

Fully delete a private chat or leave a group and remove history

Parameters:

Chat IDChat to delete

Good to know

  • •Every action runs through the Telegram account you connected
  • •Make sure that account actually has permission to perform the action
  • •Chat and user IDs usually come from the Trigger block