Set a custom wallpaper » in a specific private chat with another user.
Method schema is available as of layer 167. Switch »
| Name | Type | Description |
|---|---|---|
| flags | # | Flags, see TL conditional fields |
| for_both | flags.3?true | Only for Premium users, sets the specified wallpaper for both users of the chat, without requiring confirmation from the other user. |
| revert | flags.4?true | If we don't like the new wallpaper the other user of the chat has chosen for us using the for_both flag, we can re-set our previous wallpaper just on our side using this flag. |
| peer | InputPeer | The private chat where the wallpaper will be set |
| wallpaper | flags.0?InputWallPaper | The wallpaper », obtained as described in the wallpaper documentation »; must not be provided when installing a wallpaper obtained from a messageActionSetChatWallPaper service message (id must be provided, instead). |
| settings | flags.2?WallPaperSettings | Wallpaper settings, obtained as described in the wallpaper documentation » or from messageActionSetChatWallPaper.wallpaper.settings. |
| id | flags.1?int | If the wallpaper was obtained from a messageActionSetChatWallPaper service message, must contain the ID of that message. |
| Code | Type | Description |
|---|---|---|
| 400 | PEER_ID_INVALID | The provided peer id is invalid. |
| 400 | WALLPAPER_INVALID | The specified wallpaper is invalid. |
| 400 | WALLPAPER_NOT_FOUND | The specified wallpaper could not be found. |
Telegram Premium is an optional subscription service that unlocks additional exclusive client-side and API-side features, while helping support the development of the app.
Telegram apps support generating, sharing and synchronizing chat backgrounds.
The wallpaper » of the current chat was changed.