🌐 Feature Manual: Vernacular WhatsApp & Branding Showcase
← Docs Index Open Live Showcase ↗
Help Center / Feature Library / Vernacular & Showcase

Vernacular WhatsApp Self-Care & Branding Showcase

Complete operations guide for tri-lingual WhatsApp customer self-care (English, Hindi, Gujarati), explicit language confirmation, dynamic mid-session switching, and the high-converting SaaS product showcase page.

1. Overview & Business Value

In regional Indian telecom and FTTH markets, subscribers frequently encounter friction when interacting with English-only digital chatbots. ConnectCare eliminates this barrier by providing automated, authentic tri-lingual self-care across English, हिन्दी (Hindi), and ગુજરાતી (Gujarati).

Simultaneously, ConnectCare provides an enterprise marketing & showcase webpage (branding.html) designed for prospective tenants, franchise partners, and subscribers. It features high-resolution authenticated screenshots of core UI operations (Complaints, Field Engineer Management, and Network Connectivity Diagnostics), an intuitive 3-step walkthrough, and interactive simulators.

2. WhatsApp Vernacular Architecture & State Machine

Subfeature 8.1: Language Prompt on First Contact (sendLanguageMenu)

When a subscriber texts the WhatsApp number for the first time, or sends a conversational greeting ("Hi", "Hello", "Kem Cho", "Namaste"), the engine intercepts the greeting and sends an interactive Meta List Message with 3 language options:

Language Option Row ID Title (≤ 24 chars) Description (≤ 72 chars)
English lang_en English Continue in English
हिन्दी (Hindi) lang_hi हिन्दी (Hindi) हिन्दी में आगे बढ़ें
ગુજરાતી (Gujarati) lang_gu ગુજરાતી (Gujarati) ગુજરાતીમાં આગળ વધો

Subfeature 8.2: Explicit Language Confirmation & Database Persistence

Upon receiving the customer's selection, the state machine in api/whatsapp/conversation.php executes the following atomic sequence:

  1. Dispatches an immediate acknowledgment in the selected native script (e.g. ✅ ભાષાની પુષ્ટિ થઈ: ગુજરાતી. તમારી પસંદગી સાચવવામાં આવી છે. or ✅ भाषा की पुष्टि: हिन्दी। आपकी भाषा सहेजी गई है।).
  2. Persists the selected language code (en, hi, or gu) to whatsapp_conversations.language and customer_profiles.language (applied via Database Migration 024).
  3. Renders the localized Main Menu (sendWhatsAppMenu) entirely in the confirmed vernacular script.
💡 Meta Character Limits Strict Compliance: Every row title across all localized submenus (Complaint Types, Connection Issues, Speed Tests, and Feedback) strictly complies with the Meta WhatsApp Cloud API limit of 24 characters maximum, preventing webhook dispatch rejections.

Subfeature 8.3: Dynamic Mid-Session Language Switching

Subscribers can change their language preference at any point during active conversations without losing their ticket progress or resetting their session:

3. Enterprise Product Showcase (branding.html)

Subfeature 8.4: High-Resolution Real UI Screenshots (≤ 100 KB Strict Asset Cap)

To demonstrate real system functionality rather than abstract wireframes, the showcase embeds high-resolution authenticated screenshots captured directly from production:

UI Section Asset File Path Optimized Size Key Visual Elements Highlighted
Complaints Desk assets/screenshots/complaints-ui.png 93.5 KB Outage radar banner, live ticket table, status pills, SLA timers, SuperAdmin tenant switcher.
Field Engineer Addition assets/screenshots/field-engineer-addition-ui.png 96.5 KB Tenant administration table, Field Engineers staff directory, "+ Add Field Engineer" modal, Resend WhatsApp OTP.
Connectivity Diagnostics assets/screenshots/connectivity-test-ui.png 51.5 KB Zero-auth browser line speed & latency test, 4 diagnostic telemetry cards, auto-stamped case notes.
Staff & PIN Sign-In assets/screenshots/staff-login-ui.png 88.9 KB Dual Google SSO and Staff PIN login, WhatsApp OTP setup dialog.
Technician Workstation assets/screenshots/technician-desk-ui.png 25.9 KB Mobile-first work order list, shift punch-in, GPS check-in, optical dBm entry.
🚀 Asset Optimization Guarantee: All images are 256-color adaptive palette quantized PNGs, guaranteeing file sizes strictly ≤ 100 KB for lightning-fast mobile loading on 3G/4G connections.

Subfeature 8.5: "How Customer Can Make Use of Simple UI" Guide

The showcase outlines the frictionless 3-step customer journey:

  1. Step 1: 1-Click Zero-Login Access — Customers text WhatsApp or open the public tracking link. No username or password registration required.
  2. Step 2: Instant Line Diagnostics — Run browser-based latency and throughput checks directly against the ISP's regional probe.
  3. Step 3: 4-Stage Visual Progress Stepper — Real-time tracking from Ticket Logged → Field Technician Dispatched → Premises Arrival → Restored & Rated.

Subfeature 8.7: Mobile Viewport Confinement & Privacy-Preserving UI Mockups

The public home and showcase portal includes dedicated mobile ergonomics and privacy protections:

Subfeature 8.6: Interactive Live Simulators

4. Related System Links & Manuals