Telegram Bot Toolkit
The Telegram Bot Toolkit is a workflow node. Its tools include Telegram Send Message, Telegram Send Media, Telegram Get Chat Member, and Telegram Create Invite Link, plus 5 more listed below. Create a connection before you use any of these tools. Type @ in a field when the value should come from an earlier step.
Authentication
Create a Telegram bot connection before you use any of these tools. Set it up on the first Telegram Bot node.
- On the node, open Connection.
- Choose Create Connection.
- Enter a Connection Name.
- Open @BotFather, send
/newbot, and follow the prompts. - Copy the bot token and paste it into Bot Token.
- Select the new connection.
Other Telegram Bot nodes in the same workflow reuse that connection. To use another connection on one node, choose Configure different connection for this step.
Tools
Telegram Send Message
Runs the telegram send message tool.
| Field | Required | Description |
|---|---|---|
| Chat ID | Yes | Unique identifier for the target chat (numeric ID or '@channelusername'). |
| Message | Yes | The text of the message to be sent (1-4096 characters). Type @ to select a variable. |
| Format | No | Parse mode for the message. Leave empty (default) to send as plain text. Set to 'MarkdownV2' or 'HTML' to enable formatting; when MarkdownV2 is used, reserved characters are auto-escaped which means literal markup like bold will be shown as text — pre-escape your own markup or use 'HTML' for richer formatting. Default is ``. Type @ to select a variable. |
| Message Thread ID | No | Unique identifier for the target message thread (forums supergroups only). Default is null. Type @ to select a variable. |
| Disable Web Page Preview | No | If true, disables link previews for links in this message. Default is false. |
| Reply Markup | No | Additional interface options as a JSON-serialized object (inline keyboard, custom reply keyboard, etc.). Default is null. |
Telegram Send Media
Runs the telegram send media tool.
| Field | Required | Description |
|---|---|---|
| Chat ID | Yes | Unique identifier for the target chat (numeric ID or '@channelusername'). |
| Media Type | Yes | Type of media to send: 'photo', 'video', 'sticker', or 'animation'. Type @ to select a variable. |
| Media URL | No | HTTP URL of the media. Telegram will fetch and send it. Provide either media_url or media_id. Default is null. Type @ to select a variable. |
| Media ID | No | File ID of media already uploaded to Telegram. Provide either media_url or media_id. Default is null. Type @ to select a variable. |
| Caption | No | Caption for the media (0-1024 characters). Default is null. Type @ to select a variable. |
| Format | No | Parse mode for the caption. Leave empty (default) for plain text. Set to 'MarkdownV2' or 'HTML' to enable formatting; MarkdownV2 captions are auto-escaped. Default is ``. Type @ to select a variable. |
| Message Thread ID | No | Unique identifier for the target message thread (forums supergroups only). Default is null. Type @ to select a variable. |
Telegram Get Chat Member
Runs the telegram get chat member tool.
| Field | Required | Description |
|---|---|---|
| Chat ID | Yes | Unique identifier for the target chat (numeric ID or '@channelusername'). |
| User ID | Yes | Unique identifier of the target user. Type @ to select a variable. |
Telegram Create Invite Link
Runs the telegram create invite link tool.
| Field | Required | Description |
|---|---|---|
| Chat ID | Yes | Unique identifier for the target chat (numeric ID or '@channelusername'). |
| Name | No | Invite link name (max 32 characters). Default is null. Type @ to select a variable. |
| Expire Date | No | ISO-8601 timestamp when the link expires (e.g. '2026-12-31T23:59:59Z'). Converted to unix seconds. Default is null. Type @ to select a variable. |
| Member Limit | No | Maximum number of users that can join via this link (1-99999). Default is null. |
Telegram Delete Message
Runs the telegram delete message tool.
| Field | Required | Description |
|---|---|---|
| Chat ID | Yes | Unique identifier for the target chat (numeric ID or '@channelusername'). |
| Message ID | Yes | Identifier of the message to delete. |
Telegram Edit Message Text
Runs the telegram edit message text tool.
| Field | Required | Description |
|---|---|---|
| Chat ID | Yes | Unique identifier for the target chat (numeric ID or '@channelusername'). |
| Message ID | Yes | Identifier of the message to edit. |
| Text | Yes | New text of the message (1-4096 characters). Type @ to select a variable. |
| Format | No | Parse mode for the message. Leave empty (default) for plain text. Set to 'MarkdownV2' or 'HTML' to enable formatting; MarkdownV2 text is auto-escaped. Default is ``. Type @ to select a variable. |
Telegram Get Chat
Runs the telegram get chat tool.
| Field | Required | Description |
|---|---|---|
| Chat ID | Yes | Unique identifier for the target chat (numeric ID or '@channelusername'). |
Telegram Set Webhook
Runs the telegram set webhook tool.
| Field | Required | Description |
|---|---|---|
| URL | Yes | HTTPS URL to send Telegram updates to (e.g. the Valkyrie /tool-webhook/{tool_id} URL). Use an empty string to remove the webhook. Type @ to select a variable. |
| Secret Token | No | A secret token sent in every webhook request in the header 'X-Telegram-Bot-Api-Secret-Token'. Use this together with header auth on the Valkyrie trigger to validate incoming requests. Default is null. Type @ to select a variable. |
| Allowed Updates | No | List of update types to receive (e.g. ['message', 'edited_message']). Defaults to ['message'] when omitted. Pass an explicit list to receive other update types such as 'edited_message' or 'callback_query'. Default is null. |
| Drop Pending Updates | No | If true, drop all pending updates that arrived before the webhook was set. Default is false. |
Telegram Delete Webhook
Runs the telegram delete webhook tool.
| Field | Required | Description |
|---|---|---|
| Drop Pending Updates | No | If true, drop all pending updates queued before the webhook was removed. Default is false. |
Related
Agents can use this integration from chat. See Telegram Bot.
See all integrations on the toolkits overview.