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 (:py:obj:`~datetime.datetime`, *optional*) – Point in time (Unix timestamp) when the group call is expected 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:

:obj:`~pyrogram.types.Message` (On success, the sent service message is returned.)

Example

await app.create_video_chat(chat_id)