GramJS

phone.JoinGroupCall

Join a group call

Example

const { Api, TelegramClient } = require("telegram");
const { StringSession } = require("telegram/sessions");

const session = new StringSession(""); // You should put your string session here
const client = new TelegramClient(session, apiId, apiHash, {});

(async function run() {
  await client.connect(); // This assumes you have already authenticated with .start()

  const result = await client.invoke(
    new Api.phone.JoinGroupCall({
      call: new Api.InputGroupCall({
        id: BigInt("-4156887774564"),
        accessHash: BigInt("-4156887774564"),
      }),
      joinAs: "username",
      params: new Api.DataJSON({
        data: "some string here",
      }),
      muted: true,
      videoStopped: true,
      inviteHash: "some string here",
    })
  );
  console.log(result); // prints the result
})();
import { Api, TelegramClient } from "telegram";
import { StringSession } from "telegram/sessions";

const session = new StringSession(""); // You should put your string session here
const client = new TelegramClient(session, apiId, apiHash, {});

(async function run() {
  await client.connect(); // This assumes you have already authenticated with .start()

  const result: Api.Updates = await client.invoke(
    new Api.phone.JoinGroupCall({
      call: new Api.InputGroupCall({
        id: BigInt("-4156887774564"),
        accessHash: BigInt("-4156887774564"),
      }),
      joinAs: "username",
      params: new Api.DataJSON({
        data: "some string here",
      }),
      muted: true,
      videoStopped: true,
      inviteHash: "some string here",
    })
  );
  console.log(result); // prints the result
})();

Parameters

NameTypeDescription
flags#Flags, see TL conditional fields
mutedflags.0?trueIf set, the user will be muted by default upon joining.
videoStoppedflags.2?trueIf set, the user's video will be disabled by default upon joining.
callInputGroupCallThe group call
joinAsInputPeerJoin the group call, presenting yourself as the specified user/channel
inviteHashflags.1?stringThe invitation hash from the invite link: https://t.me/username?voicechat=hash
paramsDataJSONWebRTC parameters

Result

Updates

Possible errors

CodeTypeDescription
400GROUPCALL_SSRC_DUPLICATE_MUCHThe app needs to retry joining the group call with a new SSRC value.

Can bots use this method?

No