> ## Documentation Index > Fetch the complete documentation index at: https://help.bots.lt/llms.txt > Use this file to discover all available pages before exploring further. # Chats & Members > Manage groups, channels, members, permissions, and chat information. 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. | ```python BLP Example theme={null} # 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). | ```python BLP Example theme={null} 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) | ```python BLP Example theme={null} # 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. | ```python BLP Example theme={null} # 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. | ```python BLP Example theme={null} 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. | ```python BLP Example theme={null} 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. | ```python BLP Example theme={null} 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. | ```python BLP Example theme={null} # 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. | ```python BLP Example theme={null} 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. | ```python BLP Example theme={null} 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. | ```python BLP Example theme={null} 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. | ```python BLP Example theme={null} 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. | ```python BLP Example theme={null} 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. | ```python BLP Example theme={null} 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. | ```python BLP Example theme={null} 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. | ```python BLP Example theme={null} 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. | ```python BLP Example theme={null} 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. | ```python BLP Example theme={null} 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). | ```python BLP Example theme={null} 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. | ```python BLP Example theme={null} 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. | ```python BLP Example theme={null} 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. | ```python BLP Example theme={null} 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. | ```python BLP Example theme={null} 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. | ```python BLP Example theme={null} 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. ```python BLP Example theme={null} 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. | ```python BLP Example theme={null} 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. | ```python BLP Example theme={null} 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`. ```python BLP Example theme={null} 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. | ```python BLP Example theme={null} 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. | ```python BLP Example theme={null} 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 equestEmojiStatusAccess.