Add MiniMax Voice Widget V2 - disabled by default for testing

2026-02-26 18:58:59 +01:00
parent f1fa98fbcb
commit ba775f3fb7
3 changed files with 553 additions and 0 deletions
@@ -0,0 +1,140 @@
+# 🎙️ SiteMente Voice Widget V2 - Deploy Guide
+
+A professional, Spanish-first voice assistant for SiteMente. Safe to show to clients.
+
+---
+
+## ✅ What's Ready
+
+1. **MiniMaxVoiceWidgetV2.tsx** - New component (V2)
+2. **/api/ai/voice-chat-v2** - New API endpoint
+
+---
+
+## 🚀 Quick Deploy
+
+### 1. Copy Files
+
+```bash
+# Component
+cp components/MiniMaxVoiceWidgetV2.tsx /path/to/SiteMente/components/
+
+# API
+cp -r app/api/ai/voice-chat-v2 /path/to/SiteMente/app/api/ai/
+```
+
+### 2. Enable/Disable Widget
+
+In your page or layout:
+
+```tsx
+import MiniMaxVoiceWidgetV2 from "@/components/MiniMaxVoiceWidgetV2";
+
+// Testing mode - widget OFF
+<MiniMaxVoiceWidgetV2 enabled={false} />
+
+// Production - widget ON
+<MiniMaxVoiceWidgetV2 enabled={true} />
+```
+
+Or via environment variable:
+
+```tsx
+<MiniMaxVoiceWidgetV2 enabled={process.env.NEXT_PUBLIC_VOICE_WIDGET === "true"} />
+```
+
+Then set in `.env.local`:
+```bash
+# Testing
+NEXT_PUBLIC_VOICE_WIDGET=false
+
+# Production  
+NEXT_PUBLIC_VOICE_WIDGET=true
+```
+
+---
+
+## 🎯 Behavior (Strict Spec)
+
+### Greeting
+- **Spanish:** "Hola, soy el asistente de SiteMente. ¿En qué puedo ayudarte hoy?"
+- **English:** "I can also speak English. How can I help you today?"
+
+### Rules
+- ❌ NEVER claims to be human
+- ❌ NEVER promises exact prices
+- ❌ NEVER guarantees results
+- ✅ ALWAYS guides to book a demo
+
+### If Confused
+- Spanish: "No he entendido del todo, ¿podrías repetirlo o escribirlo, por favor?"
+- English: "I didn't quite catch that. Could you repeat or type it?"
+
+---
+
+## 🧪 Testing
+
+### Internal Test (10 Rounds)
+
+Run these scenarios:
+1. "Hola" → Should respond in Spanish
+2. "How are you?" → Should switch to English
+3. "¿Cuánto cuesta?" → "desde 299€/mes"
+4. "¿Puedes hacer X?" → Guide to demo
+5. "No entiendo" → Confusion response
+6. "Quiero reserva" → Help with booking
+7. "What services?" → Brief explanation + demo
+8. Speaking in Spanish → Stay in Spanish
+9. Speaking in English → Switch to English
+10. Random noise/mumble → Confusion response
+
+### Pass Criteria
+- ✅ Voice sounds natural
+- ✅ Predictable responses
+- ✅ Safe for real clients
+- ✅ Max 2 failures in 10 rounds
+
+---
+
+## 🔧 Configuration
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `businessName` | string | "SiteMente" | Display name |
+| `businessType` | string | "restaurant" | Type for context |
+| `theme` | string | "dark" | "dark" or "light" |
+| `apiUrl` | string | "/api/ai/voice-chat-v2" | API endpoint |
+| `enabled` | boolean | true | Show/hide widget |
+
+---
+
+## 💰 Cost
+
+- **Speech Input:** FREE (Web Speech API)
+- **Speech Output:** FREE (Browser TTS)
+- **Brain:** Your MiniMax API (~€0.001/msg)
+
+**Total: Nearly zero**
+
+---
+
+## 📋 Before Showing to Clients
+
+- [ ] Run 10-round internal test
+- [ ] Verify < 2 failures
+- [ ] Check voice sounds natural
+- [ ] Test on mobile (Chrome)
+- [ ] Enable with `enabled={true}`
+
+---
+
+## 🚫 What's NOT Included (Yet)
+
+- Voice cloning
+- Emotions
+- Multi-turn complex conversations
+- Phone integration (Vapi later)
+
+---
+
+**Status: Ready for internal testing!**