GramJS

channels.EditBanned

Ban/unban/kick a user in a supergroup/channel.

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.channels.EditBanned({
      channel: "username",
      participant: "username",
      bannedRights: new Api.ChatBannedRights({
        untilDate: 43,
        viewMessages: None,
        sendMessages: None,
        sendMedia: true,
        sendStickers: true,
        sendGifs: true,
        sendGames: true,
        sendInline: true,
        sendPolls: true,
        changeInfo: true,
        inviteUsers: true,
        pinMessages: 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.channels.EditBanned({
      channel: "username",
      participant: "username",
      bannedRights: new Api.ChatBannedRights({
        untilDate: 43,
        viewMessages: None,
        sendMessages: None,
        sendMedia: true,
        sendStickers: true,
        sendGifs: true,
        sendGames: true,
        sendInline: true,
        sendPolls: true,
        changeInfo: true,
        inviteUsers: true,
        pinMessages: true,
      }),
    })
  );
  console.log(result); // prints the result
})();

Parameters

NameTypeDescription
channelInputChannelThe supergroup/channel.
userIdInputUserThe ID of the user whose banned rights should be modified
bannedRightsChatBannedRightsThe banned rights

Result

Updates

Possible errors

CodeTypeDescription
400CHANNEL_INVALIDThe provided channel is invalid
400CHANNEL_PRIVATEYou haven't joined this channel/supergroup
400CHAT_ADMIN_REQUIREDYou must be an admin in this chat to do this
403CHAT_WRITE_FORBIDDENYou can't write in this chat
400MSG_ID_INVALIDInvalid message ID provided
400PINNED_DIALOGS_TOO_MUCHToo many pinned dialogs
400USER_ADMIN_INVALIDYou're not an admin
400USER_ID_INVALIDThe provided user ID is invalid

Can bots use this method?

Yes

Channels

How to handle channels, supergroups, groups, and what's the difference between them.