Для AI-агентов: markdown этой страницы — /docs/mcp-tool-update-bot-profile.mdиндекс документации — /llms.txt
update_bot_profile
Обновлено
Change the public profile of the business's own Telegram bot (partial: send only what changes). `name` 1-64 characters, `about` up to 120 (the short line in the bot profile), `description` up to 512 (the «What can this bot do?» block); an empty `about` or `description` clears it. `languageCode` (`ru`, `en`, `default`) picks the localization to write; omitted = the business language; `default` is the text for everyone with no dedicated one, so write it too if the audience is mixed. The profile photo: `profilePhotoMediaRef` (a JPEG or PNG, or an MP4 for an animated photo, up to 10 MB, uploaded with media_request_upload and finalized with media_finalize) or `removeProfilePhoto: true`. The start-screen picture or GIF has no Bot API method: passing `startScreenMediaRef` changes nothing and returns it in `refused` with the @BotFather instruction. Telegram limits how often a name can change; if it refuses a field, the error names it and the fields already changed. Returns `botUsername`, `applied` and the profile read back from Telegram; if the read-back fails, `profileReadFailed: true` and `profile: null` — the writes in `applied` still landed, call `get_bot_profile` to see the result. `BOT_TOKEN_REVOKED` means the bot's token was revoked: connect the bot again.
Права и условия
required_scopes: ALL.
| Поле | Значение |
|---|---|
| description | "Change the public profile of the business's own Telegram bot (partial: send only what changes). `name` 1-64 characters, `about` up to 120 (the short line in the bot profile), `description` up to 512 (the «What can this bot do?» block); an empty `about` or `description` clears it. `languageCode` (`ru`, `en`, `default`) picks the localization to write; omitted = the business language; `default` is the text for everyone with no dedicated one, so write it too if the audience is mixed. The profile photo: `profilePhotoMediaRef` (a JPEG or PNG, or an MP4 for an animated photo, up to 10 MB, uploaded with media_request_upload and finalized with media_finalize) or `removeProfilePhoto: true`. The start-screen picture or GIF has no Bot API method: passing `startScreenMediaRef` changes nothing and returns it in `refused` with the @BotFather instruction. Telegram limits how often a name can change; if it refuses a field, the error names it and the fields already changed. Returns `botUsername`, `applied` and the profile read back from Telegram; if the read-back fails, `profileReadFailed: true` and `profile: null` — the writes in `applied` still landed, call `get_bot_profile` to see the result. `BOT_TOKEN_REVOKED` means the bot's token was revoked: connect the bot again." |
| domain | "client-config" |
| name | "update_bot_profile" |
| platform_version | "1.0.24" |
| required_scopes | ["client-config:write"] |
| risk | "write" |
| scope | "client-config:write" |
| title | "Update Bot Profile" |
Входные параметры
update_bot_profile: inputSchema
Результат
null