messages.sendMessage

messages.sendMessage

No description provided by the pinned schema.

Signature

messages.sendMessage#fef48f62 flags:# no_webpage:flags.1?true silent:flags.5?true background:flags.6?true clear_draft:flags.7?true noforwards:flags.14?true update_stickersets_order:flags.15?true invert_media:flags.16?true allow_paid_floodskip:flags.19?true peer:InputPeer reply_to:flags.0?InputReplyTo message:string random_id:long reply_markup:flags.2?ReplyMarkup entities:flags.3?Vector<MessageEntity> schedule_date:flags.10?int schedule_repeat_period:flags.24?int send_as:flags.13?InputPeer quick_reply_shortcut:flags.17?InputQuickReplyShortcut effect:flags.18?long allow_paid_stars:flags.21?long suggested_post:flags.22?SuggestedPost rich_message:flags.23?InputRichMessage = Updates;

Result type

Updates

Parameters

Name	Type	Flag	Default	Description
flags	#	flag word	—	No description provided by the pinned schema.
no_webpage	flags.1?true	flags.1	—	No description provided by the pinned schema.
silent	flags.5?true	flags.5	—	No description provided by the pinned schema.
background	flags.6?true	flags.6	—	No description provided by the pinned schema.
clear_draft	flags.7?true	flags.7	—	No description provided by the pinned schema.
noforwards	flags.14?true	flags.14	—	No description provided by the pinned schema.
update_stickersets_order	flags.15?true	flags.15	—	No description provided by the pinned schema.
invert_media	flags.16?true	flags.16	—	No description provided by the pinned schema.
allow_paid_floodskip	flags.19?true	flags.19	—	No description provided by the pinned schema.
peer	InputPeer	—	—	No description provided by the pinned schema.
reply_to	flags.0?InputReplyTo	flags.0	—	No description provided by the pinned schema.
message	string	—	—	No description provided by the pinned schema.
random_id	long	—	—	No description provided by the pinned schema.
reply_markup	flags.2?ReplyMarkup	flags.2	—	No description provided by the pinned schema.
entities	flags.3?Vector	flags.3	—	No description provided by the pinned schema.
schedule_date	flags.10?int	flags.10	—	No description provided by the pinned schema.
schedule_repeat_period	flags.24?int	flags.24	—	No description provided by the pinned schema.
send_as	flags.13?InputPeer	flags.13	—	No description provided by the pinned schema.
quick_reply_shortcut	flags.17?InputQuickReplyShortcut	flags.17	—	No description provided by the pinned schema.
effect	flags.18?long	flags.18	—	No description provided by the pinned schema.
allow_paid_stars	flags.21?long	flags.21	—	No description provided by the pinned schema.
suggested_post	flags.22?SuggestedPost	flags.22	—	No description provided by the pinned schema.
rich_message	flags.23?InputRichMessage	flags.23	—	No description provided by the pinned schema.

Flags

Parameter	Bit	Meaning
no_webpage	1	Controlled by flags; present when this bit is set.
silent	5	Controlled by flags; present when this bit is set.
background	6	Controlled by flags; present when this bit is set.
clear_draft	7	Controlled by flags; present when this bit is set.
noforwards	14	Controlled by flags; present when this bit is set.
update_stickersets_order	15	Controlled by flags; present when this bit is set.
invert_media	16	Controlled by flags; present when this bit is set.
allow_paid_floodskip	19	Controlled by flags; present when this bit is set.
reply_to	0	Controlled by flags; present when this bit is set.
reply_markup	2	Controlled by flags; present when this bit is set.
entities	3	Controlled by flags; present when this bit is set.
schedule_date	10	Controlled by flags; present when this bit is set.
schedule_repeat_period	24	Controlled by flags; present when this bit is set.
send_as	13	Controlled by flags; present when this bit is set.
quick_reply_shortcut	17	Controlled by flags; present when this bit is set.
effect	18	Controlled by flags; present when this bit is set.
allow_paid_stars	21	Controlled by flags; present when this bit is set.
suggested_post	22	Controlled by flags; present when this bit is set.
rich_message	23	Controlled by flags; present when this bit is set.

Python binding

from miniproto.raw.functions import MessagesSendMessage

Public access: miniproto.raw.functions.MessagesSendMessage.

Safe usage shape

from miniproto.raw.functions import MessagesSendMessage

# Naming the raw request class is local only; it performs no I/O or network request.
request_type = MessagesSendMessage

Result family

Updates

RPC errors

Code	Error	Description
400	ADMIN_RIGHTS_EMPTY	The chatAdminRights constructor passed in keyboardButtonRequestPeer.peer_type.user_admin_rights has no rights set (i.e. flags is 0).
400	BALANCE_TOO_LOW	The transaction cannot be completed because the current Telegram Stars balance is too low.
400	BOT_DOMAIN_INVALID	Bot domain invalid.
400	BOT_INVALID	This is not a valid bot.
400	BUSINESS_CONNECTION_INVALID	The connection_id passed to the wrapping invokeWithBusinessConnection call is invalid.
400	BUSINESS_CONNECTION_NOT_ALLOWED	This method was invoked over a business connection using invokeWithBusinessConnection, but either (1) we’re a user, and users cannot invoke methods over a business connection; (2) we’re a bot, but business mode was disabled in @botfather or (3); we’re a bot, but this method cannot be invoked over a business connection.
400	BUSINESS_PEER_INVALID	Messages can’t be set to the specified peer through the current business connection.
400	BUSINESS_PEER_USAGE_MISSING	You cannot send a message to a user through a business connection if the user hasn’t recently contacted us.
400	BUTTON_COPY_TEXT_INVALID	The specified keyboardButtonCopy.copy_text is invalid.
400	BUTTON_DATA_INVALID	The data of one or more of the buttons you provided is invalid.
400	BUTTON_ID_INVALID	The specified button ID is invalid.
400	BUTTON_TYPE_INVALID	The type of one or more of the buttons you provided is invalid.
400	BUTTON_URL_INVALID	Button URL invalid.
400	BUTTON_USER_INVALID	The user_id passed to inputKeyboardButtonUserProfile is invalid!
400	BUTTON_USER_PRIVACY_RESTRICTED	The privacy setting of the user specified in a inputKeyboardButtonUserProfile button do not allow creating such a button.
400	CHANNEL_INVALID	The provided channel is invalid.
400	CHANNEL_MONOFORUM_UNSUPPORTED	Monoforums do not support this feature.
400	CHANNEL_PRIVATE	You haven’t joined this channel/supergroup.
400	CHAT_ADMIN_REQUIRED	You must be an admin in this chat to do this.
400	CHAT_FORWARDS_RESTRICTED	You can’t forward messages from a protected chat.
400	CHAT_ID_INVALID	The provided chat id is invalid.
400	CHAT_RESTRICTED	You can’t send messages in this chat, you were restricted.
400	DOCUMENT_INVALID	The specified document is invalid.
400	EFFECT_CHAT_INVALID	Message effects can only be used in private 1-on-1 chats, but the caller tried to send a message with an effect to a group or channel.
400	ENCRYPTION_DECLINED	The secret chat was declined.
400	ENTITIES_TOO_LONG	You provided too many styled message entities.
400	ENTITY_BOUNDS_INVALID	A specified entity offset or length is invalid, see here » for info on how to properly compute the entity offset/length.
400	ENTITY_DATE_FORMAT_INVALID	One of the passed messageEntityFormattedDate objects has an invalid format (i.e. an invalid combination of the format flags).
400	ENTITY_DATE_INVALID	One of the passed messageEntityFormattedDate objects has an invalid date: the allowed value ranges from 0 to the current date plus 1098 days (time()+1098*86400).
400	ENTITY_DATE_TOO_LONG	The maximum text span that can be covered by a date entity is 31 UTF-16 code units if any of the date formatting flags is set, or 127 UTF-16 code units without. .
400	ENTITY_MENTION_USER_INVALID	You mentioned an invalid user.
400	FROM_MESSAGE_BOT_DISABLED	Bots can’t use fromMessage min constructors.
400	INPUT_USER_DEACTIVATED	The specified user was deleted.
400	MESSAGE_EMPTY	The provided message is empty.
400	MESSAGE_TOO_LONG	The provided message is too long.
400	MSG_ID_INVALID	Invalid message ID provided.
400	PEER_ID_INVALID	The provided peer id is invalid.
400	PEER_TYPES_INVALID	The passed keyboardButtonSwitchInline.peer_types field is invalid.
400	PINNED_DIALOGS_TOO_MUCH	Too many pinned dialogs.
400	POLL_OPTION_INVALID	Invalid poll option provided.
400	QUICK_REPLIES_BOT_NOT_ALLOWED	Quick replies cannot be used by bots.
400	QUICK_REPLIES_TOO_MUCH	A maximum of appConfig.quick_replies_limit shortcuts may be created, the limit was reached.
400	QUOTE_TEXT_INVALID	The specified reply_to.quote_text field is invalid.
400	RANDOM_ID_EMPTY	Random ID empty.
400	REPLY_MARKUP_INVALID	The provided reply markup is invalid.
400	REPLY_MARKUP_TOO_LONG	The specified reply_markup is too long.
400	REPLY_MESSAGES_TOO_MUCH	Each shortcut can contain a maximum of appConfig.quick_reply_messages_limit messages, the limit was reached.
400	REPLY_MESSAGE_ID_INVALID	The specified reply-to message ID is invalid.
400	REPLY_TO_INVALID	The specified reply_to field is invalid.
400	REPLY_TO_MONOFORUM_PEER_INVALID	The specified inputReplyToMonoForum.monoforum_peer_id is invalid.
400	REPLY_TO_USER_INVALID	The replied-to user is invalid.
400	SCHEDULE_BOT_NOT_ALLOWED	Bots cannot schedule messages.
400	SCHEDULE_DATE_TOO_LATE	You can’t schedule a message this far in the future.
400	SCHEDULE_STATUS_PRIVATE	Can’t schedule until user is online, if the user’s last seen timestamp is hidden by their privacy settings.
400	SCHEDULE_TOO_MUCH	There are too many scheduled messages.
400	SEND_AS_PEER_INVALID	You can’t send messages as the specified peer.
400	STORIES_NEVER_CREATED	This peer hasn’t ever posted any stories.
400	STORY_ID_INVALID	The specified story ID is invalid.
400	SUGGESTED_POST_AMOUNT_INVALID	The specified price for the suggested post is invalid.
400	SUGGESTED_POST_PEER_INVALID	You cannot send suggested posts to non-monoforum peers.
400	TOPIC_CLOSED	This topic was closed, you can’t send messages to it anymore.
400	TOPIC_DELETED	The specified topic was deleted.
400	USER_BANNED_IN_CHANNEL	You’re banned from sending messages in supergroups/channels.
400	USER_BOT_TO_BOT_DISABLED	Bot-to-bot messaging is disabled because one of the two bots hasn’t enabled the Bot to Bot setting in @BotFather.
400	USER_IS_BLOCKED	You were blocked by this user.
400	USER_IS_BOT	Bots can’t send messages to other bots.
400	WC_CONVERT_URL_INVALID	WC convert URL invalid.
400	YOU_BLOCKED_USER	You blocked this user.
401	AUTH_KEY_UNREGISTERED	The specified authorization key is not registered in the system (for example, a PFS temporary key has expired).
403	ALLOW_PAYMENT_REQUIRED_%d	This peer charges %d Telegram Stars per message, but the allow_paid_stars was not set or its value is smaller than %d.
403	CHAT_ADMIN_REQUIRED	You must be an admin in this chat to do this.
403	CHAT_GUEST_SEND_FORBIDDEN	You join the discussion group before commenting, see here » for more info.
403	CHAT_SEND_PLAIN_FORBIDDEN	You can’t send non-media (text) messages in this chat.
403	CHAT_WRITE_FORBIDDEN	You can’t write in this chat.
403	PREMIUM_ACCOUNT_REQUIRED	A premium account is required to execute this action.
403	PRIVACY_PREMIUM_REQUIRED	You need a Telegram Premium subscription to send a message to this user.
403	USER_IS_BLOCKED	You were blocked by this user.
404	PEER_ID_INVALID	The provided peer id is invalid.
406	ALLOW_PAYMENT_REQUIRED	This peer only accepts paid messages »: this error is only emitted for older layers without paid messages support, so the client must be updated in order to use paid messages. .
406	CHANNEL_PRIVATE	You haven’t joined this channel/supergroup.
406	PAYMENT_UNSUPPORTED	A detailed description of the error will be received separately as described here ».
406	PEER_ID_INVALID	The provided peer id is invalid.
406	PRIVACY_PREMIUM_REQUIRED	You need a Telegram Premium subscription to send a message to this user.
406	TOPIC_CLOSED	This topic was closed, you can’t send messages to it anymore.
406	TOPIC_DELETED	The specified topic was deleted.
420	SLOWMODE_WAIT_%d	Slowmode is enabled in this chat: wait %d seconds before sending another message to this chat.
500	MSG_WAIT_FAILED	A waiting call returned an error.
500	RANDOM_ID_DUPLICATE	You provided a random ID that was already used.

Accepted types

InputPeer, InputQuickReplyShortcut, InputReplyTo, InputRichMessage, MessageEntity, ReplyMarkup, SuggestedPost Known selected constructors: inputPeerChannel, inputPeerChannelFromMessage, inputPeerChat, inputPeerEmpty, inputPeerSelf, inputPeerUser, inputPeerUserFromMessage, inputQuickReplyShortcut, inputQuickReplyShortcutId, inputReplyToEphemeralMessage, inputReplyToMessage, inputReplyToMonoForum, inputReplyToStory, inputRichMessage, inputRichMessageHTML, inputRichMessageMarkdown, inputMessageEntityMentionName, messageEntityBankCard, messageEntityBlockquote, messageEntityBold, messageEntityBotCommand, messageEntityCashtag, messageEntityCode, messageEntityCustomEmoji, messageEntityDiffDelete, messageEntityDiffInsert, messageEntityDiffReplace, messageEntityEmail, messageEntityFormattedDate, messageEntityHashtag, messageEntityItalic, messageEntityMention, messageEntityMentionName, messageEntityPhone, messageEntityPre, messageEntitySpoiler, messageEntityStrike, messageEntityTextUrl, messageEntityUnderline, messageEntityUnknown, messageEntityUrl, replyInlineMarkup, replyKeyboardForceReply, replyKeyboardHide, replyKeyboardMarkup, suggestedPost

Returned types

Updates Known selected constructors: updateShort, updateShortChatMessage, updateShortMessage, updateShortSentMessage, updates, updatesCombined, updatesTooLong

Related methods

account.disablePeerConnectedBot, account.getBotBusinessConnection, account.getNotifyExceptions, account.getPaidMessagesRevenue, account.reportPeer, account.reportProfilePhoto, account.saveAutoSaveSettings, account.toggleConnectedBotPaused, account.toggleNoPaidMessagesException, account.toggleWebBrowserSettingsException, account.updateConnectedBot, bots.allowSendMessage, bots.setCustomVerification, channels.convertToGigagroup, channels.createChannel, channels.deleteChannel, channels.deleteHistory, channels.deleteParticipantHistory, channels.editAdmin, channels.editBanned, channels.editPhoto, channels.editTitle, channels.getParticipant, channels.getSendAs, channels.leaveChannel, channels.reportSpam, channels.restrictSponsoredMessages, channels.searchPosts, channels.setBoostsToUnblockRestrictions, channels.toggleAntiSpam, channels.toggleAutotranslation, channels.toggleForum, channels.toggleJoinRequest, channels.toggleJoinToSend, channels.toggleParticipantsHidden, channels.togglePreHistoryHidden, channels.toggleSignatures, channels.toggleSlowMode, channels.toggleViewForumAsMessages, channels.updateColor, channels.updateEmojiStatus, channels.updatePaidMessagesPrice, chatlists.editExportedInvite, chatlists.exportChatlistInvite, chatlists.joinChatlistInvite, chatlists.joinChatlistUpdates, chatlists.leaveChatlist, communities.create, communities.getParticipantJoinedChats, communities.toggleCommunityCollapsedInDialogs, communities.toggleParticipantBanned, communities.togglePeerLink, communities.togglePeerLinkRequestApproval, contacts.acceptContact, contacts.addContact, contacts.block, contacts.blockFromReplies, contacts.deleteContacts, contacts.getLocated, contacts.resetTopPeerRating, contacts.setBlocked, contacts.unblock, ephemeral.deleteMessage, ephemeral.editMessage, ephemeral.getCallbackAnswer, ephemeral.reportMessage, ephemeral.sendMessage, folders.editPeerFolders, help.dismissSuggestion, help.editUserInfo, help.hidePromoData, messages.acceptUrlAuth, messages.addPollAnswer, messages.appendTodoList, messages.checkHistoryImportPeer, messages.composeRichMessageWithAI, messages.createForumTopic, messages.deleteChatUser, messages.deleteExportedChatInvite, messages.deleteFactCheck, messages.deleteHistory, messages.deleteParticipantReaction, messages.deleteParticipantReactions, messages.deletePollAnswer, messages.deleteQuickReplyMessages, messages.deleteRevokedExportedChatInvites, messages.deleteSavedHistory, messages.deleteScheduledMessages, messages.deleteTopicHistory, messages.editChatAbout, messages.editChatCreator, messages.editChatDefaultBannedRights, messages.editChatParticipantRank, messages.editChatPhoto, messages.editChatTitle, messages.editExportedChatInvite, messages.editFactCheck, messages.editForumTopic, messages.editInlineBotMessage, messages.editMessage, messages.exportChatInvite, messages.forwardMessages, messages.getAdminsWithInvites, messages.getAllDrafts, messages.getBotCallbackAnswer, messages.getChatInviteImporters, messages.getDialogUnreadMarks, messages.getDialogs, messages.getDiscussionMessage, messages.getExportedChatInvite, messages.getExportedChatInvites, messages.getExtendedMedia, messages.getFactCheck, messages.getForumTopics, messages.getForumTopicsByID, messages.getFutureChatCreatorAfterLeave, messages.getGameHighScores, messages.getHistory, messages.getInlineBotResults, messages.getMessageEditData, messages.getMessageReactionsList, messages.getMessageReadParticipants, messages.getMessagesReactions, messages.getMessagesViews, messages.getOnlines, messages.getOutboxReadDate, messages.getPaidReactionPrivacy, messages.getPeerSettings, messages.getPollResults, messages.getPollVotes, messages.getRecentLocations, messages.getReplies, messages.getRichMessage, messages.getSavedDialogs, messages.getSavedDialogsByID, messages.getSavedHistory, messages.getSavedReactionTags, messages.getScheduledHistory, messages.getScheduledMessages, messages.getSearchCounters, messages.getSearchResultsCalendar, messages.getSearchResultsPositions, messages.getSponsoredMessages, messages.getUnreadMentions, messages.getUnreadPollVotes, messages.getUnreadReactions, messages.getWebPagePreview, messages.hideAllChatJoinRequests, messages.hideChatJoinRequest, messages.hidePeerSettingsBar, messages.initHistoryImport, messages.markDialogUnread, messages.migrateChat, messages.prolongWebView, messages.rateTranscribedAudio, messages.readDiscussion, messages.readHistory, messages.readMentions, messages.readPollVotes, messages.readReactions, messages.readSavedHistory, messages.reorderPinnedForumTopics, messages.report, messages.reportMessagesDelivery, messages.reportReaction, messages.reportReadMetrics, messages.reportSpam, messages.requestAppWebView, messages.requestMainWebView, messages.requestUrlAuth, messages.requestWebView, messages.saveDefaultSendAs, messages.saveDraft, messages.search, messages.searchGlobal, messages.sendBotRequestedPeer, messages.sendInlineBotResult, messages.sendMedia, messages.sendMultiMedia, messages.sendPaidReaction, messages.sendQuickReplyMessages, messages.sendReaction, messages.sendScheduledMessages, messages.sendScreenshotNotification, messages.sendVote, messages.sendWebViewData, messages.setChatAvailableReactions, messages.setChatTheme, messages.setChatWallPaper, messages.setGameScore, messages.setHistoryTTL, messages.setTyping, messages.startBot, messages.startHistoryImport, messages.summarizeText, messages.toggleNoForwards, messages.togglePaidReactionPrivacy, messages.togglePeerTranslations, messages.toggleSuggestedPostApproval, messages.toggleTodoCompleted, messages.transcribeAudio, messages.translateRichMessage, messages.translateText, messages.unpinAllMessages, messages.updatePinnedForumTopic, messages.updatePinnedMessage, messages.uploadImportedMedia, messages.uploadMedia, payments.applyGiftCode, payments.assignAppStoreTransaction, payments.assignPlayMarketTransaction, payments.changeStarsSubscription, payments.connectStarRefBot, payments.craftStarGift, payments.createStarGiftCollection, payments.deleteStarGiftCollection, payments.editConnectedStarRefBot, payments.fulfillStarsSubscription, payments.getConnectedStarRefBot, payments.getConnectedStarRefBots, payments.getGiveawayInfo, payments.getPaymentReceipt, payments.getPremiumGiftCodeOptions, payments.getSavedStarGifts, payments.getStarGiftCollections, payments.getStarsRevenueAdsAccountUrl, payments.getStarsRevenueStats, payments.getStarsRevenueWithdrawalUrl, payments.getStarsStatus, payments.getStarsSubscriptions, payments.getStarsTransactions, payments.getStarsTransactionsByID, payments.getSuggestedStarRefBots, payments.launchPrepaidGiveaway, payments.refundStarsCharge, payments.reorderStarGiftCollections, payments.resolveStarGiftOffer, payments.sendStarGiftOffer, payments.toggleChatStarGiftNotifications, payments.toggleStarGiftsPinnedToTop, payments.transferStarGift, payments.updateStarGiftCollection, payments.updateStarGiftPrice, payments.upgradeStarGift, phone.createConferenceCall, phone.createGroupCall, phone.declineConferenceCallInvite, phone.deleteConferenceCallParticipants, phone.deleteGroupCallMessages, phone.deleteGroupCallParticipantMessages, phone.discardCall, phone.discardGroupCall, phone.editGroupCallParticipant, phone.editGroupCallTitle, phone.getGroupCallChainBlocks, phone.getGroupCallJoinAs, phone.getGroupCallStreamRtmpUrl, phone.getGroupParticipants, phone.inviteConferenceCallParticipant, phone.inviteToGroupCall, phone.joinGroupCall, phone.joinGroupCallPresentation, phone.leaveGroupCall, phone.leaveGroupCallPresentation, phone.saveDefaultGroupCallJoinAs, phone.saveDefaultSendAs, phone.sendConferenceCallBroadcast, phone.sendGroupCallMessage, phone.setCallRating, phone.startScheduledGroupCall, phone.toggleGroupCallRecord, phone.toggleGroupCallSettings, phone.toggleGroupCallStartSubscription, premium.applyBoost, premium.getBoostsList, premium.getBoostsStatus, premium.getUserBoosts, stats.getPollStats, stats.getStoryPublicForwards, stats.getStoryStats, stories.activateStealthMode, stories.canSendStory, stories.createAlbum, stories.deleteAlbum, stories.deleteStories, stories.editStory, stories.exportStoryLink, stories.getAlbumStories, stories.getAlbums, stories.getAllReadPeerStories, stories.getPeerMaxIDs, stories.getPeerStories, stories.getPinnedStories, stories.getStoriesArchive, stories.getStoriesByID, stories.getStoriesViews, stories.getStoryReactionsList, stories.getStoryViewsList, stories.incrementStoryViews, stories.readStories, stories.reorderAlbums, stories.report, stories.searchPosts, stories.sendReaction, stories.sendStory, stories.startLive, stories.togglePeerStoriesHidden, stories.togglePinned, stories.togglePinnedToTop, stories.updateAlbum, users.suggestBirthday

Availability evidence

• business supported

Provenance

• layer: 228
• structural source: tdlib
• canonical schema: https://raw.githubusercontent.com/tdlib/td/refs/heads/master/td/generate/scheme/telegram_api.tl
• prose merge precedence: TDLib → Telegram Desktop → Core JSON
• source note: Canonical structure is the pinned TDLib telegram_api.tl; Layer 228 comes only from the matching Telegram Desktop end-of-file marker; core.telegram.org inputs enrich documentation and RPC error metadata without overriding structure.

Source-diff notes

• tdlib_vs_core: changed_count=68; core_only_count=1; overlap_count=2302; tdlib_only_count=158
• tdlib_vs_tdesktop: changed_count=0; overlap_count=2448; tdesktop_only=null; tdlib_only=accessPointRule, ephemeral.editMessage, help.configSimple, inputPeerPhotoFileLocationLegacy, inputStickerSetThumbLegacy, invokeWithApnsSecretPrefix, invokeWithBusinessConnectionPrefix, invokeWithGooglePlayIntegrityPrefix, invokeWithReCaptchaPrefix, ipPort, ipPortSecret, updateEphemeralBotCallbackQuery