Complete PostHog funnel and session replay for online scheduler
Objective
- Give support and client care a reliable way to verify what a customer actually did in the public online scheduler when they report a failed or unexpected booking — without relying on memory or external tools alone.
- Stand up a PostHog funnel aligned to the real scheduler steps, enable full session replay for public scheduler sessions, and identify the PostHog person once the user enters contact information so replays and events can be correlated.
- Use PostHog as the troubleshooting surface (not an in-product audit log), per product direction from Chris.
Background
- Jun 17, 2026 catch-up: when agents or customers say the scheduler failed or they followed a certain path, there is no reliable way to confirm the actual steps taken.
- Chris proposed handling this in PostHog: create an online scheduler funnel, track key step events, enable session replay for the scheduler, and call
identifyonce the person enters their information. - PostHog is already integrated in the frontend (ATT-1747 Done):
src/instrumentation-client.tsinitializes the client in production via/ingest, with PII scrubbing insrc/util/posthog/sharedConfig.ts. - Partial scheduler instrumentation already exists but does not fully match the five-step flow or support replay lookup:
- Events today:
scheduler_service_selected(ServiceConfirmation.tsx),scheduler_slot_selected(SlotsStep.tsx),scheduler_job_booked/scheduler_booking_failed(BookingJobLoader.tsx),scheduler_quote_sent(SendQuoteLoader.tsx). SchedulerContext.tsxcallsposthog.identify(contactId, …)and registersscheduler_contact_idwhen a contact record exists.SchedulerRunProvidersetsscheduler_run_idon both public/schedulerand internal/tools/schedule.- A Scheduler Booking Funnel insight was created during PostHog setup (
posthog-setup-report.md) but covers only service → slot → booked — not property, contact, summary, quote, or failure paths. - The public online scheduler is a five-step flow in
src/app/scheduler/page.tsx: Services → Property → Schedule (slots) → Contact → Summary (SchedulerContent.tsx). Contact identification currently happens when the contact object is set (step 4), after slot selection (step 3).
Product Decisions
Locked
- Troubleshooting surface — Use PostHog (funnel + session replay), not an in-product scheduler audit log.
- Primary use case — Support and client care investigating online scheduler complaints (user path + session behavior).
- User identity — Call PostHog
identifywhen the user enters contact information in the scheduler flow (extend/refine existingSchedulerContextbehavior as needed). - Surface scope — Public online
/scheduleronly. Internal CSR scheduling at/tools/scheduleis out of scope for this work. - Event coverage — The more information the better for support troubleshooting. Instrument all five scheduler steps plus both completion paths (book job and send quote), failures, and other high-signal events (e.g. session started, step completed, property confirmed, contact submitted, booking failed). Dev should prefer comprehensive step-level events over a minimal three-event funnel.
- Session replay — Full (100%) session replay for public
/schedulersessions — not sampled. - Support lookup workflow — Primary support workflow is filtering PostHog replays/events by company + time range (easiest path today). Document this in a brief runbook;
scheduler_run_idand contact id remain useful secondary filters when known. - PII in replays — Dev discretion: choose PostHog masking/block selectors vs visible contact fields in replay based on tradeoffs; consult Chris or Ryan before finalizing if unclear.
Open
- Identify timing — Identify on first contact field entry, on step 4 completion, or when contact record is created/saved (current: when
contact._idexists in context)? - PostHog project config — Who owns creating/updating the funnel insight and replay filters in the PostHog UI after events ship (eng vs product/ops)?
Scope
Frontend
- In scope: public scheduler only —
src/app/scheduler/(layout wrapsSchedulerRunProvider; main flow inSchedulerContent.tsx, steps 1–5). - Out of scope: internal CSR scheduler at
src/app/tools/schedule/— do not add or extend scheduler analytics events there for this ticket. - Existing PostHog touchpoints to extend or align:
src/app/scheduler/SchedulerContext.tsx— company group, contactidentify,scheduler_contact_idregister.src/components/scheduling/SchedulerRunProvider.tsx—scheduler_run_idper tab session (continue on public scheduler).- Step-level captures in
ServiceConfirmation.tsx,SlotsStep.tsx,BookingJobLoader.tsx,SendQuoteLoader.tsx. - Gaps to address:
- Property and contact step events and step-order alignment with the real five-step UI flow.
- Comprehensive event coverage across book, quote, and failure paths (locked decision #5).
- Full session replay activation scoped to public
/schedulerroutes (no scheduler-specific replay config ininstrumentation-client.tstoday). - Consistent event properties:
company_id,scheduler_run_id, step name/order, surface=scheduler(or equivalent) for PostHog filtering.
PostHog configuration (outside repo)
- Create or update funnel(s) to match the full five-step flow and both book/quote outcomes.
- Configure 100% session replay for public scheduler URL/surface filters.
- Document support lookup: filter by company + time range in PostHog (locked decision #7).
Backend
- No backend API required for v1 — scheduler telemetry remains client-side PostHog.
Out of scope (v1)
- Internal CSR
/tools/scheduleanalytics. - In-product scheduler audit/history UI.
- PostHog instrumentation for client report page (ATT-1748).
- Mobile scheduler.
Done when
- [ ] PostHog events cover the full public scheduler path — all five steps plus book, quote, and failure outcomes.
- [ ] 100% session replay is enabled for public
/schedulersessions. - [ ] Support can find a relevant replay/session using company + time range (documented in runbook).
- [ ] PostHog identifies the user once contact information is entered.
- [ ] Event properties include
company_id,scheduler_run_id, and step context for filtering. - [ ] PII/masking approach for replays decided (dev consults Chris/Ryan if needed).
References
- PostHog init:
attik-frontend/src/instrumentation-client.ts - PII scrubbing:
attik-frontend/src/util/posthog/sharedConfig.ts - Scheduler context / identify:
attik-frontend/src/app/scheduler/SchedulerContext.tsx - Run id:
attik-frontend/src/components/scheduling/SchedulerRunProvider.tsx - Scheduler steps:
attik-frontend/src/app/scheduler/page.tsx,SchedulerContent.tsx - Existing setup notes:
attik-frontend/posthog-setup-report.md - Platform setup (Done): ATT-1747
- Related report analytics: ATT-1748
Status: Planned
Log in to comment and vote
No comments yet
Be the first to share your thoughts.