# Method: phone.requestCall

Back to methods index

Start a telegram phone call

# Parameters:

Name Type Description Required
video Bool Whether to start a video call Optional
user_id Username, chat ID, Update, Message or InputUser Destination of the phone call Optional
g_a_hash bytes Parameter for E2E encryption key exchange » Yes
protocol PhoneCallProtocol Phone call settings Yes

# Return type: phone.PhoneCall

# Can bots use this method: NO

# MadelineProto Example (now async for huge speed and parallelism!):

if (!file_exists('madeline.php')) {
    copy('https://phar.madelineproto.xyz/madeline.php', 'madeline.php');
include 'madeline.php';

$MadelineProto = new \danog\MadelineProto\API('session.madeline');

$phone_PhoneCall = $MadelineProto->phone->requestCall(['video' => Bool, 'user_id' => InputUser, 'g_a_hash' => 'bytes', 'protocol' => PhoneCallProtocol, ]);

Or, if you’re into Lua:

phone_PhoneCall = phone.requestCall({video=Bool, user_id=InputUser, g_a_hash='bytes', protocol=PhoneCallProtocol, })

# Errors

Code Type Description
400 CALL_PROTOCOL_FLAGS_INVALID Call protocol flags invalid
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
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
This site uses cookies, as described in the cookie policy. By clicking on "Accept" you consent to the use of cookies.