Telegram Bot AI Tools icon

Telegram Bot AI Tools

Provides Telegram Bot API tools (send messages, photos, documents, get files…) to an AI Agent node

Telegram Bot AI Tools

AI-generated

Summary

Expose selected Telegram Bot API tools as callable actions within an AI Agent workflow component, enabling sending messages, media, managing chats, and bot settings via parameterized function calls.

Inputs

  • Tools to Enable (required) — Select which Telegram Bot functionalities to expose to the AI Agent, such as sending messages, photos, documents, videos, audio, locations, polls, and more.
  • Tool Description Override — Optional text to override the description shown to the AI Agent for all enabled tools, providing custom guidance or contextual information.

Output shape

a list of AI tools each representing a specific Telegram Bot API function enabled by the user.

Each tool is a structured callable object with defined input schemas matching Telegram Bot API parameters. Calling a tool sends a request to Telegram and returns the operation result (e.g., sent message objects or success statuses). Binary data (e.g., files) can be passed between tools using binary property references stored in n8n's binary data system. The node itself produces no direct output except an informational message; it is intended to be used by connecting its 'Tool' output to an AI Agent node's 'Tools' input.

Examples

Example 1: Enable and expose tools for sending text messages and photos to Telegram chats.

User selects 'Send Message' and 'Send Photo' in 'Tools to Enable'. AI Agent can then instruct sending messages or photos by invoking corresponding tools.

Example 2: Retrieve files sent to the bot and process them in the workflow.

User enables 'Get File' tool. AI Agent can download files from Telegram by file_id and store them as n8n binary data for further use by other nodes.

Links

Discussion