start_group_call()

async Client.start_group_call()

Start or schedule a group voice chat or live stream in a chat.

Usable by Users Bots
Parameters:
  • chat_id (int | str) – Unique identifier (int) or username (str) of the target chat.

  • title (str, optional) – Title of the voice chat or live stream.

  • schedule_date (datetime | int, optional) – Schedule date for the group call. If provided, the call will be scheduled.

  • rtmp_stream (bool, optional) – Pass True if this group call will be an RTMP live stream (e.g. for OBS).

Returns:

Updates – On success, updates are returned.

Example

# Start an instant Voice Chat
await app.start_group_call(chat_id, title="Community Hangout")

# Start an RTMP Live Stream for OBS
await app.start_group_call(chat_id, title="Live Event", rtmp_stream=True)