Ligax AI Documentation

1. Introduction

LigaX is an AI-powered SaaS booking platform built for hair salons and stylists of all specialties. It combines online booking with an AI receptionist, hairstyle recognition, and flexible third-party integrations — all configurable per salon.

2. Getting Started

For salon owners setting up LigaX for the first time:

1. 1

   Create your account

   Go to /login and sign up with your email. Choose "Salon Owner" as your role.

2. 2

   Complete the onboarding wizard

   6 steps: Basic Info → Localization (country, currency, language) → Service Category → Service Catalog (add your services with prices) → AI Configuration → Test & Launch.

3. 3

   Set your booking page URL

   In Dashboard → Integrations → Booking Page, choose a unique slug. Your booking page will be live at ligaxai.com/book/{your-slug}.

4. 4

   Configure AI

   In Dashboard → AI Config, enable the chat assistant, adjust personality, and add custom instructions. The AI is automatically trained on your salon data.

5. 5

   Share or embed

   Copy your booking link and share it directly with clients, or embed your booking page on your existing website using the iFrame embed — all from Dashboard → Integrations.

3. Booking System

4. Service & Staff Management

5. AI Features

5a. Hairstyle Recognition (Computer Vision)

Customers upload a reference photo of the hairstyle they want. The LigaX computer vision model identifies the hairstyle type and attributes, then automatically matches the result to the salon's service catalog and shows the price. This eliminates the "what style is this?" back-and-forth that stylists deal with daily.

The system covers 50+ named styles across all hair types — braids, locs, twists, natural styles, cuts, colour, and men's styles (fades, lineups, tapers, and more). Style aliases are resolved automatically, so "Ghana braids" and "Fulani braids" both match the same service.

curl -X POST "https://api.ligaxai.com/api/classify/" \
  -F "file=@hairstyle.jpg" \
  -F "salon_id=YOUR_SALON_ID"

# Response
{
  "primary_label": "box_braids",
  "primary_confidence": 0.91,
  "labels": [
    { "label": "box_braids", "confidence": 0.91 },
    { "label": "knotless",   "confidence": 0.74 }
  ],
  "matched_service": {
    "id": "svc_abc123",
    "name": "Knotless Box Braids",
    "price": 180,
    "currency": "GBP"
  }
}

5b. AI Chat Assistant

A 24/7 virtual receptionist embedded on the salon's booking page and website. It is trained at runtime on the salon's own data — services, prices, policies, business hours, and portfolio — so every salon's assistant knows only their own information.

5c. AI Configuration

All AI settings are per-salon and configurable in Dashboard → AI Config:

6. Analytics & Insights

Available in Dashboard → Insights. All metrics are scoped to the salon's own data.

7. Developer API

The LigaX REST API lets you build custom integrations, pull booking data into your own systems, or create a fully white-labelled booking flow. All endpoints return JSON.

7a. Authentication

All API requests must include your API key in the X-API-Key header. Generate your key in Dashboard → Integrations → Developer API.

X-API-Key: hb_your_api_key_here

Base URL: https://api.ligaxai.com/api/v1

7b. Endpoints

Salon

Services

Availability

Bookings

AI Chat

7c. Error Codes

7d. Rate Limits

The API allows 1,000 requests per hour per API key. Rate limit information is returned in response headers:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 987
X-RateLimit-Reset: 1710345600

7e. Code Examples

Check availability

curl -X GET "https://api.ligaxai.com/api/v1/availability/2026-04-15" \
  -H "X-API-Key: hb_your_key_here"

Create a booking

curl -X POST "https://api.ligaxai.com/api/v1/bookings" \
  -H "X-API-Key: hb_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "service_id": "svc_abc123",
    "date": "2026-04-15",
    "time": "14:00",
    "customer_name": "Jane Doe",
    "customer_email": "jane@example.com",
    "customer_phone": "+44 7700 900000"
  }'

Python example

import requests

API_KEY = "hb_your_key_here"
BASE_URL = "https://api.ligaxai.com/api/v1"
HEADERS = {"X-API-Key": API_KEY}

# List services
services = requests.get(f"{BASE_URL}/services", headers=HEADERS).json()

# Create booking
booking = requests.post(f"{BASE_URL}/bookings", headers=HEADERS, json={
    "service_id": services["data"][0]["id"],
    "date": "2026-04-15",
    "time": "14:00",
    "customer_name": "Jane Doe",
    "customer_email": "jane@example.com",
    "customer_phone": "+44 7700 900000"
}).json()

print(booking["booking_id"])

JavaScript / Node.js

const API_KEY = 'hb_your_key_here';
const BASE_URL = 'https://api.ligaxai.com/api/v1';

const headers = { 'X-API-Key': API_KEY, 'Content-Type': 'application/json' };

// Check availability
const avail = await fetch(`${BASE_URL}/availability/2026-04-15`, { headers });
const slots = await avail.json();

// Create a booking
const res = await fetch(`${BASE_URL}/bookings`, {
  method: 'POST',
  headers,
  body: JSON.stringify({
    service_id: 'svc_abc123',
    date: '2026-04-15',
    time: slots.data[0].time,
    customer_name: 'Jane Doe',
    customer_email: 'jane@example.com',
    customer_phone: '+44 7700 900000'
  })
});
const booking = await res.json();
console.log(booking.booking_id);

8. Embedding on Your Website

8a. Floating Chat Widget In Development

Add a single script tag to any page. The AI chat widget loads automatically in the bottom-right corner — customers can browse services, upload hairstyle photos, and book appointments without leaving your site.

<!-- LigaX AI Chat Widget -->
<script src="https://api.ligaxai.com/api/embed/YOUR_SALON_ID/widget.js" defer></script>

8b. iFrame Embed

Embed the full booking page inline. Ideal for a dedicated "Book Now" page on your website.

<iframe
  src="https://ligaxai.com/book/YOUR_SLUG?embed=true"
  width="100%"
  height="640"
  frameborder="0"
  style="border-radius: 12px; border: 1px solid #e5e7eb;"
></iframe>

8c. Book Now Button

Add a styled button anywhere that links directly to your booking page.

<a href="https://ligaxai.com/book/YOUR_SLUG" target="_blank"
   style="display:inline-block;background:#9333EA;color:#fff;
          padding:12px 24px;border-radius:8px;text-decoration:none;
          font-family:sans-serif;font-weight:600;font-size:14px;">
  Book Now
</a>

8d. WordPress In Development

1. 1Install the LigaX Booking plugin from the WordPress plugin directory.
2. 2Go to Settings → LigaX and enter your API key (generated in Dashboard → Integrations → Developer API).
3. 3Add the shortcode [ligax_booking] to any page or post to embed the booking widget.

9. Webhooks & Automation

LigaX fires webhook events automatically when things happen in your salon. Point your webhook URL at Zapier, Make.com, or your own server to trigger workflows in response. Configure in Dashboard → Integrations → Automations.

9a. Available Events

9b. Payload Format

{
  "event_type": "booking.created",
  "salon_id": "6abc...xyz",
  "timestamp": "2026-04-15T14:00:00Z",
  "data": {
    "booking_id": "bk_abc123",
    "customer_name": "Jane Doe",
    "customer_email": "jane@example.com",
    "customer_phone": "+44 7700 900000",
    "service_name": "Knotless Box Braids",
    "date": "2026-04-20",
    "time": "10:00",
    "status": "confirmed",
    "source": "public_page"
  }
}

9c. Signature Verification

When a webhook secret is configured, every request includes an X-Webhook-Signature header — an HMAC-SHA256 of the raw request body signed with your secret. Verify it on your server before processing the event.

import hmac, hashlib

def verify_signature(payload_bytes: bytes, signature: str, secret: str) -> bool:
    expected = hmac.new(
        secret.encode(),
        payload_bytes,
        hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(expected, signature)

const crypto = require('crypto');

function verifySignature(rawBody, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(rawBody)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(expected),
    Buffer.from(signature)
  );
}

9d. Zapier & Make.com

Use LigaX webhooks as triggers in no-code automation platforms:

1. Zapier: Create a new Zap → Trigger: Webhooks by Zapier → "Catch Hook". Copy the provided URL → paste into Dashboard → Integrations → Automations → Webhook URL → Save.
2. Make.com: Create a scenario → Add a Webhooks module → "Custom Webhook". Copy the URL and paste it the same way.

10. LigaX Vision AI

LigaX Vision AI is the proprietary image classification pipeline that powers hairstyle recognition across the platform. It is designed specifically for the diversity of real-world hair textures, styles, and cultural contexts — from tight coils and protective styles to tapers, fades, and colour work.

10a. How It Works

The pipeline runs in two stages on every image submission:

10b. Style Coverage

50+ named styles across all hair types. All identifiers use snake_case in API responses.

10c. Performance & Limitations

10d. Inference Flow

Customer uploads image
    │
    ▼
POST /api/classify/  (multipart/form-data)
    │  salon_id + image file
    │
    ▼
Stage 1 — Recognition
    │  Identifies hairstyle type and style attributes
    │  Scores each detected style with a confidence value
    │  Primary label selected: specific style > base category > highest-confidence match
    │  Modifier labels (length, texture descriptors) never promoted to primary
    │
    ▼
Stage 2 — Synonym resolution + Service matching
    │  Style name normalised through 70+ alias mappings
    │  Resolved style matched against salon's active service catalog
    │  Closest service returned with name, price, and currency
    │
    ▼
Response: {
  primary_label, primary_confidence,
  labels[], matched_service, styling_notes
}

11. Multi-Tenant Architecture

LigaX is a multi-tenant SaaS platform. Every salon is an independent tenant with its own data, configuration, and AI context. No salon can access another's data.