Actions101
- Bot Actions
- Chat Actions
- Get Chat
- Get Chat Administrators
- Get Chat Member Count
- Get Chat Member
- Ban Chat Member
- Unban Chat Member
- Restrict Chat Member
- Promote Chat Member
- Set Chat Administrator Custom Title
- Set Chat Permissions
- Export Chat Invite Link
- Create Chat Invite Link
- Edit Chat Invite Link
- Revoke Chat Invite Link
- Approve Chat Join Request
- Decline Chat Join Request
- Set Chat Photo
- Delete Chat Photo
- Set Chat Title
- Set Chat Description
- Pin Chat Message
- Unpin Chat Message
- Unpin All Chat Messages
- Leave Chat
- Set Chat Menu Button
- Get Chat Menu Button
- Set Chat Sticker Set
- Delete Chat Sticker Set
- File Actions
- Forum Actions
- Game Actions
- Inline Actions
- Message Actions
- Send Message
- Forward Message
- Copy Message
- Send Photo
- Send Audio
- Send Document
- Send Video
- Send Animation
- Send Voice
- Send Video Note
- Send Media Group
- Send Location
- Send Venue
- Send Contact
- Send Poll
- Send Dice
- Send Chat Action
- Edit Message Text
- Edit Message Caption
- Edit Message Media
- Edit Message Reply Markup
- Edit Message Live Location
- Stop Message Live Location
- Stop Poll
- Delete Message
- Delete Messages
- Payment Actions
- Sticker Actions
- Update Actions
- Webhook Actions
Chat → Ban Chat Member
AI-generatedSummary
Ban a chat member
Inputs
- chat_id (required) — Unique identifier for the target chat or username (e.g., @channelusername)
- user_id (required) — Unique identifier of the user to ban
- banAdditionalFields — Optional fields specific to ban: until_date (Unix timestamp) and revoke_messages (boolean)
Output shape
Telegram API response object
On success the response contains ok:true and result with ban details; errors propagate as exceptions. The shape is unchanged from the raw Telegram API response.
Examples
Example 1: Ban a user from a group chat
chat_id = '@mygroup', user_id = 123456789, banAdditionalFields = { until_date: 0, revoke_messages: true }