1# Telegram Bot API settings map
2 
3Use this reference when you need the exact Bot API surface for bot-facing profile/config changes.
4 
5## Covered by the bundled CLI
6 
7### Identity and public profile
8 
9- `getMe`
10- `getMyName` / `setMyName`
11- `getMyDescription` / `setMyDescription`
12- `getMyShortDescription` / `setMyShortDescription`
13- `setMyProfilePhoto` / `removeMyProfilePhoto`
14 
15Notes:
16- Localized name/description calls support `language_code`.
17- Static profile photos are uploaded as `InputProfilePhotoStatic` and are expected as `.jpg/.jpeg` by Bot API.
18- Animated profile photos use `InputProfilePhotoAnimated` with an MPEG4 file and optional `main_frame_timestamp`.
19- The bundled CLI auto-converts non-JPEG static images to JPEG when Pillow is available.
20 
21### Commands
22 
23- `getMyCommands`
24- `setMyCommands`
25- `deleteMyCommands`
26 
27Notes:
28- Commands can be scoped with `BotCommandScope` JSON.
29- Commands can also be localized with `language_code`.
30 
31Example commands JSON:
32 
33```json
34[
35  {"command": "start", "description": "Open the bot"},
36  {"command": "help", "description": "Show help"}
37]
38```
39 
40Example scope JSON:
41 
42```json
43{"type": "default"}
44```
45 
46### Menu button
47 
48- `getChatMenuButton`
49- `setChatMenuButton`
50 
51Common menu button payloads:
52 
53```json
54{"type": "default"}
55```
56 
57```json
58{"type": "commands"}
59```
60 
61```json
62{
63  "type": "web_app",
64  "text": "Open app",
65  "web_app": {"url": "https://example.com/app"}
66}
67```
68 
69Notes:
70- Without `chat_id`, the default menu button is changed.
71- With `chat_id`, the change applies to a specific private chat.
72 
73### Default admin rights
74 
75- `getMyDefaultAdministratorRights`
76- `setMyDefaultAdministratorRights`
77 
78Example rights JSON:
79 
80```json
81{
82  "can_manage_chat": true,
83  "can_delete_messages": true,
84  "can_invite_users": true,
85  "can_restrict_members": false,
86  "can_pin_messages": true,
87  "can_manage_topics": true
88}
89```
90 
91Notes:
92- Group/supergroup rights are the default branch.
93- Add `for_channels=true` for channel defaults.
94- Omitting `rights` clears the defaults.
95 
96## Use the raw escape hatch for future methods
97 
98The CLI includes a `raw` subcommand:
99 
100```bash
101python scripts/telegram_bot_settings.py raw METHOD --data '{...}'
102```
103 
104Use it when Telegram adds a new account-level setting before the wrapper gets updated.
105 
106## Things Bot API still does not cleanly cover for this skill
107 
108Treat these as out of scope unless Telegram adds/changes methods and you intentionally extend the script:
109 
110- bot token rotation
111- privacy mode / group visibility toggles
112- inline mode enable/disable
113- main username changes / username purchasing / Fragment flows
114- BotFather-only setup flows and owner-account settings
115 
116## Suggested change order
117 
1181. Run `status` first.
1192. Change one surface at a time.
1203. Re-read the specific getter after each change if the output matters.
1214. For bigger edits, save JSON payloads in files and pass them with `@file.json` instead of long inline shell strings.
122