Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/TelegramOrg/Telegram-web-k/llms.txt

Use this file to discover all available pages before exploring further.

Telegram Web K supports the full range of Telegram’s calling features that are technically feasible in a browser environment: encrypted one-on-one voice and video calls, group voice chats with video and screen sharing, scheduled group calls, and RTMP live-stream viewing. Private calls are managed by appCallsManager; group calls and voice chats are handled by appGroupCallsManager.
Live location sharing (GPS sending) is not available on the web platform. You can view shared locations from other users, but Web K cannot transmit your device position.

​
Starting a one-on-one call

1

Open a private chat

Navigate to any private chat with the person you want to call.
2

Open the call menu

Click the phone icon in the chat topbar to start a voice call, or click the dropdown arrow next to it to choose Video call instead.
3

Allow browser permissions

Your browser will prompt for microphone access (and camera access for video calls). Grant permission to proceed. If you accidentally deny it, update the permission in your browser’s site settings for web.telegram.org.
4

Wait for the other party to answer

The call screen displays the recipient’s name and avatar while ringing. You can switch between voice and video, mute yourself, or end the call from the in-call controls.

​
One-on-one call features

FeatureStatus
Voice calls (P2P encrypted)Supported
Video callsSupported
Switch camera during callSupported
Mute / unmuteSupported
Call privacy settingsSupported
P2P call privacy (route through Telegram servers)Supported
Call settings panelNot yet available
Call privacy settings let you control who can call you (everyone, contacts only, or nobody) and whether peer-to-peer connections are allowed. Configure these in Settings → Privacy & Security → Calls.

​
Group voice chats

Group voice chats (also called Voice Chats) are available in any group or channel. They appear in the chat as a pinned banner when active, and service messages mark when a group call started or ended.

​
Joining a group call

1

Find an active voice chat

An active voice chat shows a banner at the top of the group chat. Click Join to enter.
2

Choose your audio device

Select the microphone you want to use from the device selector in the call panel.
3

Interact with participants

The participant list shows who is speaking (indicated by a pulsing ring). Admins can mute individual participants or mute all.

​
Group call features

FeatureStatus
Group voice chatsSupported
Group video (camera sharing)Supported
Screen sharingSupported (see browser notes below)
Participant mute / volume controlSupported
Scheduling a group callSupported
Group call settings panelNot yet available

​
Participant management

Admins can:
  • Mute or unmute individual participants.
  • Adjust per-participant volume.
  • Remove participants from the call.
  • Toggle hand-raise requests.

​
Screen sharing

Screen sharing uses the browser’s getDisplayMedia API. Availability depends on the browser and operating system: 
// src/environment/screenSharingSupport.ts
const IS_SCREEN_SHARING_SUPPORTED =
  !!('getDisplayMedia' in (navigator?.mediaDevices || {}));
BrowserScreen sharing support
Chrome / Edge (desktop)Full — window, tab, or entire screen
Firefox (desktop)Full — window or entire screen
SafariLimited — entire screen only on macOS 13+
Mobile browsersNot supported
When you click Share Screen in a group call, the browser presents a native picker to choose what to share. Other participants see your screen as a video feed in the call.

​
RTMP live streams

Channels and groups can broadcast via RTMP (for example, using OBS or a hardware encoder). Web K includes a dedicated live-stream viewer:
  • A LIVE badge appears in the topbar of the channel while a stream is active.
  • Clicking the badge opens the RTMP media viewer (appMediaViewerRtmp), which plays the HLS stream in fullscreen.
  • Admins see additional controls to start recording, stop the stream, or select the output audio device.
  • Recording of the stream can be initiated by an admin directly from the viewer.
RTMP live-stream links can be distributed to viewers who do not need to be members of the channel, making public broadcasts straightforward.

​
Browser compatibility notes

Web K calls depend on WebRTC, which is well-supported across modern browsers, but there are some caveats:
WebRTC is supported on Safari 15+ (macOS and iOS). However, screen sharing is unavailable on iOS Safari due to platform restrictions. Group calls work, but video quality may differ from Chromium-based browsers.
Full WebRTC support including screen sharing. Note that Firefox does not support tab-only capture in getDisplayMedia — you must share a window or the entire screen.
Best overall experience. Supports window, tab, and full-screen capture for screen sharing. Tab sharing transmits the tab’s audio automatically if you check the option in the browser picker.
One-on-one voice and video calls work on mobile browsers that support WebRTC. Screen sharing and group call video are generally unavailable on mobile due to getDisplayMedia not being exposed to web pages on iOS and Android.

​
What is not supported

The following call-related features are not yet available in Web K:
  • Conference calls (multi-party calls with a shareable link) — requires appCallsManager extensions not yet implemented.
  • P2P to conference escalation — upgrading a private call to a conference.
  • Shareable call links for one-on-one calls.
  • Call settings panel (ringtone selection, audio device persistence) for private calls.

Build docs developers (and LLMs) love

Get started for freeTalk to us