# Lumi AI — Integrations & URL Surface

> For agents that need to interact with, link to, or trigger features of the Lumi website.
> Last updated: 2026-05-08

---

## Lead Capture: GHL Chat Widget

**Provider:** GoHighLevel (GHL)
**Type:** Embedded JavaScript chat widget displayed as a floating button overlay

### Triggering the Widget

Append `?chat=open` to any page URL to auto-open the widget on load:

```
https://lumi-ar-codex.vercel.app/?chat=open
https://lumi-ar-codex.vercel.app/industries?chat=open
```

### Widget Configuration

Widget IDs are environment-controlled and language-specific:

| Env Variable | Language | Notes |
|---|---|---|
| `VITE_GHL_WIDGET_ID_AR` | Arabic | Used when lang=ar |
| `VITE_GHL_WIDGET_ID_KU` | Kurdish | Used when lang=ku |
| `VITE_GHL_CHAT_WIDGET_ID` | Fallback | Used for ro, en, and any unmatched lang |

**Agent rule:** Do NOT expose widget IDs in responses. Do NOT attempt to construct widget API calls directly. Always route lead capture to `?chat=open`.

### Privacy Rule

The chat widget is the ONLY place where customer PII (name, email, phone) should be collected. Agents must never collect, store, or relay PII directly.

---

## URL Parameters

| Parameter | Values | Effect | Example |
|-----------|--------|--------|---------|
| `?lang=` | `ar`, `ku`, `ro`, `en` | Switch display language and text direction | `/?lang=en` |
| `?chat=open` | (no value needed) | Auto-open lead capture widget | `/?chat=open` |

Parameters can be combined: `/?lang=en&chat=open`

---

## Page Routes

| Route Pattern | Description | Notes |
|---------------|-------------|-------|
| `/` | Home page | All sections: hero, demo, pricing, FAQ, etc. |
| `/industries` | Industry listing with filtering | All 13 verticals |
| `/blog` | Blog index | Static posts |
| `/blog/{slug}` | Individual blog post | See slugs below |
| `/demo/{slug}` | Phone mockup demo | See demo slugs below |
| `/admin` | Admin dashboard | Password-protected mockup — not for public agents |

### Blog Post Slugs

| Slug | Title |
|------|-------|
| `what-is-an-ai-voice-agent` | What Is an AI Voice Agent and How Does It Transform Your Customer Relationships? |
| `real-cost-of-missed-calls` | What Does a Missed Call Really Cost? |
| `ai-voice-agents-for-medical-clinics` | How Medical Clinics Use AI Voice Agents to Eliminate Missed Calls |
| `ai-receptionist-implementation-guide` | Practical Guide: How to Implement an AI Receptionist in 48 Hours |
| `ai-voice-agent-vs-chatbot` | AI Voice Agent vs. Chatbot: What's the Difference? |
| `eliminate-no-shows-beauty-salon` | How to Eliminate No-Shows in Your Salon with Voice Automation |

### Demo Slugs

Demo pages (`/demo/{slug}`) display an interactive phone mockup with an embedded GHL widget pre-configured for a specific business. Available slugs are defined in `src/mockup/demos.ts`. At time of writing, no public demo slugs are active (the `world-dentistry` demo is commented out).

---

## Home Page Anchor Links

For linking to specific sections within the home page:

| Section | Suggested Link |
|---------|---------------|
| Pricing | `/#pricing` |
| FAQ | `/#faq` |
| How It Works | `/#how-it-works` |
| Industries | `/#industries` |

Note: These are React Router hash links. The SPA rewrite in vercel.json routes all paths to `/`, so deep section links work client-side only.

---

## Machine-Readable Endpoints

| Path | Method | Response |
|------|--------|----------|
| `/llms.txt` | GET | text/markdown — short agent context |
| `/llms-full.txt` | GET | text/markdown — full agent context |
| `/AGENTS.md` | GET | text/markdown — coding agent start-here |
| `/.well-known/ai-plugin.json` | GET | application/json — plugin manifest |
| `/docs/` | GET | text/html — no-JS documentation index |
| `/sitemap.xml` | GET | application/xml — full sitemap |
| `/robots.txt` | GET | text/plain — crawl rules + Link directives |
| `/api/negotiate` | GET | Redirect to /llms.txt if Accept: text/markdown |

---

## Calendar / CRM Integration

Lumi's voice agent (the actual telephony product, not this website) connects to calendar systems (Google Calendar, Calendly, custom systems) during customer onboarding. These integrations are configured per-business and are not exposed via this website's API.

**What this website exposes:** Lead capture only (GHL chat widget). No calendar booking is available directly through the website.