Recording (Beta)

AI Integration Quick Reference

// Start recording
CometChatCalls.startRecording();

// Stop recording
CometChatCalls.stopRecording();

// Listen for recording events (in CallSettings)
const callListener = new CometChatCalls.OngoingCallListener({
  onRecordingStarted: (event) => console.log("Recording started", event.user),
  onRecordingStopped: () => console.log("Recording stopped"),
});

Recordings are available on the CometChat Dashboard → Calls section.

Record voice and video calls for playback, compliance, or archival purposes. Recording is built on top of the Call Session — you add recording listeners to your call settings and optionally control recording programmatically.

Setup

Add onRecordingStarted and onRecordingStopped callbacks to your OngoingCallListener when building call settings. These fire for all participants when any user starts or stops recording.

TypeScript
JavaScript
TypeScript

// Add listeners onRecordingStarted and onRecordingStopped to the startCall method
const defaultLayout = true;
const audioOnly = false;

const callListener = new CometChatCalls.OngoingCallListener({
  onRecordingStarted: (event) =>
    console.log("Listener => onRecordingStarted", event.user),
  onRecordingStopped: (event) =>
    console.log("Listener => onRecordingStopped", event.user),
});

const callSettings = new CometChatCalls.CallSettingsBuilder()
  .enableDefaultLayout(defaultLayout)
  .setIsAudioOnlyCall(audioOnly)
  .setCallListener(callListener)
  .build();

const htmlElement = document.getElementById("ELEMENT_ID");
CometChatCalls.startSession(callToken, callSettings, htmlElement);

// Add listeners onRecordingStarted and onRecordingStopped to the startCall method
const defaultLayout = true;
const audioOnly = false;

const callListener = new CometChatCalls.OngoingCallListener({
  onRecordingStarted: (event) =>
    console.log("Listener => onRecordingStarted", event.user),
  onRecordingStopped: () =>
    console.log("Listener => onRecordingStopped"),
});

const callSettings = new CometChatCalls.CallSettingsBuilder()
  .enableDefaultLayout(defaultLayout)
  .setIsAudioOnlyCall(audioOnly)
  .setCallListener(callListener)
  .build();

const htmlElement = document.getElementById("ELEMENT_ID");
CometChatCalls.startSession(callToken, callSettings, htmlElement);

// Add listeners onRecordingStarted and onRecordingStopped to the startCall method
const defaultLayout = true;
const audioOnly = false;

const callListener = new CometChatCalls.OngoingCallListener({
  onRecordingStarted: (event) =>
    console.log("Listener => onRecordingStarted", event.user),
  onRecordingStopped: () =>
    console.log("Listener => onRecordingStopped"),
});

const callSettings = new CometChatCalls.CallSettingsBuilder()
  .enableDefaultLayout(defaultLayout)
  .setIsAudioOnlyCall(audioOnly)
  .setCallListener(callListener)
  .build();

const htmlElement = document.getElementById("ELEMENT_ID");
CometChatCalls.startSession(callToken, callSettings, htmlElement);

The onRecordingStarted callback receives an event object — see the OngoingCallListener reference for the full shape. The onRecordingStopped callback receives no arguments.

Always remove listeners when they’re no longer needed (e.g., on component unmount or page navigation). Failing to remove listeners can cause memory leaks and duplicate event handling.

Settings for call recording

CallSettings Options

Setting	Description
`showRecordingButton(showRecordingButton: boolean)`	If set to `true` it displays the Recording button in the button Layout. if set to `false` it hides the Recording button in the button Layout. Default value = false
`startRecordingOnCallStart(startRecordingOnCallStart: boolean)`	If set to `true` call recording will start as soon as the call is started. if set to `false` call recording will not start as soon as the call is started. Default value = false

Programmatic Control

If you’re building a custom UI without the default layout, use these methods to control recording during an active call.

Start Recording

You can use the startRecording() method to start call recording.

TypeScript
JavaScript

CometChatCalls.startRecording();

CometChatCalls.startRecording();

Stop Recording

You can use the stopRecording() method to stop call recording.

TypeScript
JavaScript

CometChatCalls.stopRecording();

CometChatCalls.stopRecording();

Downloading Recordings

Call recordings are available on the CometChat Dashboard under the Calls section. Click the three-dot menu and select “View Recordings”.

Setup

Settings for call recording

CallSettings Options

Programmatic Control

Start Recording

Stop Recording

Downloading Recordings

Next Steps

Default Calling

Call Logs

​Setup

​Settings for call recording

​CallSettings Options

​Programmatic Control

​Start Recording

​Stop Recording

​Downloading Recordings

​Next Steps

Default Calling

Call Logs

Setup

Settings for call recording

CallSettings Options

Programmatic Control

Start Recording

Stop Recording

Downloading Recordings

Next Steps