Machine-readable version of this page: /method/messages.setGameScore.md.
Use this method to set the score of the specified user in a game sent as a normal message (bots only).
Method schema is available as of layer 59. Switch ยป
| 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 | Type | Description |
|---|---|---|
| 400 | BOT_SCORE_NOT_MODIFIED | The score wasn't modified. |
| 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. |