banChatMember
Cấm thành viên chat.
Giá trị trả về: Nếu thành công, trả về True.
Tham số
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
chat_id | Integer or String | Có | ID chat |
user_id | Integer | Có | ID người dùng |
until_date | Integer | Tùy chọn | Mốc thời gian hết hạn cấm (0 = vĩnh viễn) |
revoke_messages | Boolean | Tùy chọn | Xóa tin nhắn của người dùng bị cấm |
Ví dụ request
curl
curl -s -X POST "https://api.telegram.org/bot$TOKEN/banChatMember" \
-H "Content-Type: application/json" \
-d '{"chat_id":123456789,"user_id":123456789}'
Python
import requests
TOKEN = "123456789:AAEexampleTokenReplaceWithYours"
resp = requests.post(
f"https://api.telegram.org/bot{TOKEN}/banChatMember",
json={
"chat_id": 123456789,
"user_id": 123456789
},
timeout=30,
)
print(resp.json())
JavaScript
const TOKEN = "123456789:AAEexampleTokenReplaceWithYours";
const res = await fetch(`https://api.telegram.org/bot${TOKEN}/banChatMember`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"chat_id": 123456789,
"user_id": 123456789
}),
});
console.log(await res.json());
Hướng dẫn từng bước: Cách tạo bot Telegram từ A đến Z: BotFather, token và tin nhắn đầu tiên
Phương thức liên quan
unbanChatMemberBỏ cấm thành viên chat.restrictChatMemberHạn chế thành viên chat.promoteChatMemberThăng cấp thành viên chat lên quản trị viên.setChatAdministratorCustomTitleĐặt chức danh tùy chỉnh cho quản trị viên.banChatSenderChatCấm một kênh trong nhóm/siêu nhóm.unbanChatSenderChatBỏ cấm một kênh trong nhóm/siêu nhóm.pinChatMessageGhim tin nhắn trong chat.unpinChatMessageBỏ ghim tin nhắn trong chat.unpinAllChatMessagesBỏ ghim tất cả tin nhắn trong chat.setChatMemberTagĐặt thẻ cho thành viên chat (Bot API 9.5).