GramJS

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

NameTypeDescription
flags#Flags, see TL conditional fields
editMessageflags.0?trueSet this flag if the game message should be automatically edited to include the current scoreboard
forceflags.1?trueSet this flag if the high score is allowed to decrease. This can be useful when fixing mistakes or banning cheaters
peerInputPeerUnique identifier of target chat
idintIdentifier of the sent message
userIdInputUserUser identifier
scoreintNew score

Result

Updates

Possible errors

CodeTypeDescription
400BOT_SCORE_NOT_MODIFIEDThe score wasn't modified.
400MESSAGE_ID_INVALIDThe provided message id is invalid.
400PEER_ID_INVALIDThe provided peer id is invalid.
400SCORE_INVALIDThe specified game score is invalid.
400USER_BOT_REQUIREDThis method can only be called by a bot.

Can bots use this method?

Yes