NewYour coding agent can read the release notes before it upgrades.Set up the MCP server β
pub.dev
pub.dev
Televerse lets you create your own efficient Telegram bots with ease in Dart. Supports latest Telegram Bot API - 10.4!
Latest stable
3.8.0
Last release 7 days ago
15 Nov 2026
Release timing varies
gaps range from 8 days to 3 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
9 versions withdrawn
withdrawn after publishing
4 years old
180 releases Β· first in 2022
Drag across the ruler to compare, or tap a release to open it.
β οΈ StoryAreaPosition is renamed to AreaPosition, as in Bot API 10.4. StoryAreaPosition remains as a deprecated alias and will be removed in a future rβ¦
StoryAreaPosition is renamed to AreaPosition, as in Bot API 10.4. StoryAreaPosition remains as a deprecated alias and will be removed in a future release.EphemeralMessageParameters.receiverUserId is now nullable, and the chatId of the ephemeral-capable RawAPI send methods (sendMessage, sendRichMessage, sendPhoto, sendAudio, sendDocument, sendVideo, sendLivePhoto, sendAnimation, sendVoice, sendVideoNote, sendLocation, sendVenue, sendContact, sendSticker) is now ID?. Pass null together with EphemeralMessageParameters(callbackQueryId: ...) to send an ephemeral reply to a callback query.Widget on Message and ExternalReplyInfo, sendWidget, sendSharedWidget, answerWidgetQuery, editMessageWidgetData, editInlineMessageWidgetData, editSharedWidgetData, and InputWidgetMessageContent / InputSharedWidgetMessageContent for inline results. Widgets can currently be sent only to private chats in production.widget_query and shared_widget_query updates (WidgetQuery, SharedWidgetQuery), with typed WidgetQueryType variants (WidgetQueryTypeData, WidgetQueryTypeSignData, WidgetQueryTypeSentTransaction) and WidgetQueryWallet.TonWalletCard, TonWalletCardSticker, TonNft and TonNftAttribute on ChatFullInfo.tonWalletCard, and the TonWalletTransfer service message.ChatShareTheme (ChatShareThemeEmoji, ChatShareThemeUniqueGift) on ChatFullInfo.shareTheme, EmojiType, ChatShareThemeBackdrop(s) and getChatShareThemeBackdrops.richTexts on TextQuote and quoteRichTexts on ReplyParameters, plus RichText.tonAddress.ton_address and bank_card_number message entities.getUniqueGift and deleteBusinessAccountGift.customDescriptionParseMode and customDescriptionEntities on verifyUser and verifyChat.PaidMessagesWaived service message.onWidgetQuery, onSharedWidgetQuery, widgetQuery(data, ...) and sharedWidgetQuery(data, ...) (String or RegExp, with ctx.matches), onWidgetSignData, onWidgetSentTransaction, onWidget, onTonWalletTransfer, onPaidMessagesWaived, onTonAddress and onBankCardNumber. filters.serviceMessage includes the new service messages.ctx.replyWithWidget, ctx.replyWithSharedWidget, ctx.answerWidgetQuery, ctx.editWidgetData (chat or inline message), ctx.editSharedWidgetData, and the ctx.widgetQuery, ctx.sharedWidgetQuery, ctx.widgetQueryData, ctx.widgetQueryType and ctx.widgetId getters. ctx.ephemeralParameters() supports callback-only ephemeral replies.runtimeType key inside input_message_content.ReplyParameters without chat_id no longer fails to parse.Your coding agent can read these notes before it upgrades. Set up the MCP server β
Bot API 10.3 support (v3.7.0) by @The0xArchitect in https://github.com/theweaverlabs/televerse/pull/366
Full Changelog: https://github.com/theweaverlabs/televerse/compare/v3.6.0...v3.7.0
receiverUserId and callbackQueryId were removed from sendMessage, sendPhoto, sendAudio, sendDocument, sendVideo, sendLivePhoto, sendAnimation, sendVoice, sendVideoNote, sendLocation, sendVenue, sendContact, sendSticker and the matching ctx.reply* helpers. Use ephemeralMessageParameters: EphemeralMessageParameters(receiverUserId: ..., callbackQueryId: ...) instead.RichMessageButton, RichText.button, RichBlock.buttons), expandable block quotations, document blocks with tg://document?id= links, and compact tables (isCompact).EphemeralMessageParameters (including replaceCallbackQueryMessage), ephemeralMessageParameters on sendRichMessage, rich messages in editEphemeralMessageText, showCaptionAboveMedia in editEphemeralMessageCaption, and file uploads in editEphemeralMessageMedia.canSendWelcomeMessages administrator right on ChatAdministratorRights, ChatMemberAdministrator and promoteChatMember.DisabledButton, InlineKeyboard.disabled) and forceReply on inline and reply keyboards (makeForceReply() on InlineKeyboard, Keyboard, InlineMenu and KeyboardMenu).canStop and keepOnStop on sendMessageDraft and sendRichMessageDraft, plus the stopped_message_generation update (MessageGenerationStopped, bot.onMessageGenerationStopped).CommunityChatJoined service message, and text, entities and isPrivate on UniqueGiftInfo.onGuestMessage, onManagedBot, onRichMessage, onLivePhoto, onEphemeralMessage, onCommunityChatAdded, onCommunityChatJoined and onCommunityChatRemoved.ctx.replyWithRichMessage, ctx.replyWithLivePhoto, ctx.sendMessageDraft, ctx.sendRichMessageDraft, ctx.ephemeralParameters(), ctx.replyEphemeral, ctx.editEphemeralMessageText / Caption / Media / ReplyMarkup, ctx.deleteEphemeralMessage, and the ctx.isEphemeral / ctx.ephemeralMessageId getters. ctx.editMessageText and ctx.editInlineMessageText now accept richMessage.ChatAdministratorRights.canManageForum using the wrong JSON key (can_manage_forum instead of can_manage_topics).ctx.isServiceMessage() now recognizes community service messages.fix: filter InputFile objects from params in multipart requests by @devsdocs in https://github.com/theweaverlabs/televerse/pull/364
Full Changelog: https://github.com/theweaverlabs/televerse/compare/v3.5.2...v3.6.0
Add missing parameters to RawAPI and refactor Context methods by @The0xArchitect in https://github.com/theweaverlabs/televerse/pull/363
Full Changelog: https://github.com/theweaverlabs/televerse/compare/v3.5.1...v3.5.2
Full Changelog: v3.5.1...v3.5.2
InputFile parameters to RawAPI methods (sendDocument, sendVideo, sendAnimation, sendVoice, sendVideoNote).Context.fileId getter to get file ID from messages if any.Prevent including null richMessage in editMessageText payload by @albor09 in #361
Full Changelog: v3.4.0...v3.5.1
Full Changelog: https://github.com/theweaverlabs/televerse/compare/v3.4.0...v3.5.1
Bot API 9.6 by @The0xArchitect in https://github.com/theweaverlabs/televerse/pull/359
Full Changelog: https://github.com/theweaverlabs/televerse/compare/v3.3.0...v3.4.0
Bump version to v3.3.0 and update Bot API to 9.5 by @The0xArchitect in https://github.com/theweaverlabs/televerse/pull/358
Full Changelog: https://github.com/theweaverlabs/televerse/compare/v3.2.0...v3.3.0
v3.2.0 with Bot API 9.4 by @The0xArchitect in https://github.com/theweaverlabs/televerse/pull/357
Full Changelog: https://github.com/theweaverlabs/televerse/compare/v3.1.4...v3.2.0
APICaller signature to use String instead of APIMethod. This gives unrestricted access to Telegram API Methods using RawAPI.call.Transformer to also use the new updated signature.RawAPI to be more efficient in making API calls.LoggingPlugin to use JSON logging for requests as well.InputFile and other media models are now JSON serializable, and does not require special handling.InlineKeyboard.text, InlineKeyboard.switchInline, InlineKeyboard.switchInlineCurrentChatv3.1.4 by @The0xArchitect in #356
isTest parameter to Bot constructor to support test environment.RawAPI to support test environment and custom base URL.chore: version bump by @The0xArchitect in #354
Full Changelog: v3.1.2...v3.1.3
sourceIsMiddleware property to BotError to identify the source of the error.Bot.onStop method to handle stop events.chore: project moved to weaver labs by @The0xArchitect in https://github.com/theweaverlabs/televerse/pull/353
Full Changelog: https://github.com/theweaverlabs/televerse/compare/v3.1.1...v3.1.2
Introduce InputFileProvider to streamline file extraction in media models.
InputFileProvider to streamline file extraction in media models.isServiceMessage check.Bot to Composer.Full Changelog: https://github.com/xooniverse/televerse/compare/v3.1.0...v3.1.1
π€ Bot API 9.3 by @The0xArchitect in https://github.com/xooniverse/televerse/pull/350
Full Changelog: https://github.com/xooniverse/televerse/compare/v3.0.1...v3.1.0
π fix(televerse): One last dynamic typing by @HeySreelal in https://github.com/xooniverse/televerse/pull/349
dynamic typing by @HeySreelal in https://github.com/xooniverse/televerse/pull/349Full Changelog: https://github.com/xooniverse/televerse/compare/v3.0.0...v3.0.1
dynamic type from the library.Payload's [] operator as Object?.Nothing published for this version
Televerse 3.0 by @HeySreelal in https://github.com/xooniverse/televerse/pull/342
Full Changelog: https://github.com/xooniverse/televerse/compare/v2.6.2...v3.0.0
Fixes a bug in Conversation.filter method.
Conversation.filter method.Context.from retrieval order.This is a major breaking release that introduces a complete architectural redesign inspired by grammY, bringing modern patterns and enhanced developer
This is a major breaking release that introduces a complete architectural redesign inspired by grammY, bringing modern patterns and enhanced developer experience to Telegram bot development in Dart.
+ for OR, * for AND, - for NOT)bot.filters property for type-safe filter access without generic specificationsPredicateFilter for custom filtering logic with optional namingbot.filters.photo + bot.filters.videobot.filters.anyMessage - bot.filters.commandBotPlugin<CTX> interface for extensible bot functionalitySessionPlugin<CTX, T> - Persistent user sessions with customizable storageConversationPlugin<CTX> - Advanced multi-step conversations with timeout supportLoggingPlugin<CTX> - Request/response loggingMiddlewarePlugin and TransformerPlugin base classes for easy plugin developmentConversation.wait() with timeout support and ConversationTimeoutExceptionConversation.waitFor() for predicate-based waitingConversation.filter() for filter-based waitingConversation.waitUntil() with validation and otherwise callbackextendTimeout() and setCustomTimeout()ConversationStorage interface with MemoryConversationStorage implementationgetConversationStats()Middleware<CTX> typedefComposer<CTX> class for advanced middleware compositionbot.when()bot.fork()bot.lazy()bot.branch()bot.errorBoundary() and recovery supportbot.startWebhook() for instant webhook deploymentbot.startWebhookDev() for ngrok development workflowBot<CTX extends Context>contextFactory parameterbot.filtersBotStats class with comprehensive metricsbot.statsDioHttpClient as default implementationMiddleware is now a function typedef instead of a classMiddlewareBase - use function-based middlewareBot.use() now only accepts Middleware<CTX> functionsbot.api.use() instead of Bot.use()Bot.local() constructor now takes URL as second positional parameterBot.useContext() to constructor parameter contextFactoryBot.start() methodLoggerOptions - use custom HTTP client with interceptors insteadContext.me is now BotInfo instead of Userctx.me.me?.firstName instead of ctx.me.firstNameConversation.waitForTextMessage() and similar methodsconversation.filter(Filters().text) patternConversationResult classes removed - methods now return Context directlyConversationSuccess/ConversationErrorKeyboard.addText() renamed to Keyboard.text()InlineKeyboard.addUrl() renamed to InlineKeyboard.url()InlineMenu.text() signature changed to (String text, String callbackData, UpdateHandler<CTX>)switchInlineQueryCurrentChat renamed to switchInlineCurrentChatBot.removeMenu() method removedHandler<Context> typedef renamed to UpdateHandler<Context>ID.get() method removed - use api.getChat(id) insteadteleverse.dart to telegram.dartpackage:televerse/telegram.dart for ParseMode, ChatAction, etc.Bot API 9.1 by @HeySreelal in https://github.com/xooniverse/televerse/pull/341
Full Changelog: https://github.com/xooniverse/televerse/compare/v2.6.2...v2.7.0
v2.6.2 by @HeySreelal in https://github.com/xooniverse/televerse/pull/340
Full Changelog: https://github.com/xooniverse/televerse/compare/v2.6.1...v2.6.2
v2.6.1 by @HeySreelal in https://github.com/xooniverse/televerse/pull/339
Full Changelog: https://github.com/xooniverse/televerse/compare/v2.6.0...v2.6.1
Update.msg usage in the Conversation.waitForTextMessage, this could unintentionally match callback query message texts.Custom Dio Instance & Minor upgrades by @HeySreelal in https://github.com/xooniverse/televerse/pull/338
Full Changelog: https://github.com/xooniverse/televerse/compare/v2.5.1...v2.6.0
fix the class usage example by @aci8 in https://github.com/xooniverse/televerse/pull/333
Full Changelog: https://github.com/xooniverse/televerse/compare/v2.5.0...v2.5.1
π€ Bot API 9.0 by @HeySreelal in https://github.com/xooniverse/televerse/pull/332
Full Changelog: https://github.com/xooniverse/televerse/compare/v2.4.5...v2.5.0
π°οΈ 2.4.5 by @HeySreelal in https://github.com/xooniverse/televerse/pull/331
Full Changelog: https://github.com/xooniverse/televerse/compare/v2.4.4...v2.4.5
Fix: ChatMember.creator instead of ChatMember.owner by @HeySreelal in https://github.com/xooniverse/televerse/pull/330
ChatMember.creator instead of ChatMember.owner by @HeySreelal in https://github.com/xooniverse/televerse/pull/330Full Changelog: https://github.com/xooniverse/televerse/compare/v2.4.3...v2.4.4
ChatMemberOwner is now correctly represented as ChatMember.creator instead of ChatMember.owner.v2.4.3 by @HeySreelal in https://github.com/xooniverse/televerse/pull/329
ChatMember.banned to ChatMember.kickedFull Changelog: https://github.com/xooniverse/televerse/compare/v2.4.2...v2.4.3
ChatMemberBanned is now correctly represented as ChatMember.kicked instead of ChatMember.banned.π§ Update JSON key for input message content in InlineQueryResultArticle by @otopba in https://github.com/xooniverse/televerse/pull/327
Full Changelog: https://github.com/xooniverse/televerse/compare/v2.4.1...v2.4.2
v2.4.1 by @HeySreelal in https://github.com/xooniverse/televerse/pull/326
Full Changelog: https://github.com/xooniverse/televerse/compare/v2.4.0...v2.4.1
βοΈ Freeze by @HeySreelal in https://github.com/xooniverse/televerse/pull/318
Full Changelog: https://github.com/xooniverse/televerse/compare/v2.3.0...v2.4.0
Keyboard & InlineKeyboard usage. Check this PR comment for details.v2.4.0-dev.3 by @HeySreelal in https://github.com/xooniverse/televerse/pull/324
Full Changelog: https://github.com/xooniverse/televerse/compare/v2.4.0-dev.2...v2.4.0-dev.3
invalid_annotation_target warningsSync to dev by @HeySreelal in https://github.com/xooniverse/televerse/pull/322
Full Changelog: https://github.com/xooniverse/televerse/compare/2.4.0-dev.1...v2.4.0-dev.2
Exclude generated files from analysis by @HeySreelal in https://github.com/xooniverse/televerse/pull/321
Full Changelog: https://github.com/xooniverse/televerse/compare/v2.4.0-dev.0...2.4.0-dev.1
βοΈ Freeze by @HeySreelal in https://github.com/xooniverse/televerse/pull/318
Full Changelog: https://github.com/xooniverse/televerse/compare/v2.3.0...v2.4.0-dev.0
Keyboard & InlineKeyboard usage. Check this PR comment for details.π€ Bot API 8.3 by @HeySreelal in https://github.com/xooniverse/televerse/pull/317
Full Changelog: https://github.com/xooniverse/televerse/compare/2.2.0...v2.3.0
π³οΈ Update deployment workflow by @HeySreelal in https://github.com/xooniverse/televerse/pull/314
Full Changelog: https://github.com/xooniverse/televerse/compare/v2.1.1...v2.2.0
verifyUser, verifyChat, removeUserVerification, and removeChatVerification, allowing bots to manage verifications on behalf of an organization.upgrade_star_count to the class Gift.pay_for_upgrade to the method sendGift.hide_url from the class InlineQueryResultArticle. Pass an empty string as url instead.v2.1.1 by @HeySreelal in https://github.com/xooniverse/televerse/pull/313
Full Changelog: https://github.com/xooniverse/televerse/compare/v2.1.0...v2.1.1
BackgroundTypeType.chatTheme typoπ€ Bot API 8.1 by @HeySreelal in https://github.com/xooniverse/televerse/pull/312
Full Changelog: https://github.com/xooniverse/televerse/compare/v2.0.2...v2.1.0
AffiliateInfo and reflected all the changes from Bot API 8.1Removed TeleverseEvent by @HeySreelal in https://github.com/xooniverse/televerse/pull/311
Fetcher implementations.bot.dartBot.on method & TeleverseEvent enum.Full Changelog: https://github.com/xooniverse/televerse/compare/v2.0.1...v2.0.2
- [Retracted]
- [Retracted]
Updated RawAPI.createInvoiceLink to the docs.
RawAPI.createInvoiceLink to the docs.SuccessfulPayment, TransactionPartnerUser to reflect the new Star Subscription features.editUserStarSubscription, setUserEmojiStatus, savePreparedInlineMessage, getAvailableGifts, sendGift.PreparedInlineMessage, Gift, Gifts.Full Changelog: https://github.com/xooniverse/televerse/compare/v1.27.3...v1.28.0
β οΈ Separate Bot.local and default Bot constructor by @HeySreelal in https://github.com/xooniverse/televerse/pull/305
Bot.local and default Bot constructor by @HeySreelal in https://github.com/xooniverse/televerse/pull/305Full Changelog: https://github.com/xooniverse/televerse/compare/v1.27.2...v1.27.3
baseURL from Bot primary constructor.Bot.local against Bot constructors. Why do we need to keep two copies of the same thing?Bot.local.Fix: Request URI construction & local bot issue by @HeySreelal in https://github.com/xooniverse/televerse/pull/304
Full Changelog: https://github.com/xooniverse/televerse/compare/1.27.1...v1.27.2
APIScheme. Now the scheme must be added to the baseURL itself.Fix: sendPaidMedia by @HeySreelal in https://github.com/xooniverse/televerse/pull/303
sendPaidMedia by @HeySreelal in https://github.com/xooniverse/televerse/pull/303Full Changelog: https://github.com/xooniverse/televerse/compare/v1.27.0...1.27.1
RawAPI.sendPaidMedia crashes while sending local file using InputFile.fromFileπ Bot API 7.11 - Televerse 1.27.0 by @HeySreelal in https://github.com/xooniverse/televerse/pull/302
Full Changelog: https://github.com/xooniverse/televerse/compare/v1.26.6...v1.27.0
Fix in Context.hasCallbackQuery
Context.hasCallbackQueryCheck X-Telegram-Bot-Api-Secret-Token in Webhook by @HeySreelal in https://github.com/xooniverse/televerse/pull/301
X-Telegram-Bot-Api-Secret-Token in Webhook by @HeySreelal in https://github.com/xooniverse/televerse/pull/301Full Changelog: https://github.com/xooniverse/televerse/compare/v1.26.5...v1.26.6
Webhook.secretToken with the header X-Telegram-Bot-Api-Secret-Token before processing the incoming webhook update.Fix typo by @HeySreelal in https://github.com/xooniverse/televerse/pull/300
Full Changelog: https://github.com/xooniverse/televerse/compare/v1.26.4...v1.26.5
π Multipart File to Local File by @HeySreelal in https://github.com/xooniverse/televerse/pull/299
Full Changelog: https://github.com/xooniverse/televerse/compare/v1.26.3...v1.26.4
LocalFile class.Payload.files parameter with the LocalFile objects instead of MultipartFile from Dio.Televerse v1.26.3 by @HeySreelal in https://github.com/xooniverse/televerse/pull/298
Full Changelog: https://github.com/xooniverse/televerse/compare/v1.26.2...v1.26.3
Added way too many internal changes.
RawAPI construction in BotRawAPI instance will be created along with Bot instance.Context helper methods.Bot._api is now non-nullable._loggerOptions, _baseURL, and _scheme has been removed from Bot. They now solely belong to RawAPI.Context, such as chat, msg are now cached for better performance in recurring access.Full Changelog: https://github.com/xooniverse/televerse/compare/v1.26.1...v1.26.2
Televerse v1.26.1 by @HeySreelal in https://github.com/xooniverse/televerse/pull/295
Full Changelog: https://github.com/xooniverse/televerse/compare/v1.26.0...v1.26.1
Televerse v1.26.0 by @HeySreelal in https://github.com/xooniverse/televerse/pull/293
Full Changelog: https://github.com/xooniverse/televerse/compare/v1.25.0...v1.26.0
Transformer classpayload parameter for the Transformer.transform method optional-positional argument.RawAPI.call method for independently calling the Telegram Bot API methods.Bot API 7.10 by @HeySreelal in https://github.com/xooniverse/televerse/pull/291
Full Changelog: https://github.com/xooniverse/televerse/compare/v1.24.0...v1.25.0
Bot.onPaidMediaPurchase for listening to PaidMediaPurchased updates.Contextπ€ Bot API 7.9 by @HeySreelal in https://github.com/xooniverse/televerse/pull/290
Full Changelog: https://github.com/xooniverse/televerse/compare/v1.23.1...v1.24.0
Refactors and Docs Stuff by @HeySreelal in https://github.com/xooniverse/televerse/pull/289
Full Changelog: https://github.com/xooniverse/televerse/compare/v1.23.0...v1.23.1
Bot.additionalInfo⨠Minor re-upload by @HeySreelal in https://github.com/xooniverse/televerse/pull/286
Full Changelog: https://github.com/xooniverse/televerse/compare/v1.22.4...v1.23.0
User.hasMainWebAppJust a re-release to move the repo to @theweaverlabs
π Moving to Xooniverse by @HeySreelal in https://github.com/HeySreelal/televerse/pull/285
Full Changelog: https://github.com/HeySreelal/televerse/compare/v1.22.3...v1.22.4
One column per quarter.