Skip to content

WhatsApp Bot Onboarding

[!WARNING] Deferred to Phase 2: UC-BOT-001 to UC-BOT-004 are not included in the MVP scope per client decision dated 2024-12-31.

Frictionless user acquisition and profile setup entirely within WhatsApp.

UC-BOT-001: Chat-Based Onboarding

Purpose: Convert anon phone numbers into registered customer profiles.

Property Value
Actor New Customer
Trigger Inbound Message ("Hi") or QR Code Scan
Priority P0

Capabilities Breakdown:

UC-BOT-002: Zero-Install Signup

  • Flow: User scans store QR -> Opens WhatsApp with pre-filled text "Hi Cazo, I'd like to join".
  • Data Capture: Bot asks Name, Gender Preference, and Marketing Consent.
  • Verification: Phone number verified implicitly by WhatsApp platform.

UC-BOT-003: Preference Learning

  • Quiz Mode: "What services are you interested in?" [Hair] [Skin] [Nails].
  • Stylist Match: "Do you prefer a Senior Stylist?" [Yes] [No Preference].

UC-BOT-004: Digital Asset Delivery

  • Membership Card: Generates a dynamic Apple Wallet / Google Pay pass sent as a file attachment.
  • Welcome Offer: Sends a unique QR code image for 10% off first visit.

Main Success Scenario:

  1. User scans QR code at reception.
  2. Bot: "Welcome! What's your name?"
  3. User: "Sarah".
  4. Bot: "Hi Sarah! Here is your digital membership card."
  5. System creates Customer ID C-98712 linked to +14155551234.

Acceptance Criteria:

  1. [ ] Profile created in CRM < 5 seconds after flow completion.
  2. [ ] "Opt-in" flag recorded for GDPR/TCPA compliance.
  3. [ ] Wallet pass renders correctly on iOS and Android.

Use Case Summary

UC ID Use Case Priority
UC-BOT-001 Chat-Based Onboarding P0
UC-BOT-002 Zero-Install Signup P0
UC-BOT-003 Preference Learning P0
UC-BOT-004 Digital Asset Delivery P1