DriversRecommendedOutdated drivers can make a good PC feel brokenScan driver issues before chasing fixes manually.Scan NowOctober DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsPC HealthRecommendedCrashes, freezes, slowdowns? Check your PC nowSpot repairable issues before they interrupt work.Check PC×
Skip to content
VGSources
Blog

How to Set Up the n8n Telegram Integration

Create a Telegram bot with @BotFather, add its API token to n8n, capture chat IDs with Telegram Trigger, and send replies or channel notifications while avoiding webhook conflicts and Telegram’s message limits.
Length10 min Posted Quest giverVGSources Team
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

To connect Telegram to n8n, create a bot with Telegram’s official @BotFather, copy its API token into an n8n Telegram credential, then use Telegram Trigger for incoming updates and a Telegram action node such as Send Message for replies. Direct chats, groups, channels, and self-hosted deployments have different destination and delivery requirements, so configure and test those details before activating the workflow.

What the n8n–Telegram integration does

The integration connects Telegram’s Bot API to n8n workflows. A Telegram Trigger starts a workflow when the bot receives an update, such as a message. A Telegram action node can then send a reply, post a notification, process a callback flow, or perform another supported operation using the same bot credential.

As an Amazon Associate I earn from qualifying purchases.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

The basic pattern is:

  1. A person sends a message or other update to your Telegram bot.
  2. Telegram delivers that update to n8n.
  3. The Telegram Trigger exposes the update data, including the chat identifier.
  4. Subsequent nodes use that identifier to reply or send a notification.

For a simple reply, one trigger and one Send Message node are enough. More involved workflows can add media processing, callback queries, approval steps, retries, or notifications to a group or channel.

What you need before configuring n8n

  • A Telegram account with access to @BotFather.
  • An n8n workspace or self-hosted instance where you can create credentials and workflows.
  • A clear destination: a direct chat, private group, public channel, or private channel.
  • For self-hosted webhook delivery, a stable, publicly reachable HTTPS endpoint.
  • A plan for protecting the bot token. Telegram says that anyone who has the token has full control over the bot, so treat it as a password.

You do not need to create a separate credential for the trigger and the action node. The Telegram credential created in n8n can be selected by both.

#1 Best Overall
Sale
Gaoye Blue Light Blocking Glasses
  • BLUE LIGHT BLOCKING GLASSES: Our blue light glasses for women boast UV400 protection, blocking harmful blue rays from computer screens. With these bluelight glasses women, you can enjoy gaming, reading, or watching TV with no worries of eye strain.
  • EYE RELIEF: Our blue light glasses are engineered to reduce blurry vision or strain caused by prolonged screen time. These womens blue light glasses aid in better sleep by preventing blue light from disrupting your natural sleep cycle, helping you fall asleep faster and enjoy a more restful night's sleep, making them the perfect christmas present.
  • COMFORTABLE: Crafted from durable material, our trendy blue light glasses for woman or blue light glasses men ensure long-lasting comfort. The high-transmittance lenses accessories, gamer gifts for men, help keep your eyes relaxed. Perfect stocking stuffers, gifts for gamers men, christmas gifts for men, halloween costumes.
  • LIGHTWEIGHT: These clear blue light glasses feature a lightweight frame, meaning they’ll stay comfy for long-term wear. Perfect as blue blockers glasses for women or mens blue light glasses, these non-prescription fake glasses for men can be worn throughout the day. The blue light blocking glasses women feature polycarbonate HD lenses, which are anti-reflective and restore true color.
  • WORRY-FREE PURCHASE: If you experience any issues, our support team is ready to assist you quickly. These are the perfect costume glasses for cosplay dressing up.

Create a Telegram bot with @BotFather

Start the bot-creation command

  1. Open Telegram and search for the official @BotFather account.
  2. Open the conversation and send /newbot.
  3. Follow the prompts for a display name and a username.
  4. Copy the API token BotFather returns and store it in a password manager or another protected secret store.

Telegram’s own tutorial describes the same process: contact @BotFather, issue /newbot, and follow the prompts until a new token is provided.

Choose a valid username

The username must be 5–32 characters long, use Latin letters, numbers, or underscores, and end in bot. Telegram states that the username cannot be changed later, so check the spelling and branding before confirming it. The display name and username serve different purposes: the display name is what people see, while the username is the unique handle used to find the bot.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Protect or replace the token

Do not put the token in workflow text, screenshots, public repositories, issue reports, or chat messages. If it is exposed, use BotFather to revoke or regenerate it, replace the value in n8n, and test the workflow again. A token leak is not merely a configuration mistake; possession grants control of the bot.

Add the bot token to an n8n credential

  1. In n8n, open the credentials area and create a new Telegram credential.
  2. Paste the BotFather API token into the Access Token field.
  3. Save the credential.
  4. When you add a Telegram Trigger or Telegram action node, select this saved credential in the node’s credential selector.

Keep the token inside the credential rather than copying it into node parameters. This lets the trigger and action nodes share one secret and makes rotation easier if the token must be replaced.

Configure Telegram Trigger for incoming updates

Add and authenticate the trigger

  1. Create a new n8n workflow.
  2. Add a Telegram Trigger node.
  3. Select the Telegram credential containing the bot token.
  4. Choose the event that should start the workflow, such as a new message or another supported Telegram update.
  5. Execute the trigger node for a test.
  6. In Telegram, open the bot chat and send /start or another short message.
  7. Return to n8n and inspect the execution data.

The captured update normally contains the message information and the chat object. Record the chat identifier from this data; it is the most reliable value to use when sending a direct reply or targeting a group.

Rank #2
Windex Gaming Cleaning Wipes, Pre-Moistened Wipes to Instantly Clean all Gaming Gear and Electronics, Resealable Packaging for a Freshness Lock, 25 count (Pack of 1)
  • WINDEX GAMING WIPES: effortlessly clean all your gaming gear and gaming electronics in one easy step with our new Windex Gaming Wipes
  • AMMONIA FREE: our ammonia-free formula is safe to use on all of your favorite gaming equipment like consoles, headsets, controllers, screens, keyboards, and more
  • PRE-MOISTENED WIPES: each wipe instantly removes dust, dirt, and stubborn smudges and fingerprints leaving a streak-free shine
  • ANTI-STATIC: great for cleaning and wiping down your gaming gear and electronics leaving behind no visible residue
  • COMPACT RESEALABLE PACKAGE: store your pack of Windex Gaming Wipes anywhere in your home for whenever a quick and easy wipedown is needed

Use the trigger output as your first chat-ID check

Do not guess a destination identifier when a trigger execution can provide it. Send a test message from the exact chat you intend to automate, inspect the resulting update, and map the relevant chat-ID field into the downstream node. This approach also confirms that the bot can actually see messages in that chat.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Send a reply or notification

  1. Add a Telegram node after the Telegram Trigger.
  2. Select the same Telegram credential.
  3. Choose the Message resource.
  4. Choose Send Message.
  5. Enter the destination in the Chat ID field, or map the ID from the trigger output.
  6. Enter the reply or notification text.
  7. Execute the node and confirm that the message arrives in Telegram.

For a direct reply, map the chat ID from the incoming update instead of hard-coding it. That allows one workflow to answer different users. For a fixed alert destination, a stored chat ID is appropriate, provided you have verified that it belongs to the intended chat.

Chat IDs for chats, groups, and channels

Destination Identifier to use Important setup detail
Direct chat with the bot Chat ID captured from a Telegram Trigger execution The user must open the bot and send a message before the bot can receive a test update.
Public channel @channelusername Add the bot to the channel and grant the administrator access required by the operation.
Private group Numeric chat ID entered with a leading minus sign Capture the ID from trigger output, the browser URL, or @RawDataBot.
Private channel Appropriate numeric identifier Use the channel’s numeric identifier and ensure the bot has the required access.

Finding a private group ID

n8n’s common-issues guidance identifies three practical methods:

  • Send a message in the group and read the chat ID in a Telegram Trigger execution.
  • Use the Telegram browser URL when the group is open in Telegram Web.
  • Use @RawDataBot to inspect Telegram update data.

When you enter a private group ID in n8n, include the leading -. Omitting that sign can cause a valid group to be treated as a different destination.

Why a public username is not universal

The @channelusername form is for a public channel. It does not replace the numeric identifier required by private groups and private channels. If a send operation fails despite a correctly spelled public username, verify that the channel is public and that the bot has been added with sufficient rights.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #3
Sale
LISEN Cell Phone Stand Phone Holder for Desk, Office Decor Gadgets for Men
  • Ergonomic & Adjustable Design: Fight "text neck" and improve your posture. Designed for comfort, it offers an adjustable height (7.1in-8.5in) (1.4in adjustable range) and angle (5°-85°) Please note: cell phone stand is only 9 inches tall—the length of a standard pencil
  • Without blocking subtitles Perfect for office desk Tiktok Face Time Zoom video—this is the ultimate kitchen desk essential for phones! Perfect viewing experience while reducing neck back strain, A must-have for gamers streamers desk, and anyone who values both style and support!
  • Sleek & Stable Design fits Otterbox Case: Say goodbye to bent cables, tangles, and tip-overs! LISEN’s stylish adjustable desk phone holder features a built-in charging hole and smart cable management, keeping your phone secure and your workspace clutter-free cool gadgets for men
  • ANTI-SLIP DESIGN free hands: The under 10.00 items easy gadgets back and the bottom of this kitchen essentials for women are fully covered by anti-skid silicone, which LISEN stand up desk decor can provide maximum protection device from any scratches and slides
  • Your Perfect Viewing Companion:If your product arrives damaged or breaks within 365 days, reach out to LISEN for a quick and hassle-free solution. Struggling with assembly, like tightening the screw? We’ve got your back! Your experience matters to us. (Product including: phone Holder stand*1, screw*1, hexagon screwdriver*1, specification*1)

Post to a Telegram channel

  1. Open the target channel in Telegram.
  2. Add the bot as a channel administrator.
  3. Grant the permissions required for posting or for the specific message operation you plan to run.
  4. In n8n, use a Telegram node with the Message resource and the relevant operation.
  5. Use @channelusername for a public channel, or the appropriate numeric identifier for a private destination.
  6. Run a small test post before activating the workflow.

Most Telegram message operations require the bot to be present in the channel. A valid token and a valid channel username do not compensate for missing membership or administrator access.

Test before activating the workflow

  1. Leave the workflow in manual execution while configuring it.
  2. Execute the Telegram Trigger node.
  3. Send /start or a short test message to the bot.
  4. Confirm that the trigger receives an update and that the chat ID is visible in the data.
  5. Execute the downstream Send Message node with that captured ID.
  6. Verify the reply in Telegram.
  7. If the workflow targets a group or channel, repeat the test from that exact destination.
  8. Test any media, callback, or approval events that the production workflow will handle.
  9. Activate the workflow only after the manual execution succeeds.

Testing each destination separately catches permission and identifier errors before they become silent production failures.

Webhook requirements for self-hosted n8n

Use a public HTTPS endpoint

Telegram’s Bot API requires HTTPS requests. A self-hosted n8n instance using Telegram Trigger therefore needs a stable, publicly reachable HTTPS URL that Telegram can contact. A local address, an HTTP-only address, or an endpoint hidden behind an inaccessible firewall will not receive webhook updates.

Confirm that the external URL resolves to the n8n webhook endpoint, that the TLS certificate is valid, and that inbound requests can reach the n8n process. Inspect the webhook status when diagnosing delivery problems.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Choose one update-delivery method

Telegram provides two mutually exclusive ways to receive bot updates: getUpdates long polling and outgoing webhooks. Long polling does not work while an outgoing webhook is configured. Consequently, another workflow, service, or test script must not compete with n8n for the same bot’s updates.

Rank #4
Ledagic IC+RGBW USB Powered Led Light Bar with App & Remote Control, 2 Pack
  • Easy Installation: Our gaming lights have been designed to enhance your entertainment experience. Simply position the led light bar next to your TV or game console to create a game room environment with ease. They come with USB power and a 60 inch cord for direct mounting and mobility
  • Audio Syncing & Extensive Mode: The built-in high-sensitivity music sensor allows you to sync the TV led lights to your favorite music. Lights react and move to the beat of music, film and game audio, creating an incredible immersive sound and light experience – and all without the need for an additional hub. You can choose from 64+ patterns, including strobe, illusion, jump, energy, gradient, running, chasing, fluttering mode etc. Each mode can be applied to different scenes
  • 64+ Chasing IC+RGB & W Effect: The independent control design of IC+RGB and white all-in-one multifunctional rgbw led bar lights monitor backlight allows you to easily switch the led lights for desk between IC+RGB and white to enjoy a variety of lighting effects, you can choose white lighting mode with high brightness for better illumination when working, etc. Choose IC+RGB lighting mode when you need to create an entertaining atmosphere for the light show, 16 million colours of Color changing rgb light bar let you dance to the beat and create a dynamic party atmosphere
  • Dynamic and Dimmable Lights: 1%-full brightness free brightness adjustment gives you the flexibility to adjust dimmable led light bar for room decorations or a variety of occasions
  • USB Powered: USB light bars for room can be powered by powernank, usb charger, TV, Monitor, laptop PC mainframe, making behind TV led lighting bar easy to install in any location.TV led lights are powered by the TV usb interface / PC mainframe, can be turned on/off synchronously with TV / PC

If a bot was previously connected to a polling consumer, remove that competing consumer or otherwise switch the bot cleanly to webhook delivery before testing the n8n trigger. Likewise, do not configure multiple webhook consumers for one bot and expect each to receive every update.

Webhook security

Telegram’s setWebhook method supports an optional secret_token header. If you manage webhook configuration outside n8n, use that facility with a secret value and verify the header at the receiving endpoint. Keep the secret separate from the bot token.

Message size and throughput limits

Text length

n8n documents a 4096-character limit for Send Message text after entity parsing. Formatting entities can therefore affect the final size. For generated or user-supplied content, measure the text that will actually be sent and split it into multiple messages before submitting it.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Sending rate

n8n documents Telegram’s sending limit as 30 messages per second. Bulk notifications should be throttled rather than emitted in an unrestricted loop. Add batching, delays, retry handling, and logging so a temporary API error does not lose the entire delivery run.

Practical message design

  • Split long output at paragraph or sentence boundaries where possible.
  • Preserve context by adding a part number when a response spans several messages.
  • Throttle bursts of notifications instead of sending all items simultaneously.
  • Record failed sends and the destination ID so they can be retried safely.
  • Keep formatting predictable when entity parsing is enabled.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Common failures and fixes

The Telegram Trigger receives no event

  • Confirm that the workflow is being executed manually or is active.
  • Check that the selected credential contains the current token.
  • Send the message to the correct bot account, not to BotFather or another similarly named account.
  • Verify that the user has initiated the bot chat by sending a message.
  • For self-hosted n8n, verify that the public URL is HTTPS and reachable.
  • Check whether another polling process or webhook is consuming the bot’s updates.

The token is invalid or has been exposed

Regenerate or revoke the token with BotFather, update the n8n Telegram credential, save it, and rerun the manual trigger test. Do not continue using a token that appeared in a public log, screenshot, repository, or message.

Best Value
Sale
HUANUO FlowLift™ Dual Monitor Stand, Fully Adjustable Gaming Monitor Desk Mount for 13–32″ Computer Screens, Full Motion VESA 75x75/100x100 with C-Clamp & Grommet Base, Each Arm Holds 4.4 to 19.8 lbs
  • Compatible with Wide Screens - To ensure compatibility with the dual monitor mount, your each monitor must meet three conditions at the same time: First, computer screens size range: 13 to 32 inches. Second, screen weight range: 4.4 to 19.8 lbs. Third, the back of the monitor screen must have VESA mounting holes with a pitch of 75x75mm or 100x100mm.
  • Regarding the compatibility with desks - Your desk must meet three conditions at the same time: First, desk material: Only wooden desks are recommended, plastic or glass desks cannot be used. Second, desk thickness range: 0.59" - 3.54". Third, the bottom of the desk should not have any cross beams or panels, as this will interfere with installation. We recommend carefully checking that your desk and monitors meets all above conditions before purchasing.
  • Dual C-Clamp Hold - Worried your dual monitors might wobble or slip? Our upgraded base uses a larger platform plus a dual C-clamp structure to lock the dual monitor arm firmly to your desk. Each arm safely keeps your screens steady while you type, click and game—no shaking, no sliding, just a clean and secure setup you can trust every day. It also provides Grommet Mounting installation choice, both options ensure stable and secure fixation for your 0.59" - 3.54" desk.
  • Full-Motion Adjustment For Comfortable View - Pull the screen closer when you’re deep in a spreadsheet, push it back to watch videos, or rotate to portrait for coding — moving everything smoothly with just one hand. The monitor stand offers +85°/-50° tilt, ±90° swivel and 360° rotation. Raise your monitor up to 15.75″ to support a healthy sitting posture. Whether you’re working from home, gaming through the night, or switching between video calls and documents, getting the screens to your natural line of sight helps relieve neck, shoulder and back strain so you can stay focused longer with less fatigue.
  • Keep Your Desk Organized: By lifting both screens off the desktop, this dual monitor stand opens up valuable space for your keyboard, notebook, docking station or a simple, clutter-free work area. Built-in cable management guides wires along the arms, keeping cords out of sight and out of the way. Enjoy a tidy, modern workstation that looks as good as it feels to use.

The message goes to the wrong destination

Capture the chat ID from a trigger execution made in the intended chat. Use @channelusername only for a public channel. Use the signed numeric ID, including its leading minus sign, for a private group. Review mapped fields if an expression is selecting an earlier execution’s chat data.

A channel send fails

Add the bot to the channel as an administrator and grant the permissions required by the operation. Then verify that the destination identifier matches the channel’s public username or private numeric ID.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

A self-hosted trigger never receives updates

  • Check that the n8n external URL is publicly reachable over HTTPS.
  • Inspect webhook status and server logs for rejected requests.
  • Confirm that no getUpdates consumer is active for the same bot.
  • Check that another webhook has not been configured for that bot.
  • After correcting the conflict, run a fresh manual trigger test.

Updates are duplicated or missing

Look for another workflow, script, or service connected to the same bot. Telegram permits only one update-delivery mode at a time, so a competing webhook or polling connection can prevent n8n from receiving the expected stream.

Choosing an implementation pattern

Decision Use this when What to verify
Telegram Trigger plus Send Message You need a straightforward reply or notification workflow. Credential, event type, mapped chat ID, and message length.
Telegram Trigger plus media or callback handling The workflow processes files, interactive callbacks, or richer updates. Each update type is tested manually before activation.
Managed n8n deployment You want an n8n environment where the public webhook URL is supplied by the hosting arrangement. That the deployment exposes a working HTTPS webhook URL and permits Telegram callbacks.
Self-hosted n8n You control the server and need to configure the public endpoint yourself. DNS, TLS, firewall access, webhook status, and the absence of a competing polling consumer.
Fixed destination ID A workflow always sends alerts to one verified group or channel. The ID and permissions remain valid after administrators or chat settings change.
Chat ID mapped from the trigger The workflow replies to whoever initiated the conversation. The incoming update contains the expected chat object and the mapping points to its ID.

Production checklist

  • Create the bot with @BotFather and record the username and token securely.
  • Use a username between 5 and 32 characters that ends in bot; remember that Telegram does not allow later changes.
  • Store the token only in the n8n Telegram credential.
  • Select that credential in both Telegram Trigger and Telegram action nodes.
  • Run a manual trigger test with /start or a short message.
  • Capture and verify the chat ID from the resulting update.
  • Use the correct identifier format for a public channel, private channel, or private group.
  • Add the bot as a channel administrator when channel operations require it.
  • For self-hosted n8n, expose a stable HTTPS endpoint and avoid competing polling or webhook consumers.
  • Keep outgoing text within 4096 characters after entity parsing.
  • Throttle bulk sends to stay within the documented 30-messages-per-second limit.
  • Log failed deliveries and test the recovery path before activation.

Final setup sequence

The shortest reliable path is to create the bot in @BotFather, place its token in one n8n Telegram credential, and test a Telegram Trigger with a message sent directly to the bot. Use the trigger output to obtain the chat ID, connect a Message → Send Message node, and verify the reply manually. Add group or channel permissions only when those destinations are required. If n8n is self-hosted, solve the HTTPS webhook and update-delivery choice before troubleshooting node settings; otherwise Telegram cannot deliver the trigger event regardless of the workflow logic.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More quests from Patch Notes

  1. How to Set Up a RedM (RDR2) Server in 2026: License Key, txAdmin and server.cfg, Step by StepBlog11min
  2. Best RedM (RDR2) Server Hosting in 2026: Comparing Four Hosts on Slots, Memory and PriceBlog10min
  3. How to Host a Mindustry Server in 2026: server-release.jar, Port 6567 and the Commands That MatterBlog7min
Recommended PC Tool
Recommended PC Tool
Crashes, No Sound, or Screen Glitches?Free driver scan
PC Slower Than It Used to Be?Free scan - under a minute

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.