> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lovi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Widget de voz (embed)

> El script iawidget.js pide la configuración del widget de voz y abre una sesión de audio en el navegador.

El integrador **no llama a este endpoint a mano**. Lo usa `https://widget.lovi.ai/iawidget.js` cuando el script lleva `mode="voice"`.

Guía de instalación: [Widget de voz](/es/user-guide/Setting/ug_voicewidget_es).

## Obtener la configuración

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

| Parámetro    | Requerido               | Descripción                                                    |
| ------------ | ----------------------- | -------------------------------------------------------------- |
| `id_widget`  | Sí                      | UUID del widget. En el HTML es el atributo `widget`.           |
| `language`   | No                      | Idioma de las traducciones (`es`, `en`, …).                    |
| `access_key` | Sí (lo añade el script) | Clave de la compañía. No la copies a repositorios ni capturas. |

La respuesta incluye la configuración de apariencia (`Voice-config`: colores, posición, animación) y los datos de sesión de audio que necesita el embed.

Esto **no** es:

* `GET /functions/v1/widgetWebView` — chat en iframe. Ver [WebView del widget](./widget_webview).
* `POST /functions/v1/notify/voice` — llamada telefónica saliente. Ver [Notificaciones de voz](./voice_notifications).

La sesión de audio es un WebSocket firmado (PCM 16 kHz, ElevenLabs ConvAI). No hay métodos públicos `start` / `stop` para el host de la página.