messages.SetGameScore
Use this method to set the score of the specified user in a game sent as a normal message (bots only).
Example
const { Api, TelegramClient } = require("telegram");
const { StringSession } = require("telegram/sessions");
const session = new StringSession(""); // You should put your string session here
const client = new TelegramClient(session, apiId, apiHash, {});
(async function run() {
await client.connect(); // This assumes you have already authenticated with .start()
const result = await client.invoke(
new Api.messages.SetGameScore({
peer: "username",
id: 43,
userId: "username",
score: 43,
editMessage: true,
force: true,
})
);
console.log(result); // prints the result
})();
import { Api, TelegramClient } from "telegram";
import { StringSession } from "telegram/sessions";
const session = new StringSession(""); // You should put your string session here
const client = new TelegramClient(session, apiId, apiHash, {});
(async function run() {
await client.connect(); // This assumes you have already authenticated with .start()
const result: Api.Updates = await client.invoke(
new Api.messages.SetGameScore({
peer: "username",
id: 43,
userId: "username",
score: 43,
editMessage: true,
force: true,
})
);
console.log(result); // prints the result
})();
Parameters
Name | Type | Description |
---|---|---|
flags | # | Flags, see TL conditional fields |
editMessage | 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 |
userId | InputUser | User identifier |
score | int | New score |
Result
Possible errors
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. |
Can bots use this method?
Yes