Skip to main content
The idle timeout feature automatically ends a call session when a participant is alone for a specified period. This prevents abandoned calls from running indefinitely.

Configure Idle Timeout

Set the idle timeout period when creating call settings:
ParameterTypeDefaultDescription
idleTimeoutPeriodBeforePromptnumber180000Milliseconds of inactivity before the prompt appears
idleTimeoutPeriodAfterPromptnumber120000Milliseconds the user has to respond before the session ends

How It Works

  1. When all other participants leave the call, the idle timeout timer starts
  2. A prompt appears 60 seconds before the timeout, allowing the user to extend the session
  3. If the user doesn’t respond, the session ends automatically
  4. If another participant joins, the timer is cancelled

Listen for Timeout Events

Session Timeout Event

Listen for when the session times out:

Disable Idle Timeout

Set a very high value to effectively disable the timeout:

Complete Example

Timeout Behavior

ScenarioBehavior
User is aloneTimer starts counting down
Another participant joinsTimer is cancelled
User extends sessionTimer resets
Timer expiresSession ends, onSessionTimedOut fires