telegram api method · layer 229 · #8ef8ecc0

messages.setGameScore

usable by bots

Use this method to set the score of the specified user in a game sent as a normal message (bots only).

definition

messages.setGameScore#8ef8ecc0 flags:# edit_message:flags.0?true force:flags.1?true peer:InputPeer id:int user_id:InputUser score:int = Updates;

name	type	description
`flags`	#	Flags, see TL conditional fields
`edit_message`	flags.0?true	Set this flag if the game message should be automatically edited to include the current scoreboard
`force`	flags.1?true	Set this flag if the high score is allowed to decrease. This can be useful when fixing mistakes or banning cheaters
`peer`	InputPeer	Unique identifier of target chat
`id`	int	Identifier of the sent message
`user_id`	InputUser	User identifier
`score`	int	New score

code	error	description
400	BOT_SCORE_NOT_MODIFIED	The score wasn't modified.
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	MESSAGE_ID_INVALID	The provided message id is invalid.
400	PEER_ID_INVALID	The provided peer id is invalid.
400	SCORE_INVALID	The specified game score is invalid.
400	USER_BOT_REQUIRED	This method can only be called by a bot.
401	AUTH_KEY_UNREGISTERED	The specified authorization key is not registered in the system (for example, a PFS temporary key has expired).

present in layers 62–229

id	layers
#8ef8ecc0	62–229