telegram api method · layer 229 · #58bbcb50

messages.sendPaidReaction

usable by users

Sends one or more paid Telegram Star reactions », transferring Telegram Stars » to a channel's balance.

definition

messages.sendPaidReaction#58bbcb50 flags:# peer:InputPeer msg_id:int count:int random_id:long private:flags.0?PaidReactionPrivacy = Updates;

name	type	description
`flags`	#	Flags, see TL conditional fields
`peer`	InputPeer	The channel
`msg_id`	int	The message to react to
`count`	int	The number of stars to send (each will increment the reaction counter by one).
`random_id`	long	Unique client message ID required to prevent message resending. Note: this argument must be composed of a 64-bit integer where the lower 32 bits are random, and the higher 32 bits are equal to the current unixtime, i.e. uint64_t random_id = (time() << 32) \| ((uint64_t)random_uint32_t()): this differs from the random_id format of all other methods in the API, which just take 64 random bits.
`private`	flags.0?PaidReactionPrivacy	Each post with star reactions has a leaderboard with the top senders, but users can opt out of appearing there if they prefer more privacy. Not populating this field will use the default reaction privacy, stored on the server and synced to clients using updatePaidReactionPrivacy (see here for more info).

code	error	description
400	BALANCE_TOO_LOW	The transaction cannot be completed because the current Telegram Stars balance is too low.
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	CHANNEL_INVALID	The provided channel is invalid.
400	CHANNEL_PRIVATE	You haven't joined this channel/supergroup.
400	MESSAGE_ID_INVALID	The provided message id is invalid.
400	PEER_ID_INVALID	The provided peer id is invalid.
400	RANDOM_ID_EMPTY	Random ID empty.
400	RANDOM_ID_EXPIRED	The specified `random_id` was expired (most likely it didn't follow the required `uint64_t random_id = (time() << 32) \| ((uint64_t)random_uint32_t())` format, or the specified time is too far in the past).
400	REACTIONS_COUNT_INVALID	The specified number of reactions is invalid.
400	SEND_AS_PEER_INVALID	You can't send messages as the specified peer.
401	AUTH_KEY_UNREGISTERED	The specified authorization key is not registered in the system (for example, a PFS temporary key has expired).
403	CHAT_WRITE_FORBIDDEN	You can't write in this chat.

present in layers 186–229 · constructor id changed 2×