messages.sendMessage

Sends a message to a chat

func (c *Client) MessagesSendMessage(ctx context.Context, request *MessagesSendMessageRequest) (UpdatesClass, error)

Calling this method

client.Run(ctx, func(ctx context.Context) error {
	api := client.API()
	
	res, err := api.MessagesSendMessage(ctx, &tg.MessagesSendMessageRequest{
		// see Parameters
	})
	if err != nil {
		return err
	}
	_ = res // UpdatesClass
	return nil
})

Parameters

Name	Type	Required	Description
NoWebpage	bool	—	Set this flag to disable generation of the webpage preview
Silent	bool	—	Send this message silently (no notifications for the receivers)
Background	bool	—	Send this message as background message
ClearDraft	bool	—	Clear the draft field
Noforwards	bool	—	Only for bots, disallows forwarding and saving of the messages, even if the destination chat doesn't have content protection enabled
UpdateStickersetsOrder	bool	—	Whether to move used stickersets to top, see here for more info on this flag »
InvertMedia	bool	—	If set, any eventual webpage preview will be shown on top of the message instead of at the bottom.
AllowPaidFloodskip	bool	—	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	InputPeerClass	yes	The destination where the message will be sent
ReplyTo	InputReplyToClass	—	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	yes	The message
RandomID	int64	yes	Unique client message ID required to prevent message resending
ReplyMarkup	ReplyMarkupClass	—	Reply markup for sending bot buttons
Entities	[]MessageEntityClass	—	Message entities for sending styled text
ScheduleDate	int	—	Scheduled message date for scheduled messages
ScheduleRepeatPeriod	int	—	Once sent, this message will be automatically re-scheduled to be re-sent again this many seconds in the future, see here » for more info on repeating scheduled messages.
SendAs	InputPeerClass	—	Send this message as the specified peer
QuickReplyShortcut	InputQuickReplyShortcutClass	—	Add the message to the specified quick reply shortcut », instead.
Effect	int64	—	Specifies a message effect » to use for the message.
AllowPaidStars	int64	—	For paid messages », specifies the amount of Telegram Stars the user has agreed to pay in order to send the message.
SuggestedPost	SuggestedPost	—	Used to suggest a post to a channel, see here » for more info on the full flow.
RichMessage	InputRichMessageClass	—	RichMessage field of MessagesSendMessageRequest.

Returns

UpdatesClass

Possible errors

Code	Type	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).
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. .
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_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.
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	EFFECT_CHAT_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 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.
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 keyboardButtonSwitchInline.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.
406	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 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.
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 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.
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.

References

• Official documentation
• Generated Go reference
• TL definition: messages.sendMessage#fef48f62