Session Lifecycle
Two Entry Points
With pre-session lookup (dotted line): Host callssi_get_offering first to show products before consent. The offering_token carries what was shown into the session.
Direct session (solid line): Host calls si_initiate_session directly. Brand agent shows products as part of the conversation and tracks them internally.
Both are valid. Use pre-session lookup for sponsored search results where you want to preview products before asking the user to engage.
Tasks
| Task | Description | Initiator |
|---|---|---|
si_get_offering | Get offering details, availability, and matching products (anonymous) | Host |
si_initiate_session | Start a conversation with a brand agent | Host |
si_send_message | Exchange messages within an active session | Host |
si_terminate_session | End the session with appropriate handoff | Either |