telegram api method · layer 229 · #8fb53057
phone.joinGroupCall
Join a group call
definition
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 |
|---|---|---|
flags | # | Flags, see TL conditional fields |
muted | true | If set, the user will be muted by default upon joining. |
video_stopped | true | If set, the user's video will be disabled by default upon joining. |
call | InputGroupCall | The group call |
join_as | InputPeer | Join the group call, presenting yourself as the specified user/channel |
invite_hash | string | The invitation hash from the invite link », if provided allows speaking in a livestream or muted group chat. |
public_key | int256 | For conference calls, your public key. |
block | bytes | The block containing an appropriate e2e.chain.changeSetGroupState event. |
params | DataJSON | WebRTC parameters |
returns
errors (10)
| code | error | description |
|---|---|---|
| 400 | BUSINESS_CONNECTION_NOT_ALLOWED | This method was invoked over a business connection using invokeWithBusinessConnection, but either (1) we're a user, and users cannot invoke methods over a business connection; (2) we're a bot, but business mode was disabled in @botfather or (3); we're a bot, but this method cannot be invoked over a business connection. |
| 400 | CHAT_ADMIN_REQUIRED | You must be an admin in this chat to do this. |
| 400 | DATA_JSON_INVALID | The provided JSON data is invalid. |
| 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 e2e public key is invalid. |
| 401 | AUTH_KEY_UNREGISTERED | The specified authorization key is not registered in the system (for example, a PFS temporary key has expired). |
| 403 | CHAT_WRITE_FORBIDDEN | You can't write in this chat. |
| 403 | GROUPCALL_FORBIDDEN | The specified group call cannot be used in this context. |
history
present in layers 122–229 · constructor id changed 3×
| id | layers |
|---|---|
| #5f9c8e62 | 122–124 |
| #b132ff7b | 125–195 |
| #d61e1df3 | 196–201 |
| #8fb53057 | 202–229 |