Session Timeout Flow

Handle idle session timeouts in CometChat calls, including automatic termination, user prompts, and the onSessionTimeout event.

Quick Reference for AI Agents & Developers

• Default idle timeout: 180 seconds (3 minutes) alone in a session
• Warning dialog appears at 120 seconds with stay/leave options
• Auto-terminates after 60 more seconds if no action taken
• Listen for onSessionTimeout event to handle auto-termination
• Customize timeout with setIdleTimeoutPeriod(seconds) in CallSettings (v4.1.0+)

Available since v4.1.0

Overview

CometChat Calls SDK provides a mechanism to handle session timeouts for idle participants. By default, if a participant is alone in a call session for 180 seconds (3 minutes), the following sequence is triggered:

1. After 120 seconds of being alone in the session, the participant will see a dialog box

2. This dialog provides options to either:

   • Stay in the call
   • Leave immediately

3. If no action is taken within the next 60 seconds, the call will automatically end

This feature helps manage inactive call sessions and prevents unnecessary resource usage. The idle timeout period ensures that participants don’t accidentally remain in abandoned call sessions.

Session Timeout Flow

The onSessionTimeout event is triggered when the call automatically terminates due to session timeout, as illustrated in the diagram above.

---

Next Steps

Default Calling

Implement ringing call flows with accept/reject functionality

Standalone Calling

Implement calling without the Chat SDK