decline_call()

async Client.decline_call()

Decline, reject, or hang up a 1-on-1 private phone call.

Usable by Users Bots
Parameters:
  • call_id (int) – The unique phone call ID.

  • access_hash (int) – The access hash of the phone call.

  • duration (int, optional) – Total call duration in seconds. Defaults to 0.

  • reason (PhoneCallDiscardReason, optional) – Why the call was declined or ended. Defaults to PhoneCallDiscardReasonHangup.

  • connection_id (int, optional) – Preferred relay connection ID. Defaults to 0.

  • video (bool, optional) – Whether this was a video call.

Returns:

Updates – Updates resulting from declining the call.

Example

# Decline / Hang up a call
await app.decline_call(call_id=123, access_hash=456, duration=15)