New release v0.65.1 ๐
https://www.npmjs.com/package/node-telegram-bot-api
1. Support for updates (@danielperez9430)
message_reaction
message_reaction_count
chat_boost
removed_chat_boost
https://www.npmjs.com/package/node-telegram-bot-api
GitHub
node-telegram-bot-api/CHANGELOG.md at master ยท yagop/node-telegram-bot-api
Telegram Bot API for NodeJS. Contribute to yagop/node-telegram-bot-api development by creating an account on GitHub.
New release v0.66.0
Support Telegram Bot API 7.2 & 7.3 (@danielperez9430)
- getBusinessConnection
- replaceStickerInSet
Support for updates: (@danielperez9430)
- business_connection
- business_message
- edited_business_message
- deleted_business_messages
Minor fixes: (@danielperez9430)
- getUserChatBoostsGitHub
node-telegram-bot-api/CHANGELOG.md at master ยท yagop/node-telegram-bot-api
Telegram Bot API for NodeJS. Contribute to yagop/node-telegram-bot-api development by creating an account on GitHub.
โค1๐ฅ1๐ฅฐ1
๐ New release v0.67.0 ๐
Added:
1. Support Telegram Bot API v7.4 (by @danielperez9430)
*
2. Support Telegram Bot API 7.6 (@danielperez9430)
*
3. Support Telegram Bot API v7.9 (by @danielperez9430)
4. Support Telegram Bot API v7.10 (by @danielperez9430)
* Update:
5. Support Telegram Bot API v8.0 and v8.1
*
*
*
*
*
6. Support Telegram Bot API v8.2, v8.3 (@danielperez9430)
*
*
*
*
7. Support Telegram Bot API v8.3 (by @danielperez9430)
8. Support Telegram Bot API v9.0 (by @danielperez9430)
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
9. Support Telegram Bot API v9.1 (by @danielperez9430)
*
*
*
Fixed:
1. Reference causing error in
2. Stringify
3. Stringify
4. Stringify
5. Rename parameter
6. Remove travis badge (by @melroy89)
7. Improve documentation on events (by @programminghoch10)
8. Fix Telegram invite group link (by @melroy89)
Added:
1. Support Telegram Bot API v7.4 (by @danielperez9430)
*
#refundStarPayment2. Support Telegram Bot API 7.6 (@danielperez9430)
*
#sendPaidMedia3. Support Telegram Bot API v7.9 (by @danielperez9430)
4. Support Telegram Bot API v7.10 (by @danielperez9430)
* Update:
purchased_paid_media5. Support Telegram Bot API v8.0 and v8.1
*
#savePreparedInlineMessage (@IsmailBinMujeeb)*
#setUserEmojiStatus (@danielperez9430)*
#editUserStarSubscription (@danielperez9430)*
#getAvailableGifts (@danielperez9430)*
#sendGift (@danielperez9430)6. Support Telegram Bot API v8.2, v8.3 (@danielperez9430)
*
#verifyUser*
#verifyChat*
#removeUserVerification*
#removeChatVerification7. Support Telegram Bot API v8.3 (by @danielperez9430)
8. Support Telegram Bot API v9.0 (by @danielperez9430)
*
#readBusinessMessage*
#deleteBusinessMessages*
#setBusinessAccountName*
#setBusinessAccountUsername*
#setBusinessAccountBio*
#setBusinessAccountProfilePhoto*
#removeBusinessAccountProfilePhoto*
#setBusinessAccountGiftSettings*
#getBusinessAccountStarBalance*
#transferBusinessAccountStars*
#getBusinessAccountGifts*
#convertGiftToStars*
#upgradeGift*
#transferGift*
#postStory*
#editStory*
#deleteStory*
#giftPremiumSubscription9. Support Telegram Bot API v9.1 (by @danielperez9430)
*
#sendChecklist*
#editMessageChecklist*
#getMyStarBalanceFixed:
1. Reference causing error in
FatalError (by @ivanjh)2. Stringify
scope field in #deleteMyCommands (by @XC-Zhang)3. Stringify
allowed_updates field in #getUpdates (by @alfanzain)4. Stringify
message_ids in #forwardMessages (by @qiaoshouzi)5. Rename parameter
thumb to thumbnail (by @0x114514BB)6. Remove travis badge (by @melroy89)
7. Improve documentation on events (by @programminghoch10)
8. Fix Telegram invite group link (by @melroy89)
โค1
๐ node-telegram-bot-api v1.0.0 is out!
Fully rewritten in TypeScript ๐
๐ท Bundled types - drop
๐งฉ Types auto-generated from the official Bot API docs
๐ฆ ESM-only Node.js 18+
๐ค Latest Bot API coverage + new
๐ Dependency free
โ ๏ธ Breaking changes from 0.6x - read the migration guide first ๐
https://github.com/yagop/node-telegram-bot-api/blob/master/CHANGELOG.md#migrating-from-v067x
๐ฅ
Fully rewritten in TypeScript ๐
๐ท Bundled types - drop
@types/node-telegram-bot-api๐งฉ Types auto-generated from the official Bot API docs
๐ฆ ESM-only Node.js 18+
๐ค Latest Bot API coverage + new
sendLivePhoto๐ Dependency free
โ ๏ธ Breaking changes from 0.6x - read the migration guide first ๐
https://github.com/yagop/node-telegram-bot-api/blob/master/CHANGELOG.md#migrating-from-v067x
๐ฅ
npm i node-telegram-bot-apiGitHub
node-telegram-bot-api/CHANGELOG.md at master ยท yagop/node-telegram-bot-api
Telegram Bot API for NodeJS. Contribute to yagop/node-telegram-bot-api development by creating an account on GitHub.
๐ฅ14๐9๐6๐2
๐ node-telegram-bot-api v1.1.0 is out โ with full Bot API 10.1 support!
โจ Rich Messages
โข
โข
โข new
๐ค Join Request Queries
โข
โข
๐ฆ
๐ Changelog: v1.1.0
Big thanks to danielperez9430 for landing the 10.1 work! ๐
โจ Rich Messages
โข
sendRichMessage / sendRichMessageDraftโข
editMessageText now accepts rich_message (new single-object call)โข new
InputRichMessage type, auto-serialized๐ค Join Request Queries
โข
answerChatJoinRequestQueryโข
sendChatJoinRequestWebApp๐ฆ
npm i node-telegram-bot-api@1.1.0๐ Changelog: v1.1.0
Big thanks to danielperez9430 for landing the 10.1 work! ๐
GitHub
Release v1.1.0 - Telegram Bot API 10.1 ยท yagop/node-telegram-bot-api
Adds support for Telegram Bot API 10.1 (June 11, 2026) on top of the v1.0.0 TypeScript rewrite. No breaking changes โ Node.js โฅ 18 and ESM-only are unchanged from v1.0.0.
Rich Messages
Added the m...
Rich Messages
Added the m...
โค6๐ฅ4
๐ node-telegram-bot-api v1.1.1 is out - focused fixes for proxies, media edits, and stickers!
๐ Per-bot custom transport
โข
โข
โข no more process-wide
๐ผ Better editMessageMedia uploads
โข
โข thumbnail / cover uploads work too
โข
๐จ Sticker set fixes
โข
โข no more legacy png_sticker / emojis fields
โข supports
๐ฆ
๐ Changelog: v1.1.1
๐ Per-bot custom transport
โข
request.fetch for custom fetch implementationsโข
request.fetchOptions for undici dispatchers / per-instance proxiesโข no more process-wide
setGlobalDispatcher needed๐ผ Better editMessageMedia uploads
โข
media now accepts Buffer / stream / local pathโข thumbnail / cover uploads work too
โข
file_id / URL usage stays unchanged๐จ Sticker set fixes
โข
createNewStickerSet / addStickerToSet now use the current Bot API shapeโข no more legacy png_sticker / emojis fields
โข supports
attach:// uploads for sticker files๐ฆ
npm i node-telegram-bot-api@1.1.1๐ Changelog: v1.1.1
GitHub
Release v1.1.1 ยท yagop/node-telegram-bot-api
Added
request.fetch and request.fetchOptions options (on the TelegramBot
constructor / HttpClient), for per-instance transport customization. Pass a
custom fetch implementation (e.g. undici's...
request.fetch and request.fetchOptions options (on the TelegramBot
constructor / HttpClient), for per-instance transport customization. Pass a
custom fetch implementation (e.g. undici's...
โค6๐2
๐ node-telegram-bot-api v1.1.2 is out - CommonJS support
๐ฆ Dual ESM + CommonJS build
โข ESM imports keep working unchanged
โข CommonJS can now use
โข ships matching
๐บ Source maps
โข emitted for both โจ ESM and CJS builds
๐ฆ
๐ Changelog: v1.1.2
๐ฆ Dual ESM + CommonJS build
โข ESM imports keep working unchanged
โข CommonJS can now use
require() againโข ships matching
.d.ts / .d.cts typings๐บ Source maps
โข emitted for both โจ ESM and CJS builds
๐ฆ
npm i node-telegram-bot-api@1.1.2๐ Changelog: v1.1.2
๐ node-telegram-bot-api v1.2.0 is out - with Bot API 10.2 support!
๐ป Ephemeral Messages: send group messages only one user can see:
Plus new methods to manage them:
๐ Rich Messages: new block-based formatting via
๐ฅ Communities: initial support for linked supergroups/channels: new
โญ Also:
๐ฆ
๐ Release notes: v1.2.0
๐ป Ephemeral Messages: send group messages only one user can see:
bot.sendMessage(chatId, "hi", { receiver_user_id: userId })Plus new methods to manage them:
editEphemeralMessageText, editEphemeralMessageMedia, editEphemeralMessageCaption, editEphemeralMessageReplyMarkup and deleteEphemeralMessage.๐ Rich Messages: new block-based formatting via
InputRichMessage.blocks (paragraphs, headings, tables, collages, slideshows, maps and more), and explicit media with InputRichMessageMedia.๐ฅ Communities: initial support for linked supergroups/channels: new
Community type, community_chat_added / community_chat_removed events and ChatFullInfo.community.โญ Also:
BotSubscriptionUpdated updates for payment subscription changes.๐ฆ
npm i node-telegram-bot-api๐ Release notes: v1.2.0
๐5โค4
๐ node-telegram-bot-api v2.0.0 is out!
โก Runtime-agnostic core for Node.js, Bun, Deno, Cloudflare Workers, and other edge runtimes.
๐งฉ Koa-style middleware with per-update Context, filters, commands, and error boundaries.
๐ New builders for inline keyboards, entities, media groups, stories, stickers, and more.
๐ป Ephemeral Messages, Rich Messages, Communities, and payment subscription updates are included.
๐ฆ
๐ Migration guide
๐ Release notes
โก Runtime-agnostic core for Node.js, Bun, Deno, Cloudflare Workers, and other edge runtimes.
๐งฉ Koa-style middleware with per-update Context, filters, commands, and error boundaries.
๐ New builders for inline keyboards, entities, media groups, stories, stickers, and more.
๐ป Ephemeral Messages, Rich Messages, Communities, and payment subscription updates are included.
๐ฆ
npm i node-telegram-bot-api๐ Migration guide
๐ Release notes
โค8๐ฅ4๐2
๐ node-telegram-bot-api 2.1.0 is out!
Full Bot API 10.3 support, plus new fluent builders for rich content:
โจ
๐งฑ
๐
Also in Bot API 10.3: ephemeral messages ๐ป, DisabledButton + disabled inline buttons, force_reply on markup, stopped_message_generation updates, and more.
๐ฆ
๐ Changelog: https://github.com/yagop/node-telegram-bot-api/releases/tag/v2.1.0
Full Bot API 10.3 support, plus new fluent builders for rich content:
โจ
RichTextBuilder - build the recursive RichText tree (bold/italic/code/url/mention/custom emoji/...), nesting with plain strings or nested builders๐งฑ
RichMessageBuilder - compose sendRichMessage blocks (lists, blockquotes, collages, slideshows, details), with InputFiles hoisted automatically๐
RichMessageButtonBuilder + richMessageButton / richCaption / richTableCell / richListItem helpers.Also in Bot API 10.3: ephemeral messages ๐ป, DisabledButton + disabled inline buttons, force_reply on markup, stopped_message_generation updates, and more.
๐ฆ
npm i node-telegram-bot-api@2.1.0๐ Changelog: https://github.com/yagop/node-telegram-bot-api/releases/tag/v2.1.0
GitHub
Release 2.1.0 ยท yagop/node-telegram-bot-api
[2.1.0][2.1.0] - 2026-08-24
Builders
Added RichTextBuilder - a fluent builder for the recursive RichText tree,
covering every node kind (bold/italic/underline/code/url/mention/date_time/
custom_em...
Builders
Added RichTextBuilder - a fluent builder for the recursive RichText tree,
covering every node kind (bold/italic/underline/code/url/mention/date_time/
custom_em...
โค5
๐ node-telegram-bot-api 2.2.0 is out!
๐ Sessions -
๐ฌ Reply & callback tracking that survives restarts and works on serverless -
โป๏ธ Bot lifecycle -
๐ก Polling survives
๐จ Fix: reset sticky RegExp state in
๐
Everything new is opt-in - 2.1.0 bots run unchanged.
๐ฆ
๐ https://github.com/yagop/node-telegram-bot-api/releases/tag/v2.2.0
๐ Sessions -
createSession() + ctx.getSession(), with Memory, File, SQLite, SQL and Redis stores (new /bun subpath). See Session example in 16-sessions๐ฌ Reply & callback tracking that survives restarts and works on serverless -
expectReply, matchCallback, taggedRepliesโป๏ธ Bot lifecycle -
bot.init() / bot.close() for middleware that owns resources๐ก Polling survives
409 Conflict, webhook shutdown can't hang, run({ exitOnError })๐จ Fix: reset sticky RegExp state in
Bot.hears() . Thanks sinzbtw๐
reply_markup accepts only one markup object (stricter types)Everything new is opt-in - 2.1.0 bots run unchanged.
๐ฆ
npm i node-telegram-bot-api๐ https://github.com/yagop/node-telegram-bot-api/releases/tag/v2.2.0
GitHub
node-telegram-bot-api/examples/16-sessions.ts at master ยท yagop/node-telegram-bot-api
Telegram Bot API for NodeJS. Contribute to yagop/node-telegram-bot-api development by creating an account on GitHub.
๐3โค1
๐ node-telegram-bot-api 2.3.0 is out! โจ
๐ S3 session storage:
๐ฏ Commands for the right bot:
๐ฌ Smarter
๐ Clean shutdowns: stopping the bot (Ctrl+C, a deploy's SIGTERM) mid-handler no longer makes Telegram redeliver that update on restart.
๐ง File uploads work on Node 18 again.
๐ Thanks kgeminicdev & vladosskins178 for their reports and comments
๐ Release notes and upgrade tips: https://github.com/yagop/node-telegram-bot-api/releases/tag/v2.3.0
๐ S3 session storage:
S3SessionStorage keeps sessions in AWS S3, Cloudflare R2, MinIO or Spaces. It talks to S3 directly over fetch, so it runs on Node, Bun, Deno, Workers and edge.๐ฏ Commands for the right bot:
/start@other_bot no longer runs your handler. Your bot's identity is available as bot.botInfo / ctx.me.๐ฌ Smarter
ctx.reply(): replies stay in the same business connection and forum topic as the incoming message.๐ Clean shutdowns: stopping the bot (Ctrl+C, a deploy's SIGTERM) mid-handler no longer makes Telegram redeliver that update on restart.
๐ง File uploads work on Node 18 again.
๐ Thanks kgeminicdev & vladosskins178 for their reports and comments
๐ Release notes and upgrade tips: https://github.com/yagop/node-telegram-bot-api/releases/tag/v2.3.0
npm i node-telegram-bot-api@2.3.0GitHub
Release 2.3.0 ยท yagop/node-telegram-bot-api
2.3.0 adds a durable S3 session store, makes bot.command() ignore commands addressed to other bots, makes ctx.reply() answer where the message came from (business connections, forum topics), and st...