🧠 Ettaouly AI Neural Hub: API Documentation

011. Fondations & Cadre Stratégique

---

021. 🤖 The Interaction Bot (Hyper-Chat)

**Purpose:** Real-time engagement with clients on the public website and app.

- **API Endpoint:** `POST /api/ai/chat` - **Model:** `claude-3-5-sonnet-20241022` (Anthropic) - **Container:** `ettaouly_web_ai` (Isolated Microservice) - **Features:** - Real-time Streaming (Typing effect). - Multi-language support (Darija, Arabic, French, English). - Growth-oriented industrial persona.

---

032. 🔍 The Analysis Bot (Semantic Lead Engine)

**Purpose:** Background analysis of new leads for the Admin OS.

- **Internal Service:** `NeuralEngine.analyzeLead(leadId)` - **Model:** `claude-3-5-sonnet-20241022` (Upgraded from Haiku) - **Container:** `ettaouly_worker_neural` (Background Worker) - **Outputs:** - `intentScore`: Lead interest level (0-100). - `budgetProb`: Financial probability. - `conversionTiming`: Urgent vs. Nurture prediction. - `nextAction`: Strategic recommendation for sales.

---

043. 🛡️ Identity Bridge (Google One-Tap)

**Purpose:** Creating seamless sessions from Google identity tokens.

- **API Endpoint:** `POST /api/auth/google-one-tap` - **Container:** `ettaouly_web_main` - **Impact:** Automatically creates high-conversion sessions for new leads, feeding directly into the Neural analysis pipeline.

---

05🛠️ Infrastructure Overview

| Service | Container Name | Port | Access | | :--- | :--- | :--- | :--- | | Neural Chat | `ettaouly_web_ai` | 3000 | `ai.ettaoulyabdelali.com` | | Analytics Worker | `ettaouly_worker_neural` | N/A | Internal Only |

---

061. The Haiku Legacy

- **Previous Model:** `claude-3-haiku-20240307` - **Status:** Retired from real-time chat. Still available for ultra-low-cost background classification if needed. - **Role:** Was the original engine for the first-generation Lead Analyzer.

072. OpenAI Integration (Retired)

- **Reference:** Found in `app/api/_retired_webhooks/whatsapp/route.ts` - **Purpose:** Used for legacy WhatsApp bot experiments.

083. Payment & Identity SDKs

- **PayPal SDK:** `NEXT_PUBLIC_PAYPAL_CLIENT_ID` (Used in Dashboard for conversions). - **Google Indexing:** `GOOGLE_SERVICE_ACCOUNT_EMAIL` (Used for massive SEO indexing bots). - **Google Identity:** `GOOGLE_CLIENT_ID` (Used for the Google One-Tap seamless bridge).

> [!NOTE] > All AI services require the `ANTHROPIC_API_KEY` to be present in the server's `.env` file. Legacy keys for OpenAI or Google must be maintained for background scripts to function.