Home › Methods › Phone › JoinGroupCall
Layer 227

PhoneJoinGroupCall

Join any group call type. Conference calls additionally require the E 2 E joining flow.

method Users
phone.joinGroupCall#8fb53057 flags:# muted:flags.0?true video_stopped:flags.2?true call:InputGroupCall join_as:InputPeer invite_hash:flags.1?string public_key:flags.3?int256 block:flags.3?bytes params:DataJSON = Updates;

Parameters

Name Type Description
Muted flags .0? true Join muted; required for live story listeners and RTMP-mode viewers
VideoStopped flags .2? true Join with video disabled; required for live story listeners and RTMP-mode viewers
Call InputGroupCall Group call to join
JoinAs InputPeer Join the group call, presenting yourself as the specified user/channel; this peer is also used as the author of in-call messages in normal video chats/livestreams. Only video chats/livestreams may use another peer; this field must be equal to input Peer Self when joining live stories or conference calls.
InviteHash flags .1? string The invitation hash from the invite link, if provided allows speaking in a livestream or muted group call ( video chats/livestreams only, cannot be used by live stories or conference calls ).
PublicKey flags .3? int256 For conference calls only, your public key.
Block flags .3? bytes The main-chain block that adds the joining user, only for conference calls.
Params DataJSON Join payload generated by the local tgcalls group-call engine, as described above

Returns

Updates

Gogram Example

// PhoneJoinGroupCall - using Params struct
result, err := client.PhoneJoinGroupCall(&tg.PhoneJoinGroupCallParams{
    Muted: nil,
    VideoStopped: nil,
    Call: &tg.InputGroupCall{},
    JoinAs: &tg.InputPeerUser{UserID: int64(777000)},
    InviteHash: "Hello, World!",
    PublicKey: nil,
    Block: nil,
    Params: &tg.DataJson{},
})
if err != nil {
    // handle error
}
// result is *tg.Updates

Possible Errors

Code Type Description
400 CHAT_ADMIN_REQUIRED You must be an admin in this chat to do this.
403 CHAT_WRITE_FORBIDDEN You can't write in this chat.
400 DATA_JSON_INVALID The provided JSON data is invalid.
500 GROUPCALL_ADD_PARTICIPANTS_FAILED
403 GROUPCALL_FORBIDDEN The group call has already ended.
400 GROUPCALL_INVALID The specified group call is invalid.
400 GROUPCALL_SSRC_DUPLICATE_MUCH The app needs to retry joining the group call with a new SSRC value.
400 JOIN_AS_PEER_INVALID The specified peer cannot be used to join a group call.
400 PUBLIC_KEY_INVALID The specified e 2 e public key is invalid.