Bot identity (yekar.telegram.get-me) | Read | The connected bot's identity - username, id, and whether it can read all group messages (false means privacy mode hides ordinary group messages from it; disable via @BotFather /setprivacy). |
Get chat (yekar.telegram.get-chat) | Read | A chat's details - id, type (private/group/supergroup/channel), title, @username and description. Works for any chat the bot is a member of. |
List chat admins (yekar.telegram.list-chat-administrators) | Read | The administrators of a group or channel (owners show as 'creator'). Useful before moderation calls - bans need the bot itself to be an admin. |
Read recent messages (yekar.telegram.get-updates) | Read | Recent messages the bot can see, newest window of its update queue - sender, chat, text and time; optionally filtered to one chat. Also the way to DISCOVER a chat's numeric id: have someone message the chat, then read. Limits: ~24h retention, nothing from before the bot joined, and privacy mode (default on) hides ordinary group messages. |
Send message (yekar.telegram.send-message) | Write | Send a text message to a chat, group or channel the bot is in. Supports HTML or MarkdownV2 formatting, replying to a message, and silent delivery. |
Send photo (yekar.telegram.send-photo) | Write | Send a photo to a chat by public URL (Telegram downloads it server-side, ≤5 MB), with an optional caption. |
Send document (yekar.telegram.send-document) | Write | Send a file to a chat by public URL (Telegram downloads it server-side, ≤20 MB), delivered as a document attachment with an optional caption. |
Edit message (yekar.telegram.edit-message) | Write | Replace the text of a message the BOT itself sent (bots cannot edit other senders' messages). Submitting identical text is rejected by Telegram as 'message is not modified'. |
Delete message (yekar.telegram.delete-message) | Write | Delete a message. Bots can always delete their own messages within 48 hours; deleting others' messages requires the bot to be an admin with delete permission. Deletion is permanent and unconfirmed - there is no undo. |
Pin message (yekar.telegram.pin-message) | Write | Pin a message in a chat. In groups and channels the bot must be an admin with the pin permission; in private chats it always works. |
Unpin message (yekar.telegram.unpin-message) | Write | Unpin a message (or, with no messageId, the most recently pinned one). Same admin requirements as pinning. |
Send poll (yekar.telegram.send-poll) | Write | Post a native Telegram poll to a chat - a question with 2–10 answer options, anonymous by default. |
Ban member (yekar.telegram.ban-chat-member) | Write | Ban a user from a group or channel - they are removed and cannot rejoin until unbanned. Requires the bot to be an admin with ban permission. Optionally deletes all their messages. |
Unban member (yekar.telegram.unban-chat-member) | Write | Lift a ban so the user can rejoin (they are NOT re-added automatically). Safe on non-banned users: only_if_banned is always set, so a member who was never banned is left untouched instead of being kicked. |