telegram api method · layer 229 · #8b89dfbd

bots.setCustomVerification

usable by users and bots

Verify a user or chat on behalf of an organization ».

definition

bots.setCustomVerification#8b89dfbd flags:# enabled:flags.1?true bot:flags.0?InputUser peer:InputPeer custom_description:flags.2?string = Bool;

parameters

nametypedescription
flags#Flags, see TL conditional fields
enabledflags.1?trueIf set, adds the verification; otherwise removes verification.
botflags.0?InputUserMust not be set if invoked by a bot, must be set to the ID of an owned bot if invoked by a user.
peerInputPeerThe peer to verify
custom_descriptionflags.2?stringCustom 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.

returns

Bool

errors (5)

codeerrordescription
400BOT_INVALIDThis is not a valid bot.
400BUSINESS_CONNECTION_NOT_ALLOWEDThis method was invoked over a business connection using invokeWithBusinessConnection, but either (1) we're a user, and users cannot invoke methods over a business connection; (2) we're a bot, but business mode was disabled in @botfather or (3); we're a bot, but this method cannot be invoked over a business connection.
400PEER_ID_INVALIDThe provided peer id is invalid.
401AUTH_KEY_UNREGISTEREDThe specified authorization key is not registered in the system (for example, a PFS temporary key has expired).
403BOT_VERIFIER_FORBIDDENThis bot cannot assign verification icons.

history

present in layers 196–229

idlayers
#8b89dfbd196–229