telegram api method · layer 229 · #42ff96ed

phone.requestCall

usable by users

Start a telegram phone call

definition

phone.requestCall#42ff96ed flags:# video:flags.0?true user_id:InputUser random_id:int g_a_hash:bytes protocol:PhoneCallProtocol = phone.PhoneCall;

name	type	description
`flags`	#	Flags, see TL conditional fields
`video`	flags.0?true	Whether to start a video call
`user_id`	InputUser	Destination of the phone call
`random_id`	int	Random ID to avoid resending the same object
`g_a_hash`	bytes	Parameter for E2E encryption key exchange »
`protocol`	PhoneCallProtocol	Phone call settings

code	error	description
400	BUSINESS_CONNECTION_NOT_ALLOWED	This 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.
400	CALL_PROTOCOL_FLAGS_INVALID	Call protocol flags invalid.
400	CALL_PROTOCOL_LAYER_INVALID	The specified protocol layer version range is invalid.
400	INPUT_USER_DEACTIVATED	The specified user was deleted.
400	PARTICIPANT_VERSION_OUTDATED	The other participant does not use an up to date telegram client with support for calls.
400	USER_ID_INVALID	The provided user ID is invalid.
400	USER_IS_BLOCKED	You were blocked by this user.
401	AUTH_KEY_UNREGISTERED	The specified authorization key is not registered in the system (for example, a PFS temporary key has expired).
403	USER_IS_BLOCKED	You were blocked by this user.
403	USER_PRIVACY_RESTRICTED	The user's privacy settings do not allow you to do this.
500	RANDOM_ID_DUPLICATE	You provided a random ID that was already used.

present in layers 62–229 · constructor id changed 3×