Widget de voz (embed) - Lovi AI Documentation

Guía: Widget de voz. No llames estos endpoints desde tu web. Los usa el iframe que carga https://widget.lovi.ai/iawidget.js con mode="voice". customer en el <script> es la access key. El loader la manda como access_key. No la pongas en repos ni capturas.

Configuración de apariencia (primer GET)

GET https://cloud.lovi.ai/functions/v1/voice-widget?id_widget={WIDGET_ID}&language={LANG}&access_key={ACCESS_KEY}

Parámetro	Quién lo pone	Descripción
`id_widget`	atributo `widget`	UUID del widget.
`language`	`language-lovi` o el navegador	`es`, `en`, …
`access_key`	atributo `customer`	Clave de compañía. La añade el script.

La respuesta es Voice-config (colores, posición, animación). No es la sesión de audio. CORS: * en GET/POST/OPTIONS.

Sesión de audio (iframe)

GET https://cloud.lovi.ai/functions/v1/voice-widget/signed-url

URL firmada ElevenLabs ConvAI + SDK. No hay start / stop públicos en window.

Otras rutas solo del iframe

No son API pública de embed:

POST /functions/v1/voice-widget/search
Feedback tras colgar
POST /functions/v1/voice-widget/handoff y POST /functions/v1/voice-widget/handoff/end
GET /functions/v1/voice-widget/chat-by-conversation

El handoff puede usar LiveKit (wss://livekit.rtc.elevenlabs.io, https://cloud-api.livekit.io).

Esto no es

GET /functions/v1/widget — config del chat. Ver Widget web.
GET /functions/v1/widgetWebView — ver WebView del widget.
POST /functions/v1/notify/voice — campaña telefónica. Ver Notificaciones de voz.

​Configuración de apariencia (primer GET)

​Sesión de audio (iframe)

​Otras rutas solo del iframe

​Esto no es

Configuración de apariencia (primer GET)

Sesión de audio (iframe)

Otras rutas solo del iframe

Esto no es