BookFlowLayman-friendly documentation
Screen ReferenceDocs home

Analytics And Retention Reference

This page explains Programs, AI Receptionist, AI operations, recommendations, Insights, Reports, scheduled reports, wallet adjustments, no-show reports, and the customer retention loop in operational language.

Benefits companion: If you need the visual "what members get, what they used, what remains" lifecycle with booking and payment proof, open Membership Benefits Manual.

Screen Map

ScreenLocal linkPurposeScreenshot
Programs And CRMProgramsCreate memberships/packages, assign/sell benefits, launch retention campaigns.admin/programs.png
AI ReceptionistReceptionistInbox for public assistant messages, follow-ups, and support escalations.Uses shared admin analytics layout.
AI OperationsAI OperationsProvider health, simulator/fallback state, latency, confidence, and audit health.ai/ai-usage-audit.png
AI RecommendationsAI RecommendationsHuman-reviewed action suggestions for booking, reporting, and customer follow-up.Uses shared AI workspace layout.
InsightsInsightsBenchmarking, staff economics, queues, automation health.Uses shared admin analytics layout.
ReportsReportsFiltered operational reports and CSV exports.admin/reports.png
No-show ReportNo-showsFocused no-show reporting by window, staff, service, location, and status.Reports detail layout.
Scheduled ReportsReport SchedulesCreate recurring owner/admin report subscriptions and inspect next run state.Scheduled reports layout.

Programs And CRM

Programs and CRM
Programs turn one-time customers into repeat customers through memberships, packages, sales, and campaigns.

Program KPIs And Charts

WidgetWhat it countsSourceHow to read itWhy it matters
Due Rebook KPICustomers ready for return prompt.Customer/booking retention segmentation.Higher number means rebooking opportunity.Drives repeat revenue.
Win Back KPIDormant customers.Customer activity history.High number means customers are slipping away.Launch win-back campaign.
VIP KPIHigh-value profiles.Customer lifetime value/booking history.Shows best customers.Protect premium relationships.
Membership Upsell KPICustomers fit for programs.Booking/spend/segment rules.Shows upsell audience.Sell memberships/packages.
Segment Mix chartDue rebook, win back, VIP, upsell segments.Segment counts.Largest segment shows dominant retention task.Focuses staff on one growth motion.
Program Momentum chartPlans, package sales, campaigns, touchpoints.Program and retention records.Shows whether programs are being used.Connects benefit setup to customer outreach.

Program Fields

FormFieldRequired?MeaningWhat changesCommon mistake
Create Membership PlanPlan NameYesCustomer-facing membership name.Creates plan available to sell/activate.Using vague names like "Plan 1".
Create Membership PlanBilling IntervalYesMonthly or annual cadence.Plan recurring period.Mixing monthly price with annual interval.
Create Membership PlanPriceYesMembership price.Membership amount and customer portal offers.Expecting it to change old memberships automatically.
Create Membership PlanBooking DiscountNoPercent discount on bookings.Benefit matching/payment calculation.Entering 10.00 when expecting currency instead of percent.
Create Membership PlanWaive DepositNoMembers can skip deposit.Booking/payment benefit rules.Waiving deposits for high-risk services unintentionally.
Create Membership PlanDescriptionNoShort program explanation.Public/customer offer copy.Too much legal policy text.
Create Membership PlanPerksNoLine-separated benefits.Plan perks display.Listing perks not supported operationally.
Create Service PackagePackage NameYesPrepaid package name.Creates package offer.Name not clear about credits/service.
Create Service PackageDescriptionNoPackage explanation.Offer copy.Not explaining expiry rules.
Create Service PackagePriceYesPackage sale amount.Package purchase price.Price not matching expected package value.
Create Service PackageCreditsYesNumber of visits/credits.Customer wallet credits.Too few credits for package name.
Create Service PackageValidityYesDays until expiry.Package expires_at on sale.Leaving too short for customer usage.
Create Service PackageIncluded ServicesNoServices package can cover.Benefit applicability.Leaving blank when package should be service-specific.
Assign MembershipCustomer Name, Email, PhoneName/email requiredCustomer identity.Creates/finds customer and assigns membership.Email mismatch prevents portal wallet match.
Assign MembershipAuto RenewNoRenew automatically.Membership renewal behavior.Turning on without customer agreement.
Sell PackageCustomer Name, Email, PhoneName/email requiredCustomer identity.Creates package purchase and credits.Wrong email means credits do not show for the intended customer.
Launch CampaignCampaign NameYesInternal campaign name.Campaign record.Name does not explain audience or purpose.
Launch CampaignSegmentYesAudience group.Touchpoint generation target.Choosing VIP for a win-back message.
Launch CampaignChannelYesEmail, SMS, WhatsApp, database.Touchpoint channel field.Assuming real SMS delivery is configured in V1.
Launch CampaignSubjectNoMessage subject.Touchpoint subject.Blank subject for email campaigns.
Launch CampaignBodyYesMessage text.Touchpoint body.Leaving template variables confusing to customers.

AI Receptionist

Widget/fieldWhat it meansSourceActionConnection
Open Conversations KPIConversations needing attention.Receptionist conversations.Open inbox.Helps staff respond to leads/support.
Booking Intents KPIMessages likely to become bookings.Conversation intent analysis.Follow up or convert manually.Feeds booking growth.
Program Questions KPIMembership/package demand.Conversation intent analysis.Answer or upsell programs.Connects assistant to Programs.
Human Follow-up KPIEscalations needing staff.Conversation flags.Open detail.Connects to TicketPro if enabled, otherwise local resolution.
Conversation Intent Mix chartOpen, booking, programs, flagged split.Conversation stats.Read largest workload type.Shows AI desk health.
Reception Trend chartWeekly leads, registered, converted flow.Preset chart data.Read trend direction.Shows whether reception work is growing/converting.
Inbox itemGuest name/email, intent, confidence, summary, last message time.Conversation and messages.Select conversation.Loads detail tab context.
Status badgeOpen, TicketPro Handoff, or Resolved.Conversation status.Check whether follow-up is still allowed.Prevents duplicate staff follow-up.
Create TicketPro Follow-up CaseTracked support handoff.TicketPro connection plus conversation context.Create one case.Stores external ticket reference and locks repeat follow-up.
Resolve LocallyFallback when TicketPro is not active.Internal resolution note.Resolve once.No external ticket and no customer message are created.
Reopen ConversationUnlocks a locally resolved conversation.Resolved conversation.Reopen for one new handling action.TicketPro-owned conversations cannot be reopened locally.
AI usage audit log
AI Usage Audit: feature keys, rules/simulator/fallback mode, latency, confidence, and redacted excerpts are visible.
Receptionist suggested reply
Suggested reply: internal staff draft only; BookFlow does not auto-send customer-facing messages.
Receptionist action draft
Action draft: AI prepares support/booking details, but normal BookFlow confirmation is still required.

What happens when staff handles follow-up?

TicketPro stateVisible actionResultCustomer messageRepeat protection
Configured and activeCreate TicketPro Follow-up Case.BookFlow creates a requester ticket, stores the ticket mapping, marks the conversation TicketPro Handoff, and shows ticket number/status/priority.None from BookFlow. Staff reply inside TicketPro.Further BookFlow follow-up is disabled.
Not configured or inactiveResolve Locally plus Configure TicketPro link.BookFlow stores one local resolution note and marks the conversation Resolved.None from BookFlow.Further follow-up is disabled until staff reopens the conversation.
Already TicketPro HandoffTicket details only.Conversation remains owned by TicketPro.Use TicketPro.Duplicate TicketPro cases are blocked.
Already ResolvedReopen Conversation.Conversation can return to Open for one new handling action.None from BookFlow.Reopen is blocked for TicketPro-owned records.
Receptionist open flagged conversation
Open flagged AI receptionist conversation before staff handles it.
TicketPro configured handoff form
TicketPro active: staff can create one tracked follow-up case.
TicketPro ticket reference locked state
TicketPro Handoff: ticket reference is visible and repeat follow-up is locked.
TicketPro not configured local fallback
TicketPro inactive: staff can resolve locally and open the setup path.
Local resolved receptionist conversation
Resolved locally: one note is saved and duplicate follow-up is disabled until reopen.

Insights

Widget/tableWhat it countsSourceHow to use itBusiness meaning
Avg Ticket KPIAverage completed sale value.Booking/payment analytics.Compare with peer baseline.Pricing and upsell health.
No-show Rate KPIPercent no-show/risk signal.Booking history/risk analytics.Watch if above peer baseline.May need deposits/reminders.
Slot Utilization KPIPercent of usable slots filled.Slot/booking analytics.Low means spare capacity.Campaign or schedule action needed.
Benchmark Position chartBusiness versus peer baseline.Benchmarking service.Bars compare own performance to peers.Shows strengths/gaps.
Action Queue Mix chartConfidence, conflicts, no-show, rebook queues.Operational queues.Largest slice is priority queue.Turns analytics into action.
Benchmark CoachingStrengths and gaps.Benchmark signals.Read recommendations.Explains what to improve.
Customer PortfolioVIP, at-risk, dormant, total profiles.Customer summaries.Target segments.Retention planning.
Staff Economics tableRevenue, utilization, retention, commission per staff.Staff bookings and profile commission.Compare staff performance.Pay, training, schedule decisions.
Confidence QueueUpcoming bookings with confidence scores.Booking metadata.Review deposits/risk.Reduce no-shows.
Rebooking OpportunitiesCustomers due for another visit.Booking metadata/history.Open booking or prompt customer.Repeat revenue.
Conflict RadarBookings needing resource/deposit intervention.Booking/resource/payment metadata.Resolve before appointment.Avoid operational failure.
No-show WatchlistMedium/high-risk customer profiles.Customer risk analytics.Send reminder/deposit prompt.Protect schedule value.
Notification PipelinePending, overdue, high-risk SMS, deposit follow-ups, review/payment/win-back readiness.Notification automation summaries.Check what needs sending.Keeps lifecycle communication moving.

Reports Hub And Detail

Reports hub
Reports apply one filter set across report links, comparisons, detail rows, and CSV export.
Reports AI summary panel
AI Report Summary: draft-only summary logged as reports.summary; source report data is not rewritten.

Report Filters

FieldRequired?MeaningWhat it filtersCommon mistake
RangeYesLast 7 days, 30 days, 90 days, or custom.Report date window.Choosing custom without checking start/end.
StartNoCustom start date.Report window lower bound.Start after end date.
EndNoCustom end date.Report window upper bound.End before start date.
LocationNoBranch filter.Bookings/revenue at one branch.Forgetting filter remains in URL links.
StaffNoStaff filter.Bookings/revenue for one professional.Using staff filter on reports where staff is not relevant.
ServiceNoService filter.Bookings/revenue for one service.Filtering out broader business picture.
StatusNoBooking state filter.Only matching bookings.Revenue may look low if completed-only/confirmed-only is selected.

Scheduled Reports And No-show Reports

Reports are no longer only a manual export surface. Owners can create scheduled report subscriptions, and operations can run due schedules through the safe scheduled-report command. No-show reports expose the risk and attendance side of retention so policy changes can be based on proof.

AreaWhat it tracksWho uses itProof
Scheduled report setupReport type, frequency, recipient, filters, and next run.Owner/admin.Reports schedules page and scheduled report subscription rows.
Scheduled runDue report processing, completed/failed state, and run history.Platform/admin support.php artisan bookflow:scheduled-reports --tenant=nimbus.
No-show reportNo-show count, rate, related bookings, staff/service/location filters, and trend context.Operations manager.No-show report page and exported rows.
Review queueCompleted bookings waiting for customer feedback.Retention/support staff.Customer portal review action and marketplace review proof.
AI report summaryDraft-only explanation of current report movement.Owner/admin.AI audit log entry; report source rows remain unchanged.

Wallet Adjustments And Package Credits

Wallet adjustments are operational corrections or goodwill credits. Package credits are sold/assigned program benefits. Both must be proved in multiple places: Programs ledger, customer wallet, payment benefit summary, notifications, demo mailbox, and reports.

RecordSourceCustomer effectRetention proof
Cash wallet adjustmentPrograms wallet adjustment form.Balance increases or decreases with a reason.Ledger row, notification, demo mailbox wallet.admin_adjustment.
Package creditPackage sale or ecommerce/custom app entitlement.Credits appear in wallet and can cover eligible bookings.Usage ledger and payment page benefit summary.
Membership benefitAssigned/sold membership plan.Discount, deposit waiver, or customer-visible perk appears.Wallet card, renewal queue, booking benefit snapshot.

Report Widgets And Columns

AreaItemMeaningSourceAction
Reports hubOverview KPI cardsTop metrics for current window.Report service overview.Read before opening detail.
Reports hubOverview Metrics chartBar chart of current report values.Overview cards.Compare metric sizes.
Reports hubPrevious Window chartComparison baseline.Previous period summaries.See movement against earlier window.
Report LibraryReport linksAvailable report sections.Configured report routes.Open detail using current filters.
Report detailReport Summary chartSummary values for selected report.Payload summary.Read high-level result.
Report detailReport Trends chartTrend values for selected report.Payload trends.Spot movement over time.
Report detailBreakdownsGrouped detail panels.Payload breakdowns.Understand why totals moved.
Report RowsDynamic columnsRaw report output; labels change by report.Payload columns and rows.Inspect or export exact rows.
Export CSVDownload actionExports current report/filter rows.Report export route.Use in spreadsheets/accounting.

Retention Examples

Completed Booking Becomes Review

After Guided Meditation is completed, the customer portal shows a review action. The customer submits rating/title/body. Marketplace review data improves storefront and directory trust surfaces.

Package Credits Drive Repeat Visits

Maya sells a Six Session Recovery Pack. Credits appear in the customer's wallet. When the same customer books with the matching email/account, BookFlow can explain or apply available benefits.

No-show Risk Becomes Deposit Action

Insights flags a high-risk booking. Staff can use confidence/deposit signals to ask for payment before the appointment. Payment status then flows back to booking detail and reports.

CRM Lead Becomes Booking

A CRM lead enters the integration queue, is converted into a booking, and later appears in reports, calendar, payment, and retention actions like any normal booking.