phone.createGroupCall

Create a video chat or livestream, see here » for the full flow.

API section: Working with group calls »

phone.createGroupCall#48cdc6d8 flags:# rtmp_stream:flags.2?true peer:InputPeer random_id:int title:flags.0?string schedule_date:flags.1?int = Updates;

Parameters

NameTypeDescription
flags # Bit mask: a field written flags.N?T is present only when bit N is set.
rtmp_stream flags.2?true
peer InputPeer The user or chat the request is about.
random_id int A random number from the client. The server uses it to discard duplicates when a request goes out twice.
title flags.0?string Title.
schedule_date flags.1?int When to send, unix time. If set, the message goes out later.

Result

Updates

Possible errors

Read out of the handler itself — this is what the server actually returns for this method.

CodeTypeWhat it means
403 CHAT_ADMIN_REQUIRED This action requires chat admin rights.
400 PEER_ID_INVALID The peer or chat is invalid — or you have no access to it.

Common to every call

CodeTypeWhat it means
401 AUTH_KEY_UNREGISTERED The server does not know this session: the key was revoked, expired, or the call was made before authorisation.
401 API_ID_INVALID This api_id was never issued or has been blocked. Keys come from my.ansible.su.
400 CONNECTION_LAYER_INVALID The client did not declare a layer, or declared one the server does not know.
420 FLOOD_WAIT_X Too often. Do not retry for X seconds — the number arrives in the error text.
500 INTERNAL A failure on our side. The request may be retried; if it keeps failing, it is a bug of ours.

Related pages

Types used here