Chats & Members - Bots Limited

This section covers all administrative and management methods for chats and members in the Telegram Bot API.

Note: Most methods here require your bot to be an administrator in the target group or channel.

Member Management

banChatMember

Bans a user from a group, supergroup, or channel. The user can rejoin via invite link unless revoke_messages is used.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`user_id`	Integer	Yes	Telegram user ID to ban.
`until_date`	Integer	No	UNIX timestamp until when the user is banned. 0 or not set = permanent ban.
`revoke_messages`	Boolean	No	If `True`, deletes all messages sent by this user.

BLP Example

# Ban the user who sent a reply (permanent)
Bot.banChatMember(
    chat_id=message.chat.id,
    user_id=message.reply_to_message.from.id,
    revoke_messages=True
)

# Temporary ban for 1 hour
import time
Bot.banChatMember(
    chat_id=message.chat.id,
    user_id=message.reply_to_message.from.id,
    until_date=int(time.time()) + 3600
)

unbanChatMember

Unbans a previously banned user.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`user_id`	Integer	Yes	Telegram user ID to unban.
`only_if_banned`	Boolean	No	If `True`, only unbans if the user was previously banned (prevents errors).

BLP Example

Bot.unbanChatMember(
    chat_id=message.chat.id,
    user_id=message.reply_to_message.from.id,
    only_if_banned=True
)

restrictChatMember

Restricts what a user can do in a supergroup.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target supergroup ID.
`user_id`	Integer	Yes	User ID to restrict.
`permissions`	JSON String	Yes	A JSON-encoded `ChatPermissions` object.
`until_date`	Integer	No	UNIX timestamp when restriction is lifted.

ChatPermissions fields (all Boolean):

Field	Description
`can_send_messages`	Send text messages
`can_send_media_messages`	Send photos/videos/audio/documents
`can_send_polls`	Send polls
`can_send_other_messages`	Send stickers, GIFs, games
`can_add_web_page_previews`	Add web page previews
`can_change_info`	Change group info (admins only)
`can_invite_users`	Invite other users
`can_pin_messages`	Pin messages (admins only)

BLP Example

# Mute a user (restrict all message types)
permissions = {
    "can_send_messages": False,
    "can_send_media_messages": False,
    "can_send_polls": False,
    "can_send_other_messages": False
}

Bot.restrictChatMember(
    chat_id=message.chat.id,
    user_id=message.reply_to_message.from.id,
    permissions=jsondumps(permissions)
)

promoteChatMember

Promotes or demotes a user as administrator in a supergroup or channel.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`user_id`	Integer	Yes	User ID to promote.
`is_anonymous`	Boolean	No	If `True`, admin messages appear as group name.
`can_manage_chat`	Boolean	No	Allows managing the chat.
`can_change_info`	Boolean	No	Allows changing group info.
`can_delete_messages`	Boolean	No	Allows deleting any message.
`can_invite_users`	Boolean	No	Allows inviting users.
`can_restrict_members`	Boolean	No	Allows banning/restricting users.
`can_pin_messages`	Boolean	No	Allows pinning messages.
`can_manage_topics`	Boolean	No	Allows managing forum topics.
`can_post_stories`	Boolean	No	Allows posting stories.
`can_edit_stories`	Boolean	No	Allows editing stories.
`can_delete_stories`	Boolean	No	Allows deleting stories.
`can_send_welcome_messages`	Boolean	No	Allows sending welcome messages.

BLP Example

# Promote to full admin
Bot.promoteChatMember(
    chat_id=message.chat.id,
    user_id=message.reply_to_message.from.id,
    can_manage_chat=True,
    can_change_info=True,
    can_delete_messages=True,
    can_invite_users=True,
    can_restrict_members=True,
    can_pin_messages=True
)

# Demote back to regular member (pass False for all)
Bot.promoteChatMember(
    chat_id=message.chat.id,
    user_id=message.reply_to_message.from.id,
    can_manage_chat=False
)

setChatAdministratorCustomTitle

Sets a custom title (badge) for an admin promoted by the bot.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target supergroup ID.
`user_id`	Integer	Yes	Admin user ID.
`custom_title`	String	Yes	Admin title, up to 16 characters.

BLP Example

Bot.setChatAdministratorCustomTitle(
    chat_id=message.chat.id,
    user_id=message.reply_to_message.from.id,
    custom_title="Community Leader"
)

banChatSenderChat

Bans a channel from posting in a supergroup or channel.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`sender_chat_id`	Integer	Yes	ID of the channel to ban.

BLP Example

Bot.banChatSenderChat(
    chat_id=message.chat.id,
    sender_chat_id=message.reply_to_message.sender_chat.id
)

unbanChatSenderChat

Unbans a previously banned channel.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`sender_chat_id`	Integer	Yes	ID of the channel to unban.

BLP Example

Bot.unbanChatSenderChat(
    chat_id=message.chat.id,
    sender_chat_id=message.reply_to_message.sender_chat.id
)

Chat Management

setChatPermissions

Sets the default permissions for all non-admin members.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target supergroup ID.
`permissions`	JSON String	Yes	JSON-encoded `ChatPermissions` object.

BLP Example

# Lock down the group (read-only mode)
permissions = {
    "can_send_messages": False,
    "can_send_media_messages": False,
    "can_send_polls": False,
    "can_send_other_messages": False,
    "can_add_web_page_previews": False
}

Bot.setChatPermissions(
    chat_id=message.chat.id,
    permissions=jsondumps(permissions)
)

exportChatInviteLink

Generates a new primary invite link, revoking the previous one.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.

BLP Example

result = Bot.exportChatInviteLink(chat_id=message.chat.id)
Bot.sendMessage(chat_id=u, text=f"New Invite Link: {result.result}")

createChatInviteLink

Creates a custom invite link with optional expiry and member limits.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`name`	String	No	Link label (up to 32 characters).
`expire_date`	Integer	No	UNIX timestamp for link expiry.
`member_limit`	Integer	No	Maximum users who can join (1–99999).
`creates_join_request`	Boolean	No	If `True`, users must be approved by admin.

BLP Example

Bot.createChatInviteLink(
    chat_id=message.chat.id,
    name="VIP Access",
    member_limit=50,
    creates_join_request=True
)

editChatInviteLink

Edits a non-primary invite link created by the bot.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`invite_link`	String	Yes	The invite link to edit.
`name`	String	No	New label.
`expire_date`	Integer	No	New expiry UNIX timestamp.
`member_limit`	Integer	No	New member limit.
`creates_join_request`	Boolean	No	Toggle join request mode.

BLP Example

Bot.editChatInviteLink(
    chat_id=message.chat.id,
    invite_link="https://t.me/joinchat/XXXX",
    name="Updated VIP Link",
    member_limit=100
)

revokeChatInviteLink

Revokes an invite link. Users who already joined via this link stay in the chat.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`invite_link`	String	Yes	The invite link to revoke.

BLP Example

Bot.revokeChatInviteLink(
    chat_id=message.chat.id,
    invite_link="https://t.me/joinchat/XXXX"
)

createChatSubscriptionInviteLink

Creates a subscription invite link for a channel. Users joining via this link will need to pay for the subscription.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`subscription_period`	Integer	Yes	The number of seconds the subscription will be active for before the next payment.
`subscription_price`	Integer	Yes	The amount of Telegram Stars a user must pay initially and after each subsequent period.
`name`	String	No	Link label.

BLP Example

Bot.createChatSubscriptionInviteLink(
    chat_id=message.chat.id,
    subscription_period=2592000, # 30 days
    subscription_price=100
)

editChatSubscriptionInviteLink

Edits a subscription invite link.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`invite_link`	String	Yes	The invite link to edit.
`name`	String	No	New label.

BLP Example

Bot.editChatSubscriptionInviteLink(
    chat_id=message.chat.id,
    invite_link="https://t.me/joinchat/XXXX",
    name="Updated Subscription Name"
)

approveChatJoinRequest

Approves a pending join request.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`user_id`	Integer	Yes	User ID to approve.

BLP Example

Bot.approveChatJoinRequest(
    chat_id=message.chat.id,
    user_id=message.from.id
)

declineChatJoinRequest

Declines a pending join request.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`user_id`	Integer	Yes	User ID to decline.

BLP Example

Bot.declineChatJoinRequest(
    chat_id=message.chat.id,
    user_id=message.from.id
)

answerChatJoinRequestQuery

Use this method to respond to a join request query.

Parameter	Type	Required	Description
`query_id`	String	Yes	Unique identifier for the query to be answered.

setChatPhoto

Sets a new profile photo for the chat.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`photo`	String	Yes	File ID or URL of the new photo.

BLP Example

Bot.setChatPhoto(
    chat_id=message.chat.id,
    photo="AgACAgIAAxkBAAMrZN..."
)

deleteChatPhoto

Deletes the chat’s current profile photo.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.

BLP Example

Bot.deleteChatPhoto(chat_id=message.chat.id)

setChatTitle

Changes the title of a group or channel.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`title`	String	Yes	New chat title (1–255 characters).

BLP Example

Bot.setChatTitle(
    chat_id=message.chat.id,
    title="My Awesome Community"
)

setChatDescription

Changes the description of a group, supergroup, or channel.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`description`	String	No	New description (up to 255 characters). Pass empty string to clear.

BLP Example

Bot.setChatDescription(
    chat_id=message.chat.id,
    description="The best community on Telegram!"
)

pinChatMessage

Pins a message in the chat.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`message_id`	Integer	Yes	ID of the message to pin.
`disable_notification`	Boolean	No	If `True`, does not send a notification.

BLP Example

Bot.pinChatMessage(
    chat_id=message.chat.id,
    message_id=message.reply_to_message.message_id,
    disable_notification=True
)

unpinChatMessage

Unpins a specific pinned message.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`message_id`	Integer	No	ID of the message to unpin. If omitted, unpins the most recent pin.

BLP Example

Bot.unpinChatMessage(
    chat_id=message.chat.id,
    message_id=message.reply_to_message.message_id
)

unpinAllChatMessages

Clears all pinned messages in the chat.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.

BLP Example

Bot.unpinAllChatMessages(chat_id=message.chat.id)

leaveChat

Makes the bot leave a group, supergroup, or channel.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID to leave.

BLP Example

Bot.leaveChat(chat_id=message.chat.id)

Chat Information

getChat

Gets full up-to-date information about a chat.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID or `@username`.

Returns: A Chat object with fields like id, type, title, username, description, invite_link, member_count, etc.

BLP Example

result = Bot.getChat(chat_id=message.chat.id)
chat = result.result
Bot.sendMessage(
    chat_id=u,
    text=f"Chat: {chat.title}\nType: {chat.type}\nMembers: {chat.member_count}"
)

getChatAdministrators

Gets the list of all admins in a chat.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.

BLP Example

result = Bot.getChatAdministrators(chat_id=message.chat.id)
admins = result.result
for admin in admins:
    Bot.sendMessage(chat_id=u, text=f"Admin: {admin.user.first_name}")

getChatMemberCount

Gets the total number of members in a chat.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.

BLP Example

result = Bot.getChatMemberCount(chat_id=message.chat.id)
Bot.sendMessage(chat_id=u, text=f"Total members: {result.result}")

getChatMember

Gets information about a specific member of a chat.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`user_id`	Integer	Yes	Telegram user ID.

Returns: A ChatMember object. The status field can be: creator, administrator, member, restricted, left, or kicked.

BLP Example

result = Bot.getChatMember(
    chat_id=message.chat.id,
    user_id=u
)
member = result.result
Bot.sendMessage(
    chat_id=u,
    text=f"Status: {member.status}"
)

# Check if user is admin
if member.status in ["administrator", "creator"]:
    Bot.sendMessage(chat_id=u, text="You are an admin!")

Forums and Topics

createForumTopic

Creates a topic in a forum supergroup chat. The bot must be an administrator.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`name`	String	Yes	Topic name (1-128 characters).
`icon_color`	Integer	No	Color of the topic icon in RGB format.
`icon_custom_emoji_id`	String	No	Unique identifier of the custom emoji shown as the topic icon.

BLP Example

Bot.createForumTopic(chat_id=message.chat.id, name="Announcements")

editForumTopic

Edits name and icon of a topic in a forum supergroup chat.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`message_thread_id`	Integer	Yes	Unique identifier for the target message thread of the forum topic.
`name`	String	No	New topic name.
`icon_custom_emoji_id`	String	No	New unique identifier of the custom emoji shown as the topic icon.

closeForumTopic

Closes an open topic in a forum supergroup chat.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`message_thread_id`	Integer	Yes	Unique identifier for the target message thread.

reopenForumTopic

Reopens a closed topic in a forum supergroup chat.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`message_thread_id`	Integer	Yes	Unique identifier for the target message thread.

deleteForumTopic

Deletes a forum topic along with all its messages.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`message_thread_id`	Integer	Yes	Unique identifier for the target message thread.

unpinAllForumTopicMessages

Clears the list of pinned messages in a forum topic.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`message_thread_id`	Integer	Yes	Unique identifier for the target message thread.

editGeneralForumTopic

Edits the name of the ‘General’ topic in a forum supergroup chat.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`name`	String	Yes	New topic name (1-128 characters).

closeGeneralForumTopic

Closes the ‘General’ topic in a forum supergroup chat.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.

reopenGeneralForumTopic

Reopens a closed ‘General’ topic in a forum supergroup chat.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.

hideGeneralForumTopic

Hides the ‘General’ topic in a forum supergroup chat.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.

unhideGeneralForumTopic

Unhides the ‘General’ topic in a forum supergroup chat.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.

unpinAllGeneralForumTopicMessages

Clears the list of pinned messages in the ‘General’ topic.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.

User Metadata

getUserProfilePhotos

Gets a list of profile pictures for a user.

Parameter	Type	Required	Description
`user_id`	Integer	Yes	Telegram user ID.
`offset`	Integer	No	Sequential number of the first photo to be returned.
`limit`	Integer	No	Limits the number of photos to be retrieved (1-100). Defaults to 100.

BLP Example

photos = Bot.getUserProfilePhotos(user_id=u)
Bot.sendMessage(chat_id=u, text=f"You have {photos.result.total_count} profile photos.")

getUserProfileAudios

Gets the user’s audio profile info (if available via API limitations).

Parameter	Type	Required	Description
`user_id`	Integer	Yes	Telegram user ID.

getUserPersonalChatMessages

Used to access personal chat messages based on specific Telegram client settings.

getUserChatBoosts

Gets the list of boosts added to a chat by a user.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`user_id`	Integer	Yes	Telegram user ID.

Verification & Chat Properties

verifyChat

Verifies a chat on behalf of the organization which is represented by the bot.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`custom_description`	String	No	Custom description for the verification (0-70 characters).

verifyUser

Verifies a user on behalf of the organization which is represented by the bot.

Parameter	Type	Required	Description
`user_id`	Integer	Yes	Target user ID.
`custom_description`	String	No	Custom description for the verification (0-70 characters).

removeChatVerification

Removes verification from a chat that was verified by the bot.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.

removeUserVerification

Removes verification from a user that was verified by the bot.

Parameter	Type	Required	Description
`user_id`	Integer	Yes	Target user ID.

setChatStickerSet

Sets a new group sticker set for a supergroup.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`sticker_set_name`	String	Yes	Name of the sticker set to be set as the group sticker set.

deleteChatStickerSet

Deletes the group sticker set from a supergroup.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.

getChatMenuButton

Gets the current value of the bot’s menu button in a private chat, or the default menu button.

Parameter	Type	Required	Description
`chat_id`	Integer	No	Target private chat ID.

setChatMenuButton

Changes the bot’s menu button in a private chat, or the default menu button.

Parameter	Type	Required	Description
`chat_id`	Integer	No	Target private chat ID.
`menu_button`	Object	No	A JSON-serialized object for the bot’s new menu button.

setMyDefaultAdministratorRights

Changes the default administrator rights requested by the bot when it’s added as an administrator to groups or channels.

Parameter	Type	Required	Description
`rights`	Object	No	A JSON-serialized object describing new default administrator rights.
`for_channels`	Boolean	No	Pass `True` to change the default administrator rights in channels.

getMyDefaultAdministratorRights

Gets the current default administrator rights of the bot.

Parameter	Type	Required	Description
`for_channels`	Boolean	No	Pass `True` to get default administrator rights of the bot in channels.

setChatMemberTag

Sets a custom title tag for a specific chat member.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`user_id`	Integer	Yes	User ID.
`tag`	String	Yes	The tag to apply.

setUserEmojiStatus

Changes the emoji status for a given user that previously allowed the bot to manage their emoji status via the Mini App method requestEmojiStatusAccess.

Parameter	Type	Required	Description
`user_id`	Integer	Yes	Unique identifier of the target user.
`emoji_status_custom_emoji_id`	String	No	Custom emoji identifier of the emoji status to set. Pass an empty string to remove the status.
`emoji_status_expiration_date`	Integer	No	Expiration date of the emoji status, if any.

BLP Example

Bot.setUserEmojiStatus(
    user_id=u,
    emoji_status_custom_emoji_id="CUSTOM_EMOJI_ID"
)

​Member Management

​banChatMember

​unbanChatMember

​restrictChatMember

​promoteChatMember

​setChatAdministratorCustomTitle

​banChatSenderChat

​unbanChatSenderChat

​Chat Management

​setChatPermissions

​exportChatInviteLink

​createChatInviteLink

​editChatInviteLink

​revokeChatInviteLink

​createChatSubscriptionInviteLink

​editChatSubscriptionInviteLink

​approveChatJoinRequest

​declineChatJoinRequest

​answerChatJoinRequestQuery

​setChatPhoto

​deleteChatPhoto

​setChatTitle

​setChatDescription

​pinChatMessage

​unpinChatMessage

​unpinAllChatMessages

​leaveChat

​Chat Information

​getChat

​getChatAdministrators

​getChatMemberCount

​getChatMember

​Forums and Topics

​createForumTopic

​editForumTopic

​closeForumTopic

​reopenForumTopic

​deleteForumTopic

​unpinAllForumTopicMessages

​editGeneralForumTopic

​closeGeneralForumTopic

​reopenGeneralForumTopic

​hideGeneralForumTopic

​unhideGeneralForumTopic

​unpinAllGeneralForumTopicMessages

​User Metadata

​getUserProfilePhotos

​getUserProfileAudios

​getUserPersonalChatMessages

​getUserChatBoosts

​Verification & Chat Properties

​verifyChat

​verifyUser

​removeChatVerification

​removeUserVerification

​setChatStickerSet

​deleteChatStickerSet

​getChatMenuButton

​setChatMenuButton

​setMyDefaultAdministratorRights

​getMyDefaultAdministratorRights

​setChatMemberTag

​setUserEmojiStatus

Member Management

banChatMember

unbanChatMember

restrictChatMember

promoteChatMember

setChatAdministratorCustomTitle

banChatSenderChat

unbanChatSenderChat

Chat Management

setChatPermissions

exportChatInviteLink

createChatInviteLink

editChatInviteLink

revokeChatInviteLink

createChatSubscriptionInviteLink

editChatSubscriptionInviteLink

approveChatJoinRequest

declineChatJoinRequest

answerChatJoinRequestQuery

setChatPhoto

deleteChatPhoto

setChatTitle

setChatDescription

pinChatMessage

unpinChatMessage

unpinAllChatMessages

leaveChat

Chat Information

getChat

getChatAdministrators

getChatMemberCount

getChatMember

Forums and Topics

createForumTopic

editForumTopic

closeForumTopic

reopenForumTopic

deleteForumTopic

unpinAllForumTopicMessages

editGeneralForumTopic

closeGeneralForumTopic

reopenGeneralForumTopic

hideGeneralForumTopic

unhideGeneralForumTopic

unpinAllGeneralForumTopicMessages

User Metadata

getUserProfilePhotos

getUserProfileAudios

getUserPersonalChatMessages

getUserChatBoosts

Verification & Chat Properties

verifyChat

verifyUser

removeChatVerification

removeUserVerification

setChatStickerSet

deleteChatStickerSet

getChatMenuButton

setChatMenuButton

setMyDefaultAdministratorRights

getMyDefaultAdministratorRights

setChatMemberTag

setUserEmojiStatus