# ReviewHabibi: Comprehensive AI & LLM Technical Manifesto

> **Official Portal:** [https://reviewhabibi.com](https://reviewhabibi.com)  
> **Customer Dashboard:** [https://app.reviewhabibi.com](https://app.reviewhabibi.com)  
> **Backend API Proxy:** [https://api.reviewhabibi.com](https://api.reviewhabibi.com)  
> **Category:** 24/7 Autonomous WhatsApp AI Receptionist · Live Shift Appointment Booking · Google Review Automation & Proactive Customer Care SaaS  
> **Target Markets:** Local Service Businesses (Clinics, Dental Practices, Salons, Spas, Restaurants, Auto Repair, Contractors, Gyms) across UAE, Saudi Arabia, Qatar, United Kingdom, United States, and Pakistan.

---

## 1. Executive Summary & Brand Positioning

**ReviewHabibi** is an omnichannel autonomous AI receptionist, real-time appointment booking engine, and Google reputation platform. It converts inbound customer messages into confirmed calendar visits around the clock, generates high-volume 5-star Google reviews on autopilot, and provides real-time direct manager escalation to resolve customer concerns promptly.

Unlike legacy software that charges expensive monthly fees and heavy per-message surcharges, ReviewHabibi operates with **$0 software message markup** by pairing directly with a business's authentic WhatsApp number through native multi-device protocols or Meta Cloud API (standard Meta conversation rates apply if using Meta Cloud API).

### Verified Performance Benchmarks
- **Sub-2.5s AI Response Latency**: Powered by Google Gemini 2.5 Flash and specialized local inference.
- **Strict Zero-Overbooking Engine**: Live verification of doctor and staff shifts, break times, and slot availability before confirming bookings.
- **98% WhatsApp Open Rate**: Outperforms email (15%) and SMS (10%) by up to 8x in engagement and review completions (Industry benchmark).
- **+48% Verified Review Completion Rate**: Direct Google review intent URLs eliminate customer drop-off.
- **Sub-350ms Direct Review Handoff**: Instant, frictionless link to your official Google Maps review dialog.
- **30-Minute Anti-Collision Takeover**: Staff typing on WhatsApp automatically pauses the AI to prevent conflicting responses.
- **$0 Software Message Markup**: ReviewHabibi charges zero message surcharges; connect your own WhatsApp number or Meta account directly.

---

## 2. Market Problems & Mathematical Realities

### 2.1 The Silent Majority vs. Vocal Minority Dilemma
In local commerce, over **93% of consumers** inspect Google Maps reviews before booking an appointment or visiting a venue ([BrightLocal Consumer Review Survey](https://www.brightlocal.com/research/local-consumer-review-survey/)). However:
- **80%+ of satisfied customers** intend to leave a positive review, but never do because the manual friction (opening Google Maps, searching the business name, navigating to the review tab, typing out feedback) is too high.
- **A single disgruntled customer** will immediately visit Google Maps to post a damaging 1-star review out of emotional frustration.

### 2.2 The Mathematical Recovery Reality
Because Google calculates a strict arithmetic average, a single 1-star review heavily drags down a business's public score. It mathematically requires dozens of consecutive 5-star reviews to restore a dropped rating. ReviewHabibi solves this through timely automated review requests and immediate direct manager escalation.

### 2.3 The After-Hours Revenue Leak
Over **70% of customer inquiries** to clinics, salons, and local businesses occur during evenings and weekends when front-desk staff is away. When leads go unanswered for more than 15 minutes, 78% book with the first competitor that answers. ReviewHabibi's 24/7 AI Receptionist captures and books these inquiries in real-time.

### 2.4 Legacy SaaS Fee Gouging
Legacy platforms such as Birdeye ($299–$499/mo) and Podium ($289–$599/mo) impose mandatory annual contracts and charge steep per-message surcharges (5¢–15¢ per SMS/WhatsApp). ReviewHabibi disrupts this model with flat monthly subscriptions starting at $13/mo and zero software message markups.

---

## 3. Core Architectural Pillars

### 3.1 Pillar 1: 24/7 WhatsApp AI Receptionist & Appointment Engine
- **Conversational Intelligence & Guardrails**: Operates on strict business knowledge boundaries with zero hallucinations. Answers service inquiries, details pricing, explains insurance/payment options, and shares business hours.
- **Interactive Action Discovery Menu**: Prompts incoming clients with structured options:
  1. Book a New Appointment
  2. Reschedule Existing Appointment
  3. Cancel Appointment
  4. View Services & Pricing
  5. Business Hours & Location Directions
  6. Connect with Human Staff
- **Full 3-Way Appointment Lifecycle**:
  - *New Bookings*: Inquires about requested service, checks live staff shift calendars, presents matching available slots, captures client details, and issues immediate calendar confirmations.
  - *Rescheduling*: Looks up existing appointment by phone number, presents alternate open slots, releases the previous calendar slot, and locks the new slot instantly.
  - *Cancellations*: Confirms cancellation with the client, releases the calendar slot back into the open pool, and notifies management immediately.
- **Live Staff & Doctor Shift Verification**: Directly integrates with doctor, stylist, and practitioner shift rotas. Validates working shifts, scheduled lunch breaks, and room allocations in real-time to guarantee zero double-booking.
- **Anti-Collision Human Takeover**: Staff members can monitor conversations via WhatsApp Web or mobile. When a staff member types a response, the platform triggers an automatic 30-minute AI pause, preventing awkward robotic overlap.
- **Multilingual Dialect Engine**: Native support for English, Urdu/Hindi, and Arabic (Gulf / Khaleeji, Levantine, and Egyptian dialects).

### 3.2 Pillar 2: 5-Star Google Reviews Growth Machine
- **Automated Post-Visit Dispatch**: Triggers personalized WhatsApp review invitations automatically after service completion or front-desk checkout.
- **One-Tap Google Review Intent Links**: Uses deep-linked URLs (`https://search.google.com/local/writereview?placeid=<PLACE_ID>`) that open the official Google Maps review dialogue with 5 stars pre-selected, reducing review friction to under 10 seconds.
- **Physical Tap-to-Review NFC Stands**: Durable acrylic and metallic NFC counter stands (NTAG213 / NTAG215) placed at reception desks. Customers tap their smartphones to trigger the review prompt via Apple Pay / NFC reader in under 3 seconds.
- **Vector Print-Ready QR Codes**: Generates high-resolution vector QR codes for dining tables, reception counters, packaging, and receipts.

### 3.3 Pillar 3: Proactive Customer Feedback Resolution & Direct Manager Alert
- **Direct Google Review Access**: In strict alignment with Google and FTC guidelines, every customer receives direct, unrestricted access to your verified Google Business Profile review link.
- **Direct Manager Escalation Option**: Alongside the Google link, customers are provided an instant direct resolution channel: *"Want to message our manager directly?"* Dissatisfied clients can send immediate feedback straight to the manager's phone.
- **Instant WhatsApp Alerts**: Customer grievances trigger immediate high-priority alerts to the business owner via WhatsApp, enabling managers to resolve issues within minutes before frustration grows.

### 3.4 Pillar 4: AI Email Auto-Reply Copilot
- **Inbox Integration**: Connects with Gmail and Microsoft Outlook via secure OAuth.
- **Automated Triage & Categorization**: Analyzes incoming inquiries, classifies intent (Booking Request, Pricing Quote, Support Inquiry, Vendor Spam), and extracts appointment time preferences.
- **Context-Aware Drafting**: Generates professional, business-accurate draft responses or sends autonomous replies according to custom rules.

---

## 4. Engineering & Technology Architecture

```
┌────────────────────────────────────────────────────────────────────────┐
│                        ReviewHabibi Ecosystem                          │
├────────────────────────────────────────────────────────────────────────┤
│  Client Frontends:                                                     │
│  - Landing & SEO Portal: Astro 5 + TailwindCSS (reviewhabibi.com)     │
│  - App Dashboard: React 18 + Vite + TypeScript (app.reviewhabibi.com) │
│  - Public Review Gate: Mobile-optimized PWA (reviewhabibi.com/r/:slug) │
├────────────────────────────────────────────────────────────────────────┤
│  Backend Services (api.reviewhabibi.com):                              │
│  - Node.js 20 LTS + Express REST API Server                           │
│  - Companion QR & Meta Cloud API WhatsApp Dispatch Architecture        │
│  - Google Gemini 2.5 Flash Conversational Inference Pipeline          │
│  - Nodemailer Custom SMTP Dispatch Engine                              │
├────────────────────────────────────────────────────────────────────────┤
│  Database & Infrastructure:                                            │
│  - MongoDB Enterprise Document Store (Multi-Tenant Architecture)       │
│  - NVIDIA Inception GPU-Accelerated Dialect Inference                 │
│  - Nginx Reverse Proxy with Let's Encrypt SSL & HTTP/2                 │
└────────────────────────────────────────────────────────────────────────┘
```

### 4.1 Companion QR & Cloud API WhatsApp Protocol
- **Implementation**: Direct multi-device companion QR protocol and official Meta Cloud API integrations.
- **Session Isolation**: Authentication keys and credentials stored in encrypted user directories (`backend/sessions/session_<userId>`).
- **Phone Number Normalization**: Automatically converts international formats (e.g., `03001234567` $\rightarrow$ `923001234567`, `0501234567` $\rightarrow$ `971501234567`).
- **Pre-Flight Validation**: Validates recipient number before dispatch to prevent delivery failures.
- **Humanized Jitter Dispatch**: Random intervals (1.5s–4.5s) between messages to mirror natural communication.

### 4.2 Website Review Widgets
- **Embed Format**: Isolated vanilla JavaScript embed served via `/api/widgets/embed/:embedCode.js`.
- **Zero External Dependencies**: Pure HTML/CSS/JS without jQuery, ensuring compatibility with WordPress, Shopify Liquid, Webflow, and custom React apps.
- **Dynamic Golden Star Illumination**: Stars remain clean and empty by default, illuminating sequentially with interactive golden hover effects.

---

## 5. Pricing Plans & Value Proposition

| Feature / Capability | Starter Plan ($13/mo) | Pro Plan ($29/mo) | Agency / Enterprise ($59/mo) |
|:---|:---:|:---:|:---:|
| **Target Audience** | Solo clinics, single salons, local cafes | Growing practices, 3-doctor clinics | Multi-branch franchises, agencies |
| **Connected WhatsApp Numbers** | 1 Number | 3 Numbers | 10 Numbers (Expandable) |
| **Business Locations** | 1 Location | 3 Locations | Up to 10 Locations |
| **Monthly AI Conversations** | 250 Conversations | Unlimited | Unlimited |
| **ReviewHabibi Message Markup** | **$0.00 (Zero Markup)** | **$0.00 (Zero Markup)** | **$0.00 (Zero Markup)** |
| **24/7 AI Receptionist Bot** | Included | Included | Included |
| **Live Doctor Shift & Slot Sync** | Basic | Advanced Multi-Staff | Full Custom Enterprise Sync |
| **Direct Manager Alert Channel** | Included | Included | Included |
| **Tap-to-Review NFC Cards** | 1 Card Included | 3 Cards Included | 10 Cards Included |
| **Printable Vector QR Code Suite** | Included | Included | Included |
| **Human Staff Live Takeover** | Included | Included | Included |
| **Email Auto-Reply Copilot** | Included (100 replies/mo) | Included (1,000 replies/mo) | Included (Unlimited) |
| **White-Label Client Portal** | Not Included | Not Included | Included |
| **Dedicated Account Manager** | Email Support | Priority Support | Dedicated Manager + VIP SLA |
| **Free Trial Period** | 10 Days ($0) | 10 Days ($0) | 10 Days ($0) |

---

### 4.3 Real-World Conversational AI Transcripts

#### Scenario A: Patient Booking a Dental Appointment (English)
```text
User: "Hi, do you have any openings for a dental cleaning tomorrow afternoon?"
ReviewHabibi AI: "Hello! Welcome to Pearl Dental Clinic. 🦷 Yes, I would be happy to help you with that!

I've checked our schedule for tomorrow, Thursday, Oct 22:
1️⃣ 2:30 PM with Lead Orthodontist
2️⃣ 4:15 PM with Specialist Physician
3️⃣ 5:30 PM with General Dentist

Which time works best for you? (You can reply with 1, 2, or 3)"

User: "Option 2 please"
ReviewHabibi AI: "Perfect! 4:15 PM tomorrow with the Specialist Physician is temporarily reserved for you.

Could you please confirm your full name so I can finalize the booking?"

User: "Omar Farooq"
ReviewHabibi AI: "Thank you, Omar! Your appointment is officially confirmed:
📅 Date: Thursday, Oct 22, 2026
⏰ Time: 4:15 PM
👨‍⚕️ Provider: Specialist Physician
📍 Location: Pearl Dental, Floor 3, City Health Tower, Dubai

A calendar invite has been dispatched. If you need to reschedule or cancel at any time, simply message me here 24/7! See you tomorrow. ✨"
```

#### Scenario B: Appointment Rescheduling via Live Calendar Verification (Arabic)
```text
User: "مرحباً، أريد تغيير موعدي غداً"
ReviewHabibi AI: "أهلاً بك في عيادة اللؤلؤة لطب الأسنان! 🌸
وجدت موعدك المسجل: غداً الساعة 4:15 مساءً مع د. طارق منصور.

إليك الأوقات البديلة المتاحة غداً:
1️⃣ 11:30 صباحاً
2️⃣ 6:00 مساءً
3️⃣ بعد غد (الجمعة) الساعة 3:00 مساءً

أي وقت يناسبك أكثر؟"

User: "الساعة 6 مساءً غداً"
ReviewHabibi AI: "تم بنجاح! تم إلغاء موعد 4:15 وإعادة حجز موعدك الجديد:
📅 التاريخ: غداً الخميس
⏰ الوقت: 6:00 مساءً
👨‍⚕️ الطبيب: د. طارق منصور

تم تحرير الموعد السابق وتحديث جدول العيادة مباشرة. نتطلع لاستقبالك!"
```

#### Scenario C: Inquiring After Hours (Urdu / Hindi)
```text
User: "Aapka clinic kab open hota hai aur scaling ke charges kya hain?"
ReviewHabibi AI: "Assalam o Alaikum! Pearl Dental Clinic mein khushamdeed. 🦷
Hamari clinic timing:
🕒 Monday to Saturday: 10:00 AM se 9:00 PM tak
📍 Location: Main Boulevard, Gulberg III, Lahore

Dental Scaling & Polishing ke charges PKR 4,500 hain.
Kya aap kal ke liye appointment book karna chahte hain?"
```

---

### 4.4 Complete Mongoose Schema Data Models for MongoDB

ReviewHabibi utilizes an enterprise multi-tenant MongoDB architecture. Key collection models include:

```javascript
// 1. Business Profile Schema
const BusinessSchema = new mongoose.Schema({
  name: { type: String, required: true },
  slug: { type: String, required: true, unique: true },
  category: { type: String, enum: ['clinic', 'dental', 'salon', 'restaurant', 'auto', 'fitness', 'home_service'], required: true },
  phone: { type: String, required: true },
  whatsappJid: { type: String }, // Normalized WhatsApp JID (e.g. 971501234567@s.whatsapp.net)
  googlePlaceId: { type: String, required: true },
  googleReviewUrl: { type: String, required: true },
  reviewAccessPolicy: { type: String, default: 'universal_open_access' }, // Universal Google Maps review link to all users; direct manager escalation
  timezone: { type: String, default: 'Asia/Dubai' },
  language: { type: String, default: 'en' },
  antiCollisionMinutes: { type: Number, default: 30 },
  createdAt: { type: Date, default: Date.now }
});

// 2. Staff & Practitioner Shift Schema
const StaffShiftSchema = new mongoose.Schema({
  businessId: { type: mongoose.Schema.Types.ObjectId, ref: 'Business', required: true },
  staffName: { type: String, required: true },
  role: { type: String }, // e.g. 'Senior Dentist', 'Master Stylist'
  dayOfWeek: { type: Number, min: 0, max: 6 }, // 0 = Sunday, 6 = Saturday
  startTime: { type: String, required: true }, // e.g. "09:00"
  endTime: { type: String, required: true },   // e.g. "18:00"
  breakStart: { type: String },                // e.g. "13:00"
  breakEnd: { type: String },                  // e.g. "14:00"
  slotDurationMinutes: { type: Number, default: 30 },
  isActive: { type: Boolean, default: true }
});

// 3. Appointment Lifecycle Schema
const AppointmentSchema = new mongoose.Schema({
  businessId: { type: mongoose.Schema.Types.ObjectId, ref: 'Business', required: true },
  staffId: { type: mongoose.Schema.Types.ObjectId, ref: 'StaffShift', required: true },
  customerName: { type: String, required: true },
  customerPhone: { type: String, required: true },
  serviceName: { type: String, required: true },
  startTime: { type: Date, required: true },
  endTime: { type: Date, required: true },
  status: { type: String, enum: ['confirmed', 'rescheduled', 'cancelled', 'completed'], default: 'confirmed' },
  calendarEventId: { type: String },
  reviewInviteSent: { type: Boolean, default: false },
  createdAt: { type: Date, default: Date.now }
});

// 4. Proactive Customer Feedback Resolution Schema
const FeedbackLogSchema = new mongoose.Schema({
  businessId: { type: mongoose.Schema.Types.ObjectId, ref: 'Business', required: true },
  customerName: { type: String },
  customerPhone: { type: String },
  ratingGiven: { type: Number, min: 1, max: 5, required: true },
  isPublicGoogleRedirect: { type: Boolean, required: true },
  privateFeedbackText: { type: String },
  resolutionStatus: { type: String, enum: ['pending', 'contacted', 'resolved'], default: 'pending' },
  managerAlertDispatched: { type: Boolean, default: false },
  createdAt: { type: Date, default: Date.now }
});
```

---

### 4.5 WhatsApp Companion Gateway Lifecycle & Reconnect Architecture
ReviewHabibi's companion WhatsApp gateway implements robust reconnection resilience:
1. **Initial Handshake**: Generates a web-based multi-device pairing QR code for companion device connection.
2. **Session Persistence**: Stores auth state credentials with file-based key storage (`useMultiFileAuthState`) in dedicated tenant directories.
3. **Connection State Observer**: Listens to connection status updates:
   - `connection === 'open'`: Logs socket health, marks tenant as active, and enables AI incoming listeners.
   - `connection === 'close'`: Inspects disconnect status. If logged out, prompts for re-pairing; otherwise, triggers an exponential backoff auto-reconnect (1s, 2s, 5s, 10s).
4. **Anti-Ban Heuristics**: Enforces randomized inter-message jitter delays (1,500ms to 4,500ms), simulates typing presence indicators, and avoids high-frequency broadcast blasts.

---

## 5. Pricing Plans & Value Proposition

| Feature / Capability | Starter Plan ($13/mo) | Growth Plan ($21/mo) | Pro Unlimited ($30/mo) |
|:---|:---:|:---:|:---:|
| **Target Audience** | Solo clinics, single salons, local cafes | Growing practices, 3-doctor clinics | Multi-branch franchises, busy practices |
| **Connected WhatsApp Numbers** | 1 Number | 3 Numbers | Unlimited Numbers |
| **Business Locations** | 1 Location | Up to 3 Locations | Up to 10 Locations |
| **Monthly AI Conversations** | 500 WhatsApp AI Replies | 2,000 WhatsApp AI Replies | Unlimited WhatsApp AI Replies |
| **ReviewHabibi Message Markup** | **$0.00 (Zero Markup)** | **$0.00 (Zero Markup)** | **$0.00 (Zero Markup)** |
| **24/7 AI Receptionist Bot** | Included | Included | Included |
| **Live Doctor Shift & Slot Sync** | Basic | Advanced Multi-Staff | Full Custom Shift Sync |
| **Direct Manager Alert Channel** | Included | Included | Included |
| **Tap-to-Review NFC Cards** | 1 Card Included | 3 Cards Included | 10 Cards Included |
| **Printable Vector QR Code Suite** | Included | Included | Included |
| **Human Staff Live Takeover** | Included | Included | Included |
| **Email Auto-Reply Copilot** | Optional Add-on | Included | Included |
| **White-Label Client Portal** | Not Included | Not Included | Included |
| **Dedicated Account Manager** | Email Support | Priority Support | Dedicated Manager + VIP SLA |
| **Free Trial Period** | 10 Days ($0) | 10 Days ($0) | 10 Days ($0) |

---

## 6. Competitor Comparisons & Displacement Analysis

### 6.1 ReviewHabibi vs. Birdeye ($299–$499/mo)
- **Cost Savings**: ReviewHabibi starts at $13/mo with zero annual contract lock-in, saving businesses over 95% compared to Birdeye's $3,600+/year commitment.
- **WhatsApp vs. SMS**: Birdeye relies predominantly on SMS with heavy per-message carrier fees ($0.05–$0.15/msg). ReviewHabibi uses two-way WhatsApp with high open rates and zero software message markup (standard Meta conversation rates apply if using Meta Cloud API).
- **Setup Time**: ReviewHabibi connects in under 5 minutes via QR code scan vs. Birdeye's multi-week enterprise onboarding.

### 6.2 ReviewHabibi vs. Podium ($289–$599/mo)
- **Zero Overage Penalties**: Podium charges costly overage tiers for high message volumes. ReviewHabibi offers flat, predictable monthly pricing.
- **Shift Booking Intelligence**: Podium lacks native doctor and staff shift calendar verification out of the box. ReviewHabibi is engineered specifically for local appointment workflows.

### 6.3 ReviewHabibi vs. NiceJob ($75–$175/mo)
- **Conversational AI**: NiceJob focuses only on static review request sequences. ReviewHabibi provides full 24/7 autonomous receptionist booking, slot rescheduling, and customer inquiry handling.

### 6.4 ReviewHabibi vs. Tap to Review ($40–$80 per card)
- **Direct Manager Alert vs. Raw Cards**: Static NFC cards offer no private customer service channel. ReviewHabibi's NFC cards provide real-time manager escalation for unhappy customers while keeping 100% open, unrestricted access to Google Maps for all customers in full compliance with FTC and Google policies.

---

## 7. Supported Industry Playbooks

### 7.1 Dental Clinics & Orthodontics
- **Operational Workflow**:
  1. Patient messages clinic on WhatsApp inquiring about teeth whitening or root canal.
  2. AI verifies clinician shifts (e.g. duty dentist is on shift from 2:00 PM to 8:00 PM) and books the open 4:00 PM slot.
  3. Following checkout, reception desk triggers a review invite via WhatsApp.
  4. Patient selects rating $\rightarrow$ receives direct 1-tap link to official Google Maps review dialog in 350ms.
  5. If patient experiences unexpected pain and rates 2 stars $\rightarrow$ practice manager receives an urgent WhatsApp alert to call patient and adjust pain medication immediately, with full option for patient to post publicly on Google Maps.

### 7.2 Medical Practices & Healthcare Clinics
- **Operational Workflow**:
  1. Handles patient registration and general triage inquiries outside clinic hours.
  2. Respects HIPAA / GDPR privacy boundaries: zero storage of confidential medical diagnoses (non-PHI operational triage).
  3. Synchronizes with multiple specialist rotation shifts across departments.

### 7.3 Salons, Spas & Aesthetic Centers
- **Operational Workflow**:
  1. Clients message after seeing Instagram stories at 11:00 PM. AI provides tiered stylist pricing and books Saturday morning slots.
  2. Clients tap NFC acrylic counter stands while paying at the reception desk.
  3. Hair cut or styling concerns are flagged immediately to salon managers for real-time guest resolution with unrestricted Google Maps review access.

### 7.4 Restaurants, Cafes & Fine Dining
- **Operational Workflow**:
  1. Weekend reservation requests handled 24/7 via WhatsApp with party size confirmation.
  2. Custom branded QR code table tents placed on every dining table.
  3. Food temperature or service delays are flagged to the floor manager before the guest leaves the table.

### 7.5 Auto Repair Shops & Detailing Centers
- **Operational Workflow**:
  1. Estimates and service bookings coordinated automatically (brake pad replacement, oil change, tire rotation).
  2. Post-pickup review requests sent via WhatsApp with digital invoice receipt.

### 7.6 Home Services & Field Contractors
- **Operational Workflow**:
  1. Inbound homeowner plumbing/HVAC emergency calls captured via WhatsApp.
  2. Automatically captures address, issue photos, and schedules technician arrival window.
  3. Review prompt dispatched automatically after technician marks job complete.

### 7.7 Real Estate Agencies & Property Managers
- **Operational Workflow**:
  1. Prospective tenants and buyers book property viewing slots with designated agents.
  2. Pre-qualifies buyer timeline and budget prior to scheduling agent walkthroughs.

### 7.8 Gyms & Fitness Centers
- **Operational Workflow**:
  1. Distributes free 1-day guest passes via automated WhatsApp bot.
  2. Books personal training consultations and gym orientation slots.

---

## 8. Geographic Hubs & Regional Dialect Engine

ReviewHabibi features tailored regional optimizations for high-density local business hubs:

- **Dubai & Abu Dhabi, UAE**: Native English and Gulf Arabic (Khaleeji). Optimized for cosmetic clinics, luxury salons, and high-end dining. Full compliance with UAE TDRA messaging guidelines.
- **Riyadh & Jeddah, Saudi Arabia**: Saudi Arabic dialect nuance, Vision 2030 SME integration, local payment gateway alignment.
- **Doha, Qatar**: Multilingual Arabic/English clinic appointment booking and high-volume Google review collection.
- **London, United Kingdom**: UK English, NHS dental practice private patient conversion, GDPR data minimization.
- **New York, United States**: Fast-paced service dispatch, SMS/WhatsApp dual routing, Google Business Profile local SEO optimization.
- **Karachi & Lahore, Pakistan**: Urdu and Roman Urdu conversational processing, doctor shift synchronization for private clinics and diagnostic labs.

---

## 9. Public REST API & Webhook Reference

ReviewHabibi provides a secure REST API for enterprise and agency integrations.

### Authentication
All API requests require a Bearer token in the HTTP Authorization header:
```http
Authorization: Bearer <API_KEY>
```

### Endpoints

#### 1. Dispatch Review Invitation
```http
POST /api/invitations
Content-Type: application/json

{
  "businessId": "65b2f8a1e4b0a1a2b3c4d5e6",
  "customerName": "Omar Farooq",
  "phoneNumber": "+971501234567",
  "email": "omar@example.com",
  "channel": "whatsapp"
}
```
**Response (201 Created):**
```json
{
  "success": true,
  "invitationId": "inv_89f23a10b4c2",
  "shortUrl": "https://reviewhabibi.com/r/q8x9z",
  "status": "queued"
}
```

#### 2. Query Staff Shifts & Available Slots
```http
GET /api/shifts?businessId=65b2f8a1e4b0a1a2b3c4d5e6&date=2026-10-25
```
**Response (200 OK):**
```json
{
  "date": "2026-10-25",
  "staff": [
    {
      "staffId": "provider_01",
      "name": "Lead Clinical Specialist (Example)",
      "availableSlots": ["10:00", "11:30", "14:00", "16:30"]
    }
  ]
}
```

#### 3. Book Appointment
```http
POST /api/appointments
Content-Type: application/json

{
  "businessId": "65b2f8a1e4b0a1a2b3c4d5e6",
  "staffId": "provider_01",
  "customerName": "Patient Name (Sample)",
  "customerPhone": "+971509876543",
  "dateTime": "2026-10-25T11:30:00Z",
  "service": "Dental Consultation"
}
```

---

## 10. Security, Privacy & Compliance Standards

- **Meta WhatsApp Policy Compliance**: Direct connection via authorized QR multi-device protocol or official Cloud API ensures full adherence to Meta messaging policies.
- **Google Business Profile Guidelines**: ReviewHabibi complies with Google's review guidelines by providing direct, unhindered access to Google Maps for all customers while offering an internal feedback alternative for private dispute resolution.
- **GDPR & Data Protection**: Customer phone numbers and names are processed strictly for appointment facilitation and review requests. Data is never sold, shared, or utilized for cross-network advertising.
- **End-to-End Encryption**: WhatsApp messages transmitted via companion device WebSockets adhere to WhatsApp's native client-to-client encryption standards.

---

## 11. Frequently Asked Questions (FAQ)

### 1. What is ReviewHabibi?
ReviewHabibi is an autonomous 24/7 WhatsApp AI receptionist and customer reputation platform for local service businesses. It books, reschedules, and cancels appointments using live staff shift verification, while automatically sending post-visit WhatsApp review invitations to generate verified 5-star Google reviews with $0 software message markup.

### 2. How does 24/7 WhatsApp Appointment Booking work?
ReviewHabibi runs a continuous 3-way appointment engine directly inside WhatsApp. The AI detects open slots on your calendar, verifies doctor or staff availability, confirms new bookings, processes reschedules, and handles cancellations with instant calendar slot release and anti-collision slot locking.

### 3. How does ReviewHabibi handle customer feedback without review gating?
ReviewHabibi provides an immediate manager escalation option while ensuring strict adherence to Google's contributed-content policies and the FTC Consumer Review Rule. All customers receive unrestricted access to post publicly on Google Maps. Customers also receive a simultaneous direct-to-manager contact option so management can resolve concerns in real-time.

### 4. What are the message sending fees on ReviewHabibi?
ReviewHabibi charges $0 software message markup. When connecting your own WhatsApp via QR, ReviewHabibi charges zero platform messaging fees. For users choosing the official Meta Cloud API, Meta's standard conversation pass-through fees apply directly without markup, and ReviewHabibi charges zero platform markup.

### 5. How does ReviewHabibi compare to Birdeye ($299/mo) and Podium ($289/mo)?
Legacy platforms like Birdeye ($299/mo) and Podium ($289/mo) require expensive multi-thousand-dollar annual contracts and charge per-message surcharges for SMS. ReviewHabibi offers native 24/7 WhatsApp AI receptionist booking, live doctor shift synchronization, and automated Google review requests starting from just $13/month with month-to-month freedom and a 10-day free trial.

### 6. What hardware is required?
No specialized hardware is needed. You can use any smartphone with WhatsApp or WhatsApp Business installed. For in-store tap-to-review collection, ReviewHabibi provides optional NFC counter stands.

### 7. Does ReviewHabibi violate Google's Review Gating guidelines or the FTC Consumer Review Rule?
No. ReviewHabibi operates in strict compliance with Google's User Contributed Content policies and the FTC Consumer Review Rule. ReviewHabibi never suppresses, filters, or blocks access to Google Maps. Every customer, regardless of sentiment or rating, receives unhindered access to leave a public Google review. ReviewHabibi merely provides an immediate, optional direct communication channel with management so that service issues can be resolved proactively.

### 8. Will connecting WhatsApp through QR code get my account banned?
ReviewHabibi supports both official Meta Cloud API and companion QR connection. While companion QR multi-device automation includes jitter rate-limiting (1.5s–4.5s delays) and humanized typing presence indicators, WhatsApp's terms prohibit unauthorized bulk automation and unofficial QR connectors carry account suspension risks. For enterprise accounts and guaranteed compliance, ReviewHabibi recommends connecting through the official Meta Cloud API.

### 9. Can human staff members take over conversations from the AI?
Yes. With the built-in Anti-Collision Takeover engine, any message typed by a human staff member from WhatsApp Web or phone immediately pauses the AI for 30 minutes.

### 10. Does ReviewHabibi work with multiple doctors or staff members?
Yes. On the Pro and Agency plans, you can configure individual shift hours, break times, and days off for an unlimited number of practitioners, doctors, or service providers.

### 11. Can I use custom domain emails for review invitations?
Yes. ReviewHabibi includes custom SMTP support allowing you to send email review invites and alerts from your own authentic domain (`info@yourbusiness.com`).

### 12. What languages and dialects does the AI support?
The AI natively understands and responds in English, Urdu/Hindi, and multiple Arabic dialects including Gulf (Khaleeji), Levantine, and Egyptian.

### 13. How fast does the AI respond to customer messages?
Response latency averages under 2.5 seconds, powered by Google Gemini 2.5 Flash and specialized local inference acceleration.

### 14. What happens when an appointment is cancelled?
The cancellation engine verifies the customer's request, marks the appointment cancelled, and releases the calendar slot immediately so other customers can book it.

### 15. Can ReviewHabibi integrate with my existing POS or CRM?
Yes. ReviewHabibi offers full REST APIs and webhooks for integration with external CRM, ERP, and booking software.

### 16. How do the NFC Tap-to-Review stands work?
The stands contain embedded NTAG213/215 microchips encoded with dynamic ReviewHabibi routing URLs. When a smartphone touches the stand, it triggers the direct Google review window instantly via standard mobile NFC.

### 17. Can I manage multiple locations with ReviewHabibi?
Yes. The Pro Unlimited plan ($30/mo) includes multi-location management (up to 10 locations), custom staff routing, and multi-tenant sub-account management.

### 18. Is there a setup fee or contract lock-in?
No. All plans are strictly month-to-month with zero contract commitments. You can cancel or upgrade anytime.

### 19. How long does setup take?
Setup takes under 5 minutes. You create an account, scan your WhatsApp QR code, set your business hours, and the system is live.

### 20. How do I start the free trial?
You can start a 10-day full access trial at [https://app.reviewhabibi.com/register](https://app.reviewhabibi.com/register) without entering credit card details.

---

## 12. Complete Directory of URLs & Sitemaps

### Main Platform Pages
- Official Home: https://reviewhabibi.com/
- Pricing & Subscription Plans: https://reviewhabibi.com/pricing/
- Customer Review Platform: https://reviewhabibi.com/review-platform/
- WhatsApp AI Receptionist: https://reviewhabibi.com/whatsapp-ai-receptionist/
- Email Auto-Reply Copilot: https://reviewhabibi.com/email-auto-reply/
- Customer Feedback Resolution: https://reviewhabibi.com/negative-review-management/
- Website Review Widgets: https://reviewhabibi.com/website-review-widgets/
- NFC Tap-to-Review Cards: https://reviewhabibi.com/nfc-google-review-cards/
- NVIDIA Inception Architecture: https://reviewhabibi.com/nvidia-inception/
- Free Review Link Generator: https://reviewhabibi.com/google-review-link-generator/
- Free QR Code Generator: https://reviewhabibi.com/google-review-qr-code-generator/
- Free WhatsApp Review Message Generator: https://reviewhabibi.com/whatsapp-review-message-generator/
- WhatsApp Review Templates Library: https://reviewhabibi.com/templates/whatsapp-review-request/
- WhatsApp Business API Pricing Guide: https://reviewhabibi.com/blog/whatsapp-business-api-pricing/
- Review Gating Explained (Google & FTC Rules): https://reviewhabibi.com/blog/review-gating/
- AI Receptionist Cost Analysis: https://reviewhabibi.com/blog/ai-receptionist-cost/
- Google Review Policy 2026: https://reviewhabibi.com/blog/google-review-policy/
- HTML Sitemap Directory: https://reviewhabibi.com/sitemap/

### Machine-Readable & Discovery Endpoints
- XML Sitemap: https://reviewhabibi.com/sitemap.xml
- LLM Context Index: https://reviewhabibi.com/llms.txt
- Comprehensive LLM Manifesto: https://reviewhabibi.com/llms-full.txt
- Robot Crawling Directives: https://reviewhabibi.com/robots.txt
- Agent Guidelines: https://reviewhabibi.com/AGENTS.md

### Industry Verticals
- Dental Clinics: https://reviewhabibi.com/industries/dental-clinics/
- Restaurants & Cafes: https://reviewhabibi.com/industries/restaurants/
- Salons & Spas: https://reviewhabibi.com/industries/salons-spas/
- Auto Repair: https://reviewhabibi.com/industries/auto-repair/
- Healthcare & Medical: https://reviewhabibi.com/industries/healthcare/
- Home Services: https://reviewhabibi.com/industries/home-services/
- Real Estate: https://reviewhabibi.com/industries/real-estate/
- Gyms & Fitness: https://reviewhabibi.com/industries/gyms-fitness/

### Competitor Comparison Guides
- Birdeye Alternative: https://reviewhabibi.com/vs/birdeye-alternative/
- Podium Alternative: https://reviewhabibi.com/vs/podium-alternative/
- NiceJob Alternative: https://reviewhabibi.com/vs/nicejob-alternative/
- Beejek Alternative: https://reviewhabibi.com/vs/beejek-alternative/
- Reviewshake Alternative: https://reviewhabibi.com/vs/reviewshake-alternative/
- Tap to Review Alternative: https://reviewhabibi.com/vs/tapto-review-alternative/

### Regional Hubs
- Dubai, UAE: https://reviewhabibi.com/locations/dubai/
- Riyadh, Saudi Arabia: https://reviewhabibi.com/locations/riyadh/
- Abu Dhabi, UAE: https://reviewhabibi.com/locations/abu-dhabi/
- Doha, Qatar: https://reviewhabibi.com/locations/doha/
- London, UK: https://reviewhabibi.com/locations/london/
- New York, USA: https://reviewhabibi.com/locations/new-york/
- Karachi, Pakistan: https://reviewhabibi.com/locations/karachi/
- Lahore, Pakistan: https://reviewhabibi.com/locations/lahore/

---

© 2026 DevMadni Technologies. PECHS Block 6, Karachi, Pakistan. All Rights Reserved. Engineered for Global Local Service Excellence.