Production checklist and troubleshooting

Use this page as a final pre-release gate and an incident-response quick reference.

Production checklist

1. Validate workspaceId and endpoint values in each environment.
2. Confirm start() returns success: true on real browser traffic.
3. Verify privacy controls on sensitive forms and account pages.
4. Confirm replay URL generation with getSessionLink().
5. Verify Vuex/Pinia state payloads are minimal and sanitized.
6. Test live assist consent prompts, call flow, and remote control release.
7. Confirm WebSocket and CSP rules allow assist runtime endpoints.

Fast diagnostics snippet

const result = await browser.start();

if (!result.success) {
  console.error('OXVO Sessions start failed:', result.reason);
} else {
  console.log('Session meta:', browser.getSessionMeta());
  console.log('Session link:', browser.getSessionLink());
}

Common issues and fixes

Symptom	Likely cause	What to do
start() returns success: false with Server error: 403. capture rate miss...	Session sampling blocked capture	Adjust sampling and start conditions for the target flow
start() returns success: false with Server error: 403. monthly sessions limit reached	Billing-period session cap reached	Update billing state or reduce free-tier traffic until reset
start() rejects on local HTTP	SSL guard is active	Use HTTPS or set devAllowInsecure: true only in development
Replays missing network payload fields	captureBodies: false or strict masking	Revisit networkCapture and sanitization policy
Vuex/Pinia updates do not appear	Store connector function not attached correctly	Use connectState('store-name')(storeInstance)
Live assist connects but no call media	Browser permission denied or media blocked	Re-request permissions and test secure context
Remote control appears stuck after tab changes	Another tab holds active control state	End control in active tab and validate shared tab state

Live assist reliability checks

• Confirm /assist/ws is reachable from browser clients.
• Confirm confirmation dialogs are visible and actionable.
• Confirm call UI template URL is reachable if custom template is used.
• Confirm support roles have permission to join live sessions.

Escalation data to collect

• SDK package versions in use.
• Initialization options (without secrets).
• start() result payload and failing reason.
• Session metadata snapshot from getSessionMeta().
• Browser console/network logs around bootstrap and ingest requests.

📷 Image (optional): Sessions SDK production readiness board
Why: Gives engineering, support, and security teams a shared launch/no-launch checklist view.
File: docs/images/sdk-sessions-production-readiness-board.png
AI prompt: "Clean product documentation checklist board for OXVO Sessions SDK release with columns Browser Capture, Privacy Controls, Vuex/Pinia State, Live Assist, and Incident Diagnostics, modern SaaS style, neutral gray palette with primary accent, readable typography, synthetic checklist items only, 1600x1000."