Repository navigation
[Epic · Ops/WA] Business WhatsApp AI desk #511
Description
[Epic · Ops/WA] Business WhatsApp AI desk — enquiries · sheet matching · client memory CRM
Status: Open — CEO wants to build on this now for WhatsApp Business (not On Hold).
Trigger (2026-10-28 ~23:17 HKT): Denise So → Hauzton (with Ryan): use AI agents to (1) handle customer enquiries and (2) search Excel sheets and recommend tutors — try on WhatsApp Business Account. Hauzton: already planning; matching may be possible but errors may happen. Screenshot attached.
CEO add-on (same thread): open WA Business improvement issues and link related ones; in this age people want to be recognised and remembered — build relationships; every detail of the client (likes, info, child, anything that describes the person) should be collected and kept in description or DB so next time tutor/client finds us we quickly remember needs and communicate warmly; AI scans chat + profile and builds that info up per client.
Goal
WhatsApp Business becomes a relationship desk, not only ticket macros: AI helps with enquiries, Master Sheet tutor search/recommend, and durable client memory so returning parents/tutors feel remembered.
Three pillars (children)
| # | Pillar | Child |
|---|---|---|
| 1 | Enquiry AI | #512 Business WhatsApp enquiry agent (menu + free-text) |
| 2 | Sheet search → recommend | #513 Master Sheet tutor search + recommend on Business WA |
| 3 | Client relationship memory CRM | #514 Client relationship memory — chat+profile → lasting notes |
Architecture (CORRECTED · Gemini — ADOPT)
- FOH: warm replies + FAQ + present shortlist; prompt gets Memory Inject from [Ops · CRM · #511] Client relationship memory #514.
- BOH: async after idle; extract facts → upsert memory; propose friction/desk tags (human confirms).
- Matching ([Ops · WA · #511] Master Sheet tutor search + recommend #513): hard-filter → AI rank ≤3 → human approve draft before parent send.
- Non-goals unchanged (REJECT list on CORRECTED comment — do not reopen).
Standing ops locks (do not override)
- Parent/client outbound: still draft-first unless CEO says send without preview (Jarvis). CS1 has a separate auto-send standing permission. Note both; do not invent a new send policy.
- No tutor pings for waiting cases without CEO approval (2026-10-15), except if someone messages about the case / CEO asks.
- ≤3 tutors per wave; fee/safety from WA SOP (no grade promises; phones after fee).
- Master Sheet is live CRM (
MatchMax (New)/ current ops sheet) — AI search must read that, not invent tutors. - Contact-creation limits: if tutor/parent is not in contacts, hand matching to CS2; still create contacts for every client/tutor who messages Business WA.
Assignees (keep — don’t invent new roles)
- Ryan — AI / backend
- Denise — ops / bot flow + sheet columns
- Tim / Austin — invoice / fee desk
- Hauzton — match approve
Roadmap (CORRECTED · OPTIMIZE)
- P0: Sheet Notes memory upsert + remember brief ([Ops · CRM · #511] Client relationship memory #514) · FAQ FOH ([Ops · WA · #511] Business WhatsApp enquiry agent #512) · hard-filter shortlist drafts ([Ops · WA · #511] Master Sheet tutor search + recommend #513)
- P1: waiting-window soft Q · reject-list exclusion · Blue Tick / alma soft rank
- P2: Whisper · auto 1.5 check-in (after [V1 · #467] Scheduling + revenue/earnings engine (4 buckets) #461/[Feature · V1] Case ratings carousel + bilateral End Case #503 gates) · JSONB / Supabase / [Urgent · V1] Unified account + roles + child sub-profiles + hours ledger #459 column
Non-goals
Do not unpark on-platform community/AI chat — #476 / #440 stay On Hold. This epic is WhatsApp Business + Master Sheet + client CRM memory, not an in-app chat engine.
Do not unpark #450 (autonomous matching density), #472 (personalised parent updates — cite as related vision only), #22 / #121 (parked AI search for website — stay On Hold; desk/WA path is this epic).
Related issues
- Ops SOP: matching playbook, tutor WA groups & WhatsApp desk #335 — WA desk SOP / matching playbook
- [Ops] Matching speed & reliability pack #451 — matching speed macros
- [Ops · #463] Internal desk track + matching backboard #448 — internal desk track
- [Feature · Matching] Outcome ledger + two-way matching engine #428 — explainable matching
- [Urgent · V1] Unified account + roles + child sub-profiles + hours ledger #459 — child sub-profiles (product); CRM memory V1 can use Sheet Notes now, product field later
- [Parked] Personalised Parent Updates — Child Profile → Curated Tutor / Centre Shortlist #472 — parked personalised parent updates (related vision; keep On Hold)
- [PARKED] AI Integration for Tutor Search #22 / Add AI-Powered "Top Matches" Section to Parent Search Results #121 — parked AI search (related; stay On Hold for site search)
- # Issue O4 — Staff log and privacy #262 — staff log / privacy
- [Parked] Autonomous Matching Density Layer — Full Idea Capture (A–H) #450 — parked autonomous matching density (stay On Hold)
- [Fee · #464 · Urgent] 6-Month Ownership Boundary + Retained-Only + Drop floor #508 — centre fee ladder 1.5 / 1 / 0.5
- [Feature · V1] /guide — 7 photo slots + layout + Blue Tick #498 — Blue Tick naming
- [Feature · V1] Preferred name = optional public display name #502 — preferred display name
Acceptance
- Epic has 3 linked children (enquiry · sheet recommend · client memory) — [Ops · WA · #511] Business WhatsApp enquiry agent #512 [Ops · WA · #511] Master Sheet tutor search + recommend #513 [Ops · CRM · #511] Client relationship memory #514
- Denise/Ryan screenshot attached on this epic
- Cross-comments on key related issues (Ops SOP: matching playbook, tutor WA groups & WhatsApp desk #335, [Ops] Matching speed & reliability pack #451, [Ops · #463] Internal desk track + matching backboard #448, [Urgent · V1] Unified account + roles + child sub-profiles + hours ledger #459)
- Children [Ops · WA · #511] Business WhatsApp enquiry agent #512–[Ops · CRM · #511] Client relationship memory #514 ACs expanded with full OPTIMIZE list from CORRECTED Gemini verdict
- Standing ops locks respected in all child specs (draft-first / CS1 auto-send note; no tutor ping without CEO; ≤3; Master Sheet SoT; contact handoff to CS2)
- Roadmap P0–P2 checkboxes above tracked as children ship
Labels
enhancement — leave open / not On Hold.
Consolidated sub-issues (eng map)
| # | Title |
|---|---|
| #512 | Business WhatsApp enquiry agent |
| #513 | Master Sheet tutor search + recommend |
| #514 | Client relationship memory CRM |
Content/FAQ accuracy → #516 / #515 (not nested here). Matching human SOP → #517 / #335.
Consolidated for eng — sub-issues listed.
Activity
owlstonbusiness-svg commentedon Oct 28, 2026
Trigger screenshot — Denise So → Hauzton (2026-10-28 ~23:17 HKT)
Denise (with Ryan): use AI agents to (1) handle customer enquiries and (2) search Excel sheets and recommend tutors — try on WhatsApp Business Account.
Hauzton: already planning; matching may be possible but errors may happen.
CEO follow-up: open linked WA Business improvement issues + client relationship memory (recognised/remembered; AI scans chat+profile per client).
Children: #512 enquiry · #513 sheet recommend · #514 client memory CRM.
owlstonbusiness-svg commentedon Oct 28, 2026
CORRECTED — Gemini WA Concierge / Silent CRM / Matching (vs #511–#514) — 2026-10-29
Source: 3 Gemini packs (hospitality schema · FOH/BOH epic ·
search_tutorshard-filter).Locks: Denise/Ryan WA ask + CEO relationship-memory · #511 epic · #512 enquiry · #513 sheet recommend · #514 client memory · WA SOP · fee #508 · Blue Tick #498 · Cap.57 independent tutors · draft-first / CEO tutor-ping rules.
Verdict snapshot
T-402IDsMM-T###/MM-C###ADOPT (ship into #511–#514)
Two-agent split
Maps: [Ops · WA · #511] Business WhatsApp enquiry agent #512 FOH FAQ · [Ops · CRM · #511] Client relationship memory #514 BOH memory · [Ops · WA · #511] Master Sheet tutor search + recommend #513 search.
Zero-friction collection
Passive NLP from natural chat (80%) + one caring Q in the waiting window (15%) + post-lesson / friction triggers (5%). Do not open with a survey checklist.
Universal traits (everyone)
Preferred language/register (EN / 繁中 / mix) · cadence (hours, voice vs text) · relationship temperature (plain words, not creepy scores in parent UI) · past friction notes.
Role schemas (trim to MatchMax)
Matching architecture ([Ops · WA · #511] Master Sheet tutor search + recommend #513)
LLM → structured
search_tutorsparams → deterministic filter on Master Sheet → AI ranks ≤3 with “why they fit” from memory → admin draft card for Denise/Hauzton/CS before parent send.Hard filters: Active · subject+level · curriculum · district/online · rate ≤ budget (+ optional small buffer) · exclude prior rejects.
Soft rank: Blue Tick boost · alma mater · reliability/punctuality if we have data · vibe keywords · budget sweet spot.
Zero-result fallback: relax budget / offer Zoom — ask parent, don’t invent tutors.
Privacy / Cap.57 in pitches
No phone / full legal name on first shortlist · Independent Tutor framing · phones after fee paid (existing SOP).
Policy lines FOH may state
Parents $0 platform fee · tutor admin = 1.5 (L1 100% + L2 50%) · short ≤5 → 20% package · tutors = independent · Blue Tick = staff-checked docs · no grade promises.
REJECT
T-402,USR-8821in specsOPTIMIZE (MatchMax-shaped)
contact_memoryJSON later (Supabase / [Urgent · V1] Unified account + roles + child sub-profiles + hours ledger #459 child profiles). Don’t block on new table week 1.MATCH-MISMATCH,TUTOR-CONDUCT,BILLING-1.5,BOT-FALLBACK,PLATFORM-UX) linked to MM-C / MM-T / MM-C####; GH only when eng bug.Map onto existing issues
search_tutorsschema · hard filter · ≤3 · admin draft · fallback copy · privacy pitch rulesEng paste (short)
ADOPT FOH/BOH + silent CRM + hard-filter→≤3 draft. REJECT Gold naming, auto-ping, GH spam, unpark in-app AI. OPTIMIZE Master Sheet Notes first; Blue Tick; MM-codes; centre 1.5/1/0.5; desk tags not auto-issues.
owlstonbusiness-svg commentedon Oct 28, 2026
Children #512–#514 ACs now include the full OPTIMIZE list from CORRECTED. Epic gained FOH/BOH architecture note, assignees (Ryan / Denise / Tim·Austin / Hauzton), and P0–P2 roadmap checkboxes. REJECT list unchanged — not reopened.
owlstonbusiness-svg commentedon Oct 28, 2026
Refinement — CEO 2026-10-29 (fee framing across FOH)
Applies to all children; no policy invent beyond standing locks.
BILLING-1.5([Ops · CRM · #511] Client relationship memory #514); human confirms; do not auto-open GitHub; do not rewrite the ladder.REJECT list on CORRECTED comment stays closed. On Hold issues stay On Hold.
owlstonbusiness-svg commentedon Oct 28, 2026
Consolidated for eng — sub-issues listed: #512 #513 #514. Parent epic map: see #518.
[-][Epic · Ops/WA] Business WhatsApp AI desk — enquiries · sheet matching · client memory CRM[/-][+][Epic · Ops/WA] Business WhatsApp AI desk[/+]owlstonbusiness-svg commentedon Oct 29, 2026
Child: Trust + WA AI flags + pre-match gates → #529
owlstonbusiness-svg commentedon Oct 29, 2026
AC add (Grok ADOPT): Lightweight case risk flags queue UI so the WA AI classifier (#529) has a place to land advisory flags even before full automation. Schema slice: #535.