request_call()

async Client.request_call()

Start a 1-on-1 private phone call.

Usable by Users Bots
Parameters:
  • user_id (int | str) – Target user ID or username to call.

  • g_a_hash (bytes) – Diffie-Hellman encryption hash for E2E voice call.

  • protocol (PhoneCallProtocol) – VoIP call protocol settings.

  • video (bool, optional) – Pass True to request a video call.

  • random_id (int, optional) – Unique random ID for deduplication. Defaults to a random integer.

Returns:

PhoneCall – The initiated phone call object.

Example

call = await app.request_call(user_id=12345678, g_a_hash=b"...", protocol=protocol)