Thanks to all who have contributed! 😘

Especial thanks to @GochoMugo who I gave contributor rights and merged many PR! 👍

New release, v0.25.0. The changes include:
1. Supports the API v2.3 updates (by @kamikazechaser)
2. Proxy extra request options (by @tarmolov)
3. Fix request performance issue (by @preco21)
4. Support sendVenue method (by Tketa)
5. Support sendContact method (by @GochoMugo)
6. Added onlyFirstMatch option (by @GingerPlusPlus)
7. Support getGameHighScores method (by @jishnu7)
8. Fix typos (by oflisback)
Thanks for your continued interest and support.
Happy new year!

New release, v0.26.0:

Added:

1. Add TelegramBot constructor options:
* options.https
* options.baseApiUrl
* options.filepath
2. Add methods:
* TelegramBot#stopPolling()
* TelegramBot#isPolling()
* TelegramBot#openWebHook()
* TelegramBot#closeWebHook()
* TelegramBot#hasOpenWebHook()
* TelegramBot#deleteWebHook()
* TelegramBot#getWebHookInfo()

Changed:

1. Use POST requests by default
2. Ensure all relevant methods return Promises
3. Document auto-deletion of webhook during polling
4. Deprecate support for Node.js v0.12
5. Fix consistency of methods signatures
6. Rename TelegramBot#initPolling() to TelegramBot#startPolling()
* Deprecate TelegramBot#initPolling()

Fixed:

1. Handle error during formatting formData
2. Fix ES6 syntax

Credits/Blames: Unless explicitly stated otherwise, above work was done by @GochoMugo. Thanks to all who have contributed in code and discussion in advancing this project.

We hope you find the library more easier and stable to work with. Happy coding!

New Release, v0.27.0:

Added:

1. Add constructor options:
* (#243) options.polling.params (by @GochoMugo, requested-by @sidelux)
2. Add methods:
* (#74) *TelegramBot#removeReplyListener()* (by @githugger)
3. (#283) Add proper error handling (by @GochoMugo)
4. (#272) Add health-check endpoint (by @mironov)
* options.webHook.healthEndpoint
5. (#152) Add test for TelegramBot#sendDocument() using 'fileOpts'
param (by @evolun)
6. Document options.webHook.host (by @GochoMugo)
7. (#264) Add Bot API version to README (by @kamikazechaser)
8. Add examples:
- (#271) WebHook on Heroku (by @TheBeastOfCaerbannog)
- (#274) WebHook on Zeit Now (by @Ferrari)

Changed:

1. (#147) Use *String#indexOf()*, instead of *RegExp#test()*, to
find token in webhook request (by @AVVS)

Fixed:

* Fix bug:
- (#275, #280) fix es6 syntax error on Node.js v4.x (by @crazyabdul)
- (#276) promise.warning from request-promise (by @GochoMugo,
reported-by @preco21)
- (#281) fix handling error during polling (by @GochoMugo,
reported-by @dimawebmaker)
- (#284) fix error during deletion of already-set webhook, during
polling (by @GochoMugo, reported-by @dcparga)
2. Fix links in documentation (by @Ni2c2k)

An Early Happy Valentine's Day ❤️

New Release, v0.28.0

Added:

1. (#361) Support Bot API v3.1 (by @Lord-Protector, @kamikazechaser)
2. (#332) Support Bot API v3.0 (by @kamikazechaser, @GochoMugo)
3. Add TelegramBot#removeTextListener() (by @GochoMugo)
4. (#342) Add game example (by @MCSH)
5. (#315) List 'bot-brother' project in community section in README (by @saeedhei)

Changed:

1. (#367) Update TelegramBot#answerCallbackQuery() signature (by @mnb3000)

Fixed:

1. (#325) Fix global regexp state reset (by @Sirius-A)
2. (#363) Fix download file path on windows (by @kucherenkovova)
3. (#346) Fix anchor webhook link in docs (by @Coac)

Sorry for the wait.

New tutorial to get started using node-telegram-bot-api: https://github.com/hosein2398/node-telegram-bot-api-tutorial (Give a star ⭐️ pls)

New Release, v0.29.0

Added:

1. Add Bot API v3.2 methods:
* (#429) TelegramBot#getStickerSet (by @CapacitorSet, @LibertyLocked)
* (#430) TelegramBot#uploadStickerFile (by @CapacitorSet)
* TelegramBot#createNewStickerSet, TelegramBot#addStickerToSet, TelegramBot#setStickerPositionInSet, TelegramBot#deleteStickerFromSet (by @GochoMugo)
2. Supports API v3.3

Deprecated:

1. Auto-enabling Promise cancellation (#319) (by @GochoMugo)

New Release, v0.30.0 (https://github.com/yagop/node-telegram-bot-api/releases/tag/v0.30.0):

Added:

1. Support Bot API v3.5: (by @GochoMugo)
- Allow provider_data parameter in TelegramBot#sendInvoice
- Add method TelegramBot#sendMediaGroup()
2. Support Bot API v3.4: (by @kamikazechaser)
- Add methods TelegramBot#editMessageLiveLocation, TelegramBot#stopMessageLiveLocation (#439)
- Add methods TelegramBot#setChatStickerSet, TelegramBot#deleteChatStickerSet (#440)
3. Add methods:
- TelegramBot#getFileStream (#442) (by @GochoMugo, requested-by @Xaqron)
4. Add options to TelegramBot#stopPolling() (by @GochoMugo)
5. Add metadata argument in message event (and friends e.g. text, audio, etc.) (#409) (by @jlsjonas, @GochoMugo)
6. Add forward-compatibility i.e. support future additional Telegram options (by @GochoMugo)
7. Add support for Node.js v9 (by @GochoMugo)
8. Document TelegramBot.errors, TelegramBot.messageTypes (by @GochoMugo)

Changed:

1. Update TelegramBot#answerCallbackQuery() signature (by @GochoMugo)
2. Improve default error logging of polling_error and webhook_error (#377)
3. Update dependencies

Deprecated:

1. Sending files: (See [usage guide][usage-sending-files]) (by @hufan-akari, @GochoMugo)
- Error will not be thrown if Buffer is used and file-type could not be detected.
- Filename will not be set to data.${ext} if Buffer is used
- Content type will not default to null or undefined

Fixed:

1. Fix the offset infinite loop bug (#265, #36) (by @GochoMugo)
2. Fix game example (#449, #418) (by @MCSH)

Happy holidays! From the NTBA contributors.

New release v0.50.0

Added:

Support Bot API v4.8: (by @danielperez9430)
Add methods: sendDice()
Support Bot API v4.7: (by @danielperez9430)
Add methods: getMyCommands(),setMyCommands()
Support Bot API v4.5: (by @danielperez9430)
Add methods: setChatAdministratorCustomTitle()
Support Bot API v4.4: (by @danielperez9430)
Add methods: setChatPermissions()
Support for poll_answer (by @JieJiSS)
Add request options in file stream (by @zhangpanyi )

Changed: (by @danielperez9430)

New message type: dice
Fix Bugs in tests
Fix regex compare (by @ledamint)
Fix listening for error events when downloading files (by @Kraigo)

New release v0.51.0

Added:

1. Support Bot API v5.0: (by @danielperez9430)
* Add method *copyMessage()*
* Add method *unpinAllChatMessages()*
* Add method *close()*
* Add method *logOut()*

Changed: (by @danielperez9430)
* Remove trailing-spaces
* Fix Bugs in Test

New Test: (by @danielperez9430)
* copyMessage
* unpinAllChatMessages

✨ Special thanks to @kamikazechaser and @danielperez9430 ✨

New release v0.65.0 🎉

1. Support Telegram Bot API v7.1
deleteMessages (@Sp3ricka)
copyMessages (@xjx0106 & @Sp3ricka)
setMessageReaction (@Sp3ricka)
forwardMessages (@danielperez9430)
getUserChatBoosts (@danielperez9430)

2. Minor changes: (@danielperez9430)
Refactor methods order
Fix copyMessages & setMessageReaction methods
Added missing tests
Fix tests for methods copyMessages & getMyDefaulAdministratorRights

https://www.npmjs.com/package/node-telegram-bot-api

New release v0.65.1 🎉

1. Support for updates (@danielperez9430)
message_reaction
message_reaction_count
chat_boost
removed_chat_boost

https://www.npmjs.com/package/node-telegram-bot-api

🎉 New release v0.67.0 🎉

Added:

1. Support Telegram Bot API v7.4 (by @danielperez9430)
* #refundStarPayment
2. Support Telegram Bot API 7.6 (@danielperez9430)
* #sendPaidMedia
3. Support Telegram Bot API v7.9 (by @danielperez9430)
4. Support Telegram Bot API v7.10 (by @danielperez9430)
* Update: purchased_paid_media
5. 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
* #removeChatVerification
7. 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
* #giftPremiumSubscription
9. Support Telegram Bot API v9.1 (by @danielperez9430)
* #sendChecklist
* #editMessageChecklist
* #getMyStarBalance

Fixed:

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)

🚀 node-telegram-bot-api v1.0.0 is out!

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-api

🚀 node-telegram-bot-api v1.1.0 is out — with full Bot API 10.1 support!

✨ 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! 🙌

🛠 node-telegram-bot-api v1.1.1 is out - focused fixes for proxies, media edits, and stickers!

🌐 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

🛠 node-telegram-bot-api v1.1.2 is out - CommonJS support

📦 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:
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