NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
Televerse lets you create your own efficient Telegram bots with ease in Dart. Supports latest Telegram Bot API - 10.2!
Last release 2 months ago
27 Jul 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
178 releases · first in 2022
One column per quarter.
Added InlineMenu and KeyboardMenu classes to represent an inline menu and a keyboard menu respectively.
Televerse Menu.InlineMenu and KeyboardMenu classes to represent an inline menu and
a keyboard menu respectively.bot.attachMenu method to attach a menu to the bot.bot.removeMenu method to remove a menu listeners from from the bot.Televerse Menu is demonstrated in
/example/menu_bot.dart.MessageContext and MessageMixin-
#124messagThreadId parameter in multiple methods.ChatMemberUpdatedContext class to support both chat_member and
my_chat_member updates.bot.me getter to get the information about the bot. (Thanks to
@GiuseppeFn)bot.getMe method to get the information about the bot and set it to
the bot.me getter.Fixed issue that might cause a crash when LongPolling.allUpdates is used.
Fixed an issue with the command method that crashed the bot when setting up the listener.
command method that crashed the bot when setting up
the listener.Introducing the Televerse Conversation! 🎉
Televerse Conversation! 🎉Conversation class to represent a conversation.waitForTextMessage, waitForPhotoMessage, waitForVideoMessage,
waitForVoiceMessage, waitForDocumentMessage, waitForContactMessage,
waitForLocationMessage, waitForVenueMessage, waitForPollMessage,
waitForDiceMessage, waitForGameMessage, waitForStickerMessage,
waitForVideoNoteMessage, waitToStartVideoChat, waitToEndVideoChat &
waitForCallbackQuery methods to Conversation class.MessageContext.args getter to get the arguments passed to the command.
Thanks to @GiuseppeFn for the contribution.
#115MessageContext.startParameter getter as it's no longer needed.Fixed a critical issue that caused bots to crash when an exception other than TelegramException is thrown.
TelegramException is thrown.onError method was able to catch the exception
but it rethrows it again.onError method will not rethrow the exception.Added a whole bunch of helper methods to listen to updates.
onAudio, onDocument, onPhoto, onSticker, onVideo,
onVideoNote, onVoice, onContact, onDice, onGame, onPollMessage,
onVenue, onLocation, onLiveLocation, onNewChatTitle, onNewChatPhoto,
onDeleteChatPhoto, onPinnedMessage, onUsrShared, onChatShared,
whenVideoChatScheduled, whenVideoChatStarted, whenVideoChatEnded,
onVideoChatParticipantsInvited, onForumTopicCreated, onForumTopicEdited,
onForumTopicClosed, onForumTopicReopened, onWebAppData, onAnimation,
onText, onCaptionTeleverse class and can make it easier
to listen to various Message updates.Fixes the issue which caused the crash of bots when a ChatJoinRequest update is received.
ChatJoinRequest update
is received.messageThreadId parameter noww be defaulted to the messageThreadId
parameter in the incoming Context object on reply method.Fixes an issue that caused none of onEditedMessage, onChannelPost, onEditedChannelPost, and myChatMember to work.
When onMessage listener is attached it stopped all other listeners from working. This is now fixed.
onMessage listener is attached it stopped all other listeners from
working. This is now fixed.Commands that tagged with @botname will now be matched.
@botname will now be matched.Televerse now can support handling updates passed to it as JSON data (without using a fetcher).
onError can now catch errors on the Long Polling.Exception with TelegramException in the library.Televerse.on logic to an extension on Televerse class.- Fix around onError method.
onError method.Added Televerse.onStop to listen when the bot is stopped. (Fix #95)
Televerse.onStop to listen when the bot is stopped. (Fix
#95)delayDuration parameter to LongPolling class to set the delay
duration between each long polling request.SessionFileExtension and SessionsSaver to Session
and SessionsManager classes respectively.http dependency to ^1.0.0.Nothing published for this version
Minor breaking change: the initializer function now should accept a int as parameter.
SessionFileExtension class to represent a file extension.SessionsSaver extension on SessionsManager class to save all
sessions to a directory.int as
parameter.Fixed an issue with sessions that caused crash when not initialized.
Introducing the Televerse Session! 🎉
Televerse Session! 🎉/example/session_bot.dart.Televerse.initSession method to initialize the session.Removed the deprecation warning from the Televerse.on method.
Televerse.on method! 🎉Televerse.on method.The on method is now Deprecated. Use the other methods in the library to listen for updates.
HandlerScope class is added to make it efficient handle updates.Televerse class now uses the HandlerScope class to
register handlers.Event class and related methods and getters.on method is now Deprecated. Use the other methods in the library to
listen for updates.Event class is now added to the Televerse class as
methods.onUpdate stream to listen for updates.onError method.Added UserLink class to represent a Telegram user link.
UserLink class to represent a Telegram user link.LinkText class. This can be used to send a link with a custom text on
chats.Televerse.command that caused to match unexpected
commands.
Televerse.command method used String.startsWith to
match the command.HttpException class is now renamed to TelegramException.ResponseParameters object in the exception hence to
make it easier to handle and retry if needed.Televerse.onError method this will now pauses the long polling till
the onError handler completes its execution.Added the Deeplink class to represent a Telegram deeplink.
Deeplink class to represent a Telegram deeplink.BotLink, GroupBotLink,
ChannelBotLink, GameLink, SettingsLinks and ShareLink classes.PhoneNumberLink, MTProxyLink, Socks5Link and UsernameLink.Added the new UserMention class to represent a user mention.
UserMention class to represent a user mention.User class to convert it to a UserMention object.MessageContext.from alias to Message.from property.CustomEmoji class to represent a Telegram custom emoji.Added more helper methods on Televerse class to listen to updates.
Televerse class to listen to updates.Televerse.onURL method to listen to messages that contain URLs.Televerse.onHashtag method to listen to messages that contain
hashtags.Televerse.onMention method to listen to messages that contain
mentions.Televerse.onEmail method to listen to messages that contain email
addresses.Televerse.onPhoneNumber method to listen to messages that contain
phone numbers.Televerse.whenMentioned method to listen to messages that contain
mentions of the bot.Added PollContext, PollAnswerContext classes to represent the context of a poll and poll_answer updates.
PollContext, PollAnswerContext classes to represent the context of a
poll and poll_answer updates.Televerse.poll method to listen to poll updates.Televerse.pollAnswer method to listen to poll_answer updates.StreamSubscription instead of
void.ChosenInlineResultContext class to represent the context of a
chosen_inline_result update and Televerse.chosenInlineResult method to
listen to chosen_inline_result updates.ChatJoinRequestContext class to represent the context of a
chat_join_request update and Televerse.chatJoinRequest method to listen to
chat_join_request updates.ShippingQueryContext class to represent the context of a
shipping_query update and Televerse.shippingQuery method to listen to
shipping_query updates.PreCheckoutQueryContext class to represent the context of a
pre_checkout_query update and Televerse.preCheckoutQuery method to listen
to pre_checkout_query updates.Added ChatMemberUpdatedContext class to represent the context of a chat_member and my_chat_member updates.
ChatMemberUpdatedContext class to represent the context of a
chat_member and my_chat_member updates.Televerse.chatMember and Televerse.myChatMember methods to listen to
chat_member and my_chat_member updates.Event class that caused unexpected
exceptions.🎖️ Televerse now supports listening to Local Bot API Server.
Televerse.local method to create a bot instance that listens to a
local Bot API Server.RawAPI.local method that can be used to create RawAPI instance that
targets a local Bot API Server.LongPolling.allUpdates method to listen to all updates. This is to
simplify listening to all updates including the chat_member updates./example/test_bot.dart file to reflect the changes.[BREAKING] ⚠️ - The chat getter on the ChatID class is now replaced to be a method of the ID class, and renamed to get().
chat getter on the ChatID class is now replaced to be a
method of the ID class, and renamed to get().chat parameter in the ChatID class.get() method is available on all the ID classes - ChatID,
SuperGroupID and ChannelID.Message.fromJson method which was not able to parse
the Message object when a newChatPhoto was present.[BREAKING] ⚠️ - The parameters name and languageCode are made positional in the setMyName method and the getMyName method.
name and languageCode are made positional in
the setMyName method and the getMyName method.[BREAKING] 👨🏻🔧 - The answerInlineQuery will no longer accept switchPmParameter or switchPmText parameters.
answerInlineQuery will no longer accept
switchPmParameter or switchPmText parameters.⚗️ BREAKING - The allowedUpdates parameter in the LongPolling object now accepts the list of UpdateType instead of String
allowedUpdates parameter in the LongPolling object
now accepts the list of UpdateType instead of StringrequestChat and requestUser in Keyboard==) on ID.WebhookInfo.toJson methodFixed an issue with RawAPI.copyMessage method.
RawAPI.copyMessage method.Televerse.command method to accept a String or RegExp as the
command parameter.Changed the data parameter to accept both String and RegExp using Pattern type on Televerse.callbackQuery method.
data parameter to accept both String and RegExp using
Pattern type on Televerse.callbackQuery method.Added new test cases in the /test folder.
/test folder.thumb parameters even though they were changed to
thumbnail in the API documentation. Fixed that.MessageOrBoolean as it was not needed. All
methods that return either a Message or a bool now split into two methods.
One for Message and one for bool.ReplyKeyboardRemove class to reflect auto set the
remove_keyboard parameter to true when the ReplyKeyboardRemove class is
created.ForceReply class to reflect auto set the
force_reply parameter to true when the ForceReply class is created.addStickerToSet method which caused it to fail. More
info on #57.createNewStickerSet method which caused it to fail. More
info on #58.Fixed an issue with RawAPI.sendAudio method.
RawAPI.sendAudio method.More fixes around the RawAPI class.
RawAPI class.RawAPI.getCustomEmojiStickers method.Fixed an issue with the RawAPI.sendChatAction method.
RawAPI.sendChatAction method.🤖 Bot API 6.6 (March 9, 2021) 🎉
Added Televerse.entity method to listen to entities in messages.
Televerse.entity method to listen to entities in messages.StreamController<Update> instance.onUpdate stream.Message.getEntityText method to get the text of the entity.Added Message.isCommand getter to check if the message is a command.
Message.isCommand getter to check if the message is a command.Televerse.onError method to listen to unexpected exceptions.A bunch of refactors on the on method.
on method.Added TeleverseEvent.command to listen to all commands.
TeleverseEvent.command to listen to all commands.Added helper methods on File class to get the file download URL, download URI, file bytes, and finally to download the file.
File class to get the file download URL, download
URI, file bytes, and finally to download the file.File.download method to download the file.File.getDownloadUrl method to get the file download URL as String.File.getDownloadURI method to get the Uri object of the file
download URL.File.getBytes method to get the file bytes this returns a
Future<Uint8List>.File.download method to download the file. This returns a
Future<io.File> object.Fixed an issue with the webhook configuration.
RawAPI
instance to the Fetcher constructor anymore.- Minor formatting changes.
Added the RawAPI class to access the raw Telegram Bot API methods.
RawAPI class to access the raw Telegram Bot API methods.api getter to Televerse class to access the RawAPI class.Added shorthand methods to setup listners for /start, /help, /settings commands.
/start, /help, /settings
commands.Televerse.start, Televerse.help, and Televerse.settings
to listen for these commands.MessageHandler as a parameter which is a type
alias for FutureOr<void> Function(MessageContext).MessageHandler, CallbackQueryHandler, and InlineQueryHandler type
aliases.Telegram Bot API 6.5 (February 3, 2023)
KeyboardButtonRequestUser,
KeyboardButtonRequestChat, UserShared and ChatShared.Added Televerse.instance getter to get the last instance of Bot created.
Televerse.instance getter to get the last instance of Bot created.ChatID.chat getter to get the Chat object from the ChatID object.RegExp? regex parameter to Televerse.command method.Added startParameter getter to MessageContext class. This will be automatically set when the bot is started by a user clicking on a deep link such as
startParameter getter to MessageContext class. This will be
automatically set when the bot is started by a user clicking on a deep link
such as t.me/MyBot?start=12345.New InlineKeyboard class is added. This can be very useful in creating InlineKeyboardMarkup.
InlineKeyboard class is added. This can be very useful in creating
InlineKeyboardMarkup.Keyboard class to help with creating ReplyKeyboardMarkup easily and
quickly.ReplyKeyboardMarkup and KeyboardButton as per the API
Documentation (some of the optional parameters were required in the previous
version).sendMessage to not work when used with any
reply markup.Added documentation for all most all classes and Televerse things.
Added MessageMixin to support MessageContext.
MessageMixin to support MessageContext.replyWithPhoto, replyWithVideo, replyWithAudio,
replyWithDocument, replyWithVideoNote, replyWithVoice, replyWithVenue,
replyWithContact, replyWithPoll, replyWithDice, replyWithChatAction,
replyWithGame, replyWithAnimation, replyWithSticker, editMessageText,
and deleteMessage methods to MessageContext.ManagementMixin to support MessageContext.banAuthor, banSenderChat, deleteChatPhoto, promoteAuthor,
restrictAuthor, exportChatInviteLink, revokeChatInviteLink,
pinChatMessage, unpinChatMessage, getChat, getChatAdministrators,
getChatMember, and leaveChat on ManagementMixin.MessageMixin and ManagementMixin are now available on
MessageContext.CallbackQueryMixin to support CallbackQueryContext.CallbackQueryContext now has answer and editMessage methods available.InlineQueryMixin to support InlineQueryContext.InlineQueryContext now has answer, and answerWithArticles methods
available.Fixed an issue with the on method that it's not getting called on any filters.
on method that it's not getting called on any
filters.Added TeleverseEvent enum to make it easy to listen for particular events.
TeleverseEvent enum to make it easy to listen for particular events.on method accessible on Televerse class. This method can be used
to listen for particular events as listed in TeleverseEvent enum.Televerse.callbackQuery to accept RegExp? regex as an
optional parameter. This can be used to listen for callback queries that match
the passed regex.Message instead of MessageContext.Context class to have the associated Update object with it.MessageContextOrBoolean class to be MessageOrBoolean in places a
method sending either Message or bool, such as editMessageLiveLocation
etc.Added a lot new methods to Televerse class:
Televerse class:
command - Can be used to listen for Messages that contain the passed
commandtext - This is a very basic method, which can be used to listen to
messages that contain particular text content in itcallbackQuery - Can be used to listen for callbackQuery updates.chatType and chatTypes - Can be used to register callbacks for messages
received on particular chat types.filter - Filter is an advanced method that can be used to listen for
messages that pass a given predicate condition.hears - One of the best picks. Users can pass a RegEx pattern and listen
for messages that contain a match.MessageContext.id to get the Chat ID easilyMessageContext class added with reply method
MessageContext class added with reply methodNothing published for this version
On development release. Completely new project.
Your coding agent can read these notes before it upgrades. Set up the MCP server →