messages.sendMessage - Gogram TL Reference

Layer 220

method Users Bots Business

messages.sendMessage#fe05dc9a 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 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 = Updates;

Parameters

Name	Type	Description
Flags	#	Flags, see TL conditional fields
NoWebpage	flags.1?true	Set this flag to disable generation of the webpage preview
Silent	flags.5?true	Send this message silently (no notifications for the receivers)
Background	flags.6?true	Send this message as background message
ClearDraft	flags.7?true	Clear the draft field
Noforwards	flags.14?true	Only for bots, disallows forwarding and saving of the messages, even if the destination chat doesn't have content protection enabled
UpdateStickersetsOrder	flags.15?true	Whether to move used stickersets to top, see here for more info on this flag
InvertMedia	flags.16?true	If set, any eventual webpage preview will be shown on top of the message instead of at the bottom.
AllowPaidFloodskip	flags.19?true	Bots only: if set, allows sending up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance.
Peer	InputPeer	The destination where the message will be sent
ReplyTo	flags.0?InputReplyTo	If set, indicates that the message should be sent in reply to the specified message or story. Also used to quote other messages.
Message	string	The message
RandomId	long	Unique client message ID required to prevent message resending
ReplyMarkup	flags.2?ReplyMarkup	Reply markup for sending bot buttons
Entities	Vector<MessageEntity>	Message entities for sending styled text
ScheduleDate	flags.10?int	Scheduled message date for scheduled messages
SendAs	flags.13?InputPeer	Send this message as the specified peer
QuickReplyShortcut	flags.17?InputQuickReplyShortcut	Add the message to the specified quick reply shortcut, instead.
Effect	flags.18?long	Specifies a message effect to use for the message.
AllowPaidStars	flags.21?long	For paid messages, specifies the amount of Telegram Stars the user has agreed to pay in order to send the message.
SuggestedPost	flags.22?SuggestedPost	Used to suggest a post to a channel, see here for more info on the full flow.

Returns

Updates

Possible Errors

Code	Type	Description
400	ADMIN_RIGHTS_EMPTY	The chat Admin Rights constructor passed in keyboard Button Request Peer. peer_type. user_admin_rights has no rights set (i. e. flags is 0).
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..
403	ALLOW_PAYMENT_REQUIRED_%d	This peer charges <number> Telegram Stars per message, but the allow_paid_stars was not set or its value is smaller than <number>.
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 invoke With Business Connection call is invalid.
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 keyboard Button Copy. 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 input Keyboard Button User Profile is invalid!
400	BUTTON_USER_PRIVACY_RESTRICTED	The privacy setting of the user specified in a input Keyboard Button User Profile 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.
406	CHANNEL_PRIVATE	You haven't joined this channel/supergroup.
403	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.
403	CHAT_GUEST_SEND_FORBIDDEN	You join the discussion group before commenting, see here for more info.
400	CHAT_ID_INVALID	The provided chat id is invalid.
400	CHAT_RESTRICTED	You can't send messages in this chat, you were restricted.
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.
400	DOCUMENT_INVALID	The specified document is invalid.
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_MENTION_USER_INVALID	You mentioned an invalid user.
400	FROM_MESSAGE_BOT_DISABLED	Bots can't use from Message 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.
500	MSG_WAIT_FAILED	A waiting call returned an error.
406	PAYMENT_UNSUPPORTED	A detailed description of the error will be received separately as described here.
404	PEER_ID_INVALID	The provided peer id is invalid.
400	PEER_TYPES_INVALID	The passed keyboard Button Switch Inline. peer_types field is invalid.
400	PINNED_DIALOGS_TOO_MUCH	Too many pinned dialogs.
400	POLL_OPTION_INVALID	Invalid poll option provided.
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.
400	QUICK_REPLIES_BOT_NOT_ALLOWED	Quick replies cannot be used by bots.
400	QUICK_REPLIES_TOO_MUCH	A maximum of app Config. quick_replies_limit shortcuts may be created, the limit was reached.
400	QUOTE_TEXT_INVALID	The specified reply_to. quote_text field is invalid.
500	RANDOM_ID_DUPLICATE	You provided a random ID that was already used.
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 app Config. 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 input Reply To Mono Forum. 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.
420	SLOWMODE_WAIT_%d	Slowmode is enabled in this chat: wait <number> seconds before sending another message to this chat.
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.
406	TOPIC_CLOSED	This topic was closed, you can't send messages to it anymore.
406	TOPIC_DELETED	The specified topic was deleted.
400	USER_BANNED_IN_CHANNEL	You're banned from sending messages in supergroups/channels.
403	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.

Gogram Example

// MessagesSendMessage - using Params struct
result, err := client.MessagesSendMessage(&tg.MessagesSendMessageParams{
    Peer: &tg.InputPeerUser{UserID: int64(123456789)},
    Message: "...",
    RandomId: int64(0),

    // Optional fields:
    // NoWebpage: true,
    // Silent: true,
    // Background: true,
    // ClearDraft: true,
    // ...
})
if err != nil {
    // handle error
}
// result is *tg.Updates