ban_chat_member
Ban a user from a Telegram chat with optional time limit and message deletion. Supports default log group or specific chat.
Instructions
Ban a user from a chat. If chat_id is omitted, targets the default log group.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"user_id": "<user_id>"
},
"name": "ban_chat_member"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chat_id | No | Chat ID or @channel_username. Optional — defaults to log group | |
| user_id | Yes | User ID to ban | |
| until_date | No | Unix timestamp when the ban will be lifted. 0 or omitted = forever | |
| revoke_messages | No | Delete all messages from the banned user |