Skip to main content

Duration limit

Control how long a session stays active with maxSessionLengthSeconds. The countdown begins when the persona starts streaming.
const personaConfig = {
  name: "Cara",
  avatarId: "30fa96d0-26c4-4e55-94a0-517025942e18",
  voiceId: "6bfbe25a-979d-40f3-a92b-5394170af54b",
  llmId: "0934d97d-0c3a-4f33-91b0-5e136a0ef466",
  systemPrompt: "You are Cara, a helpful customer service representative.",
  maxSessionLengthSeconds: 300,
};
If you don’t set maxSessionLengthSeconds, the session continues until manually ended or until it reaches the platform limit: 30 minutes on standard plans, 2 hours on Enterprise.
Use caseDurationReason
Trial / demo2–5 minutesGives users a taste without running up usage
Product demo5–15 minutesEnough to showcase key features
Customer support10–30 minutesRoom for complex issues

Tips

  • Allow enough time for the conversation to conclude naturally — abrupt endings frustrate users.
  • Consider showing users a countdown timer so the cutoff isn’t a surprise.
  • Track actual session lengths to find the right limit for your use case.