Verify a user or chat on behalf of an organization ».
Method schema is available as of layer 196. Switch »
| Name | Type | Description |
|---|---|---|
| flags | # | Flags, see TL conditional fields |
| enabled | flags.1?true | If set, adds the verification; otherwise removes verification. |
| bot | flags.0?InputUser | Must not be set if invoked by a bot, must be set to the ID of an owned bot if invoked by a user. |
| peer | InputPeer | The peer to verify |
| custom_description | flags.2?string | Custom description for the verification, the UTF-8 length limit for this field is contained in bot_verification_description_length_limit ». If not set, Was verified by organization "organization_name" will be used as description. |
| Code | Type | Description |
|---|---|---|
| 400 | BOT_INVALID | This is not a valid bot. |
| 403 | BOT_VERIFIER_FORBIDDEN | This bot cannot assign verification icons. |
| 400 | PEER_ID_INVALID | The provided peer id is invalid. |
The MTProto API has multiple configuration parameters that can be fetched with the appropriate methods.
To further improve transparency on Telegram, official third-party services are able to assign extra verification icons to user accounts and chats — in order to prevent scams and reduce misinformation.