create_video_chat()

Client.create_video_chat()

Creates a video chat (a group call bound to a chat).

Available only for basic groups, supergroups and channels; requires can_manage_video_chats administrator right.

Usable by ✅ Users ❌ Bots

Parameters:

• chat_id (int | str) – Unique identifier (int) or username (str) of the target chat in which the video chat will be created. A chat can be either a basic group, supergroup or a channel.

• title (str, optional) – Group call title; if empty, chat title will be used.

• start_date (datetime, optional) – Point in time (Unix timestamp) when the group call is supposed to be started by an administrator; 0 to start the video chat immediately. The date must be at least 10 seconds and at most 8 days in the future.

• is_rtmp_stream (bool, optional) – Pass true to create an RTMP stream instead of an ordinary video chat; requires owner privileges.

Returns:

Message – On success, the sent service message is returned.

Example

await app.create_video_chat(chat_id)