Skip to content

Session Management

Description

Creates, tracks, and closes Session records that represent a single channel connection within a Conversation — for example, one phone call or one chat session. Sessions carry channel-specific metadata such as SIP call ID, WebRTC session ID, or messaging thread ID.

Canonical use case

When a customer is transferred from IVR to an agent, the platform creates a new Session to represent the agent leg while maintaining the link to the parent Conversation, preserving full continuity.

Open Items

  • [ ] Canon alignment — populate canon_axiom_refs or confirm no existing axiom applies
  • [ ] Dependency assessment — set dependencies_assessed: true once SA has reviewed the full chain
  • [ ] effort_estimate — replace 0 with rough engineering days (order of magnitude)
  • [ ] public_description — write the public-facing description before publishing