TELEGRAM n8n INTEGRATION: AUTOMATE TELEGRAM WITH N8N
TELEGRAM N8N INTEGRATION: AUTOMATE TELEGRAM WITH N8N
Need help automating Telegram with n8n?
Our team will get back to you in minutes.
Why automate Telegram with n8n?
The Telegram n8n integration gives you access to 1 trigger and 22 distinct actions that cover the full spectrum of Telegram Bot API capabilities. From sending simple text messages to managing complex group interactions, you can automate virtually any Telegram operation.
Significant time savings are the first benefit you'll notice. Instead of manually sending notifications, updates, or responses, you set up smart rules that handle everything automatically. Need to alert your team when a new lead comes in? Done. Want to send daily reports to a channel? Automated. Customer submitted a form? Instant Telegram notification. The manual work disappears entirely.
Improved responsiveness becomes your competitive advantage. The webhook-based trigger monitors your bot 24/7, firing your workflows the instant someone sends a message, clicks a button, or interacts with your bot in any way. No polling delays, no missed messages—every interaction gets processed immediately.
Here's what you can build with this integration:
- Customer support bots that acknowledge inquiries and route them to the right team
- Notification systems that alert you about critical events from any connected app
- Content distribution workflows that automatically share media to channels
- Interactive approval systems using inline keyboards and callback queries
- Team coordination tools that manage group membership and announcements
How to connect Telegram to n8n?
! 1 stepHow to connect Telegram to n8n?
- 01
Add the node
Connecting Telegram to n8n requires creating a Telegram Bot and obtaining its API token. Here's the step-by-step process:Basic configuration:Create your Telegram Bot: Open Telegram and search for @BotFather. Start a conversation and send the command /newbot. Follow the prompts to name your bot and choose a username.Copy your Bot Token: Once created, BotFather will provide an API token that looks like 123456789:ABCdefGHIjklMNOpqrsTUVwxyz. Copy this token securely.Add credentials in n8n: In your n8n workflow, add a Telegram node. Click on "Credential to connect with" and select "Create New". Paste your Bot token into the access token field.Configure webhook (for triggers): When using the Telegram Trigger node, n8n automatically registers a webhook with Telegram. Ensure your n8n instance is publicly accessible or use a tunnel service during development.Test your connection: Add your bot to a test chat and send a message. Your trigger should fire, confirming the connection works.If you're new to n8n, check out our guide on how to build an AI Agent with n8n for a complete workflow tutorial.
TIP💡 TIP: Keep your bot token absolutely private—anyone with access can control your bot. If you suspect it's compromised, use /revoke with BotFather to generate a new one. Also, remember that bots can only receive messages in groups if they're added as members, and they need admin rights for certain operations like pinning messages.- 01
Need help automating Telegram with n8n?
Our team will get back to you in minutes.
Telegram triggers available in n8n
01 Trigger 01Webhook URLs
The Webhook URLs trigger is your gateway to real-time Telegram automation. This trigger monitors your Telegram bot and instantly fires your n8n workflow whenever specified events occur—no polling, no delays. It's the foundation for building responsive bots and notification systems.
Configuration parameters:
- Credential to connect with: This required dropdown lets you select the Telegram bot account that will be monitored. You'll need to have previously configured your bot credentials in n8n.
- Trigger On: This required multi-select dropdown is where the magic happens. You can choose multiple event types to monitor simultaneously: Message, Callback Query, Inline Query, Edited Message, Channel Post, Edited Channel Post, Poll, Shipping Query, and Pre-Checkout Query.
- Additional Fields: Optional parameters for advanced filtering and configuration.
Important note: When media is sent in a group (multiple photos at once), each attachment triggers a separate event. You can identify grouped media using the
media_group_idfield in the output.Typical use cases:
- Build a customer support bot that responds instantly to inquiries
- Create an approval workflow triggered by button clicks
- Monitor channel posts for moderation automation
- Process inline queries to provide dynamic search results
- Handle payment flows with shipping and checkout events
When to use it: Use this trigger whenever you need to react to user interactions with your Telegram bot in real-time. It's essential for chatbots, notification systems, and any workflow where immediate response matters.
Telegram actions available in n8n
01 Action 01Send Message
The Send Message action is the most fundamental and frequently used operation in the Telegram integration. It allows you to programmatically send text messages to any chat, user, or channel where your bot has access.
Key parameters:
- Chat ID: Required text field for the recipient's unique identifier. This can be a user ID, group ID, or channel username (prefixed with @).
- Text: Required multi-line field for your message content. Supports plain text and, with additional fields, HTML or Markdown formatting.
- Reply Markup: Optional dropdown to attach inline keyboards, custom keyboards, or force replies.
- Additional Fields: Access to parse mode, disable notification, protect content, and reply-to-message options.
Use cases:
- Send automated alerts when critical events occur in your systems
- Deliver personalized notifications to users based on their actions
- Post scheduled announcements to channels or groups
02 Action 02Send Photo
Send Photo lets you share images directly to Telegram chats, perfect for visual notifications, reports, or content distribution.
Key parameters:
- Chat ID: Required identifier for the target chat.
- Photo: Required text field accepting a URL or file ID of the image.
- Binary File: Toggle to send photos from binary data in your workflow.
- Reply Markup: Optional keyboard attachments.
- Additional Fields: Caption, parse mode, spoiler tag, and notification settings.
Use cases:
- Share automated screenshots or charts with your team
- Distribute visual content to channels
- Send confirmation images after form submissions
03 Action 03Send Video
Automate video distribution to Telegram chats with full control over presentation and metadata.
Key parameters:
- Chat ID: Required recipient identifier.
- Video: Required video URL or file ID.
- Binary File: Toggle for binary data input.
- Reply Markup: Keyboard options.
- Additional Fields: Caption, duration, dimensions, thumbnail, and spoiler settings.
Use cases:
- Automatically share tutorial videos when users request help
- Distribute video content to multiple channels simultaneously
- Send video confirmations or demonstrations
04 Action 04Send Document
Share files of any type—PDFs, spreadsheets, archives—directly through Telegram.
Key parameters:
- Chat ID: Required target identifier.
- Document: Required file URL, file ID, or binary reference.
- Binary File: Enable to send files from workflow data.
- Additional Fields: Caption, thumbnail, and notification settings.
Use cases:
- Deliver automated reports to stakeholders
- Share invoices or contracts after generation
- Distribute downloadable resources to users
05 Action 05Send Audio
Send audio files (MP3, etc.) with proper metadata display in Telegram's music player.
Key parameters:
- Chat ID: Required recipient.
- Audio: Required audio file URL or ID.
- Binary File: Toggle for binary input.
- Additional Fields: Caption, duration, title, performer, and thumbnail.
Use cases:
- Distribute podcast episodes automatically
- Send voice notifications or audio alerts
- Share music or audio content with subscribers
06 Action 06Send Animation
Send GIFs and animated content that auto-play in Telegram chats.
Key parameters:
- Chat ID: Required target chat.
- Animation: Required GIF URL or file ID.
- Binary File: Binary data toggle.
- Additional Fields: Caption, duration, dimensions, and thumbnail.
Use cases:
- Add engaging animated responses to bot interactions
- Share reaction GIFs in notification workflows
- Distribute animated content to entertainment channels
07 Action 07Send Sticker
Send stickers to add personality and visual flair to your automated messages.
Key parameters:
- Chat ID: Required recipient identifier.
- Sticker: Required sticker file ID or URL.
- Binary File: Toggle for binary input.
- Additional Fields: Notification and reply settings.
Use cases:
- Add fun acknowledgments to user actions
- Create playful bot personalities
- Celebrate milestones with themed stickers
08 Action 08Send Location
Share geographic coordinates that display as interactive maps in Telegram.
Key parameters:
- Chat ID: Required target chat.
- Latitude: Required numerical coordinate.
- Longitude: Required numerical coordinate.
- Reply Markup: Optional keyboard options.
- Additional Fields: Live location settings and notification options.
Use cases:
- Share delivery or pickup locations automatically
- Send event venue coordinates
- Provide real-time location updates
09 Action 09Send Media Group
Send multiple photos or videos as a single grouped message—perfect for albums and galleries.
Key parameters:
- Chat ID: Required recipient.
- Media: Configuration section for multiple media items. Click "Add Media" to attach photos or videos.
- Additional Fields: Notification and reply settings.
Use cases:
- Share product image galleries
- Send before/after comparison photos
- Distribute photo albums from events
10 Action 10Send Chat Action
Display typing indicators, upload animations, and other status updates to enhance user experience.
Key parameters:
- Chat ID: Required target chat.
- Action: Required dropdown with options like "Typing", "Upload Photo", "Record Video", etc.
Use cases:
- Show "typing" while processing complex requests
- Indicate file upload progress
- Create more natural bot interactions
11 Action 11Send and Wait for Response
Send a message and pause your workflow until the user responds—essential for interactive approval flows.
Key parameters:
- Chat ID: Required recipient.
- Message: Required content to send.
- Response Type: Required dropdown—"Approval" creates clickable buttons.
- Approval Options: Configure button labels and values.
Use cases:
- Build approval workflows for requests or purchases
- Create interactive decision trees
- Implement confirmation steps before critical actions
12 Action 12Edit Message Text
Modify the content of previously sent messages to update information dynamically.
Key parameters:
- Chat ID: Required chat identifier.
- Message ID: Required ID of the message to edit.
- Text: Required new message content.
- Reply Markup: Update inline keyboards.
- Additional Fields: Parse mode and link preview settings.
Use cases:
- Update order status messages in real-time
- Refresh dashboard messages with new data
- Modify countdown or progress messages
13 Action 13Delete Chat Message
Remove messages from chats programmatically for moderation or cleanup.
Key parameters:
- Chat ID: Required chat identifier.
- Message ID: Required ID of the message to delete.
Use cases:
- Auto-delete temporary notifications
- Implement content moderation rules
- Clean up expired announcements
14 Action 14Pin Chat Message
Pin important messages to the top of group chats for visibility.
Key parameters:
- Chat ID: Required group or channel ID.
- Message ID: Required message to pin.
- Additional Fields: Silent pinning option.
Use cases:
- Automatically pin daily announcements
- Highlight critical updates in busy groups
- Pin event information or rules
15 Action 15Unpin Chat Message
Remove pinned status from messages when they're no longer relevant.
Key parameters:
- Chat ID: Required chat identifier.
- Message ID: Required message to unpin.
Use cases:
- Rotate pinned content automatically
- Unpin expired announcements
- Clean up after events conclude
16 Action 16Get File
Retrieve file information and optionally download file content from Telegram.
Key parameters:
- File ID: Required unique identifier of the file.
- Download: Toggle to actually download the file content.
- Additional Fields: Extra configuration options.
Use cases:
- Process documents sent by users
- Archive media from channels
- Extract files for further processing in workflows
17 Action 17Telegram Chat: Get
Retrieve detailed information about a specific chat, including title, type, and settings.
Key parameters:
- Chat ID: Required identifier of the chat to retrieve.
Use cases:
- Verify chat properties before taking actions
- Gather chat metadata for logging
- Check chat type for conditional routing
18 Action 18Get Administrators
Retrieve the list of administrators in a group or channel with their permissions.
Key parameters:
- Chat ID: Required group or channel identifier.
Use cases:
- Audit admin lists automatically
- Build permission-aware workflows
- Generate admin reports
19 Action 19Get Member
Retrieve information about a specific user's membership in a chat.
Key parameters:
- Chat ID: Required chat identifier.
- User ID: Required user to look up.
Use cases:
- Check user status before granting access
- Verify membership for gated content
- Build user profile enrichment flows
20 Action 20Leave Chat
Make your bot leave a group or channel programmatically.
Key parameters:
- Chat ID: Required chat to leave.
Use cases:
- Implement bot self-removal after task completion
- Leave chats that violate usage policies
- Clean up inactive group memberships
21 Action 21Set Title
Change the title of a group chat (requires admin rights).
Key parameters:
- Chat ID: Required group identifier.
- Title: Required new title text.
Use cases:
- Rotate group names for events
- Update titles with dynamic information
- Rebrand groups automatically
22 Action 22Set Description
Update the description of a group or channel.
Key parameters:
- Chat ID: Required chat identifier.
- Description: Required new description text.
Use cases:
- Update group descriptions with current information
- Rotate promotional messages
- Add dynamic content to channel descriptions
23 Action 23Answer Query
Respond to callback queries from inline keyboard button presses.
Key parameters:
- Query ID: Required callback query identifier from the trigger.
- Additional Fields: Text, show alert, URL, and cache time options.
Use cases:
- Acknowledge button presses with confirmations
- Show popup alerts for important actions
- Complete interactive menu flows
24 Action 24Answer Inline Query
Respond to inline queries when users type @yourbot in any chat.
Key parameters:
- Query ID: Required inline query identifier.
- Results: Required array of results to display.
- Additional Fields: Cache time, personal results, and switch PM options.
Use cases:
- Build search bots that work in any chat
- Provide quick-access content suggestions
- Create inline content sharing tools
For more complex integrations, you can combine this with WhatsApp n8n integration to create multi-channel messaging solutions.
Build your first workflow with our team
Drop your email and we'll send you the catalog of automations you can ship today.
- Free n8n & Make scenarios to import
- Step-by-step setup docs
- Live cohort + community support
Frequently asked questions
Is the Telegram n8n integration free to use?
Yes, the Telegram n8n integration is completely free. Telegram's Bot API has no usage fees, and n8n (whether self-hosted or on the cloud free tier) doesn't charge extra for the Telegram nodes. You can send messages, receive triggers, and use all 22 actions without any per-message costs. The only considerations are Telegram's rate limits (around 30 messages per second to different chats) and your n8n instance's execution limits if you're on a hosted plan. For most automation use cases, you'll never hit these limits. If you're exploring n8n alternatives, you might also want to check out our n8n review for a detailed platform comparison.What data can I sync between Telegram and n8n?
The integration handles a comprehensive range of data types. For incoming data (via the trigger), you receive message content, sender information, chat details, media file IDs, callback data from buttons, inline queries, and poll responses. For outgoing data (via actions), you can send text, photos, videos, documents, audio, animations, stickers, and locations. You can also manage chat properties like titles and descriptions, retrieve member information, and handle interactive elements like inline keyboards. All data flows as JSON, making it easy to transform and route to other applications in your workflow. You can also connect Telegram data to databases like Airtable via n8n or sync with your HubSpot CRM.How long does it take to set up the Telegram n8n integration?
Most users complete the setup in under 10 minutes. Creating a bot with BotFather takes about 2 minutes. Configuring the credentials in n8n is another 2-3 minutes. Building your first working workflow—say, a simple notification bot—can be done in the remaining 5 minutes. The webhook registration happens automatically when you activate a workflow with a Telegram Trigger node. If you're running n8n locally, you might need an additional 5 minutes to set up a tunnel service like ngrok for the webhooks to work during development. For troubleshooting tips, check our n8n troubleshooting guide. You can also explore ready-to-use templates in our automation catalog.
