Skip to main content

​
Introducció

L’endpoint Widget WebView és un wrapper HTML interactiu que permet incrustar de forma segura el widget de xat de Lovi dins de pàgines web o aplicacions mòbils. En lloc de retornar una resposta JSON estàndard, aquest endpoint serveix un document HTML complet que conté un iframe que apunta a la interfície de xat. Aquest wrapper actua com un pont segur, obtenint les metadades d’integració necessàries (com el missatge de benvinguda de l’agent i la configuració d’idioma) al costat del servidor i injectant-les de forma segura a la webview utilitzant comunicació postMessage estàndard.

​
🌐 Obtenir WebView del Widget

Mètode: GET Format: HTML

​
Endpoint

Format de ruta alternatiu: GET https://cloud.lovi.ai/functions/v1/widgetWebView/{customer_id}/{widget_id}

​
Paràmetres de Consulta

Si no utilitzes l’estructura de ruta esmentada anteriorment, has de passar els paràmetres requerits a la cadena de consulta.

​
Com Funciona

  1. Autenticació: El servidor valida el customer_id (Access Key) i verifica la propietat del widget_id.
  2. Obtenció de Metadades: Recupera la configuració del widget i opcionalment consulta el backend de traducció de Lovi per traduir el missatge de benvinguda de l’agent al lang sol·licitat.
  3. Lliurament d’HTML: El servidor retorna una pàgina HTML que conté un <iframe src="https://widget.lovi.ai/?cw_id=...">.
  4. Pont PostMessage: L’HTML carregat conté JavaScript que escolta els events get_widget i get_customer disparats per l’iframe. Respon de forma segura amb la configuració del widget (widgetData) i gestiona l’emmagatzematge local (com generar un ID d’usuari únic).

​
Errors Comuns

Si el widget falla en carregar-se, pots rebre un dels següents codis d’estat HTTP en lloc del payload HTML:
  • 400 Bad Request: Falten customer_id o widget_id, o el widget_id no és un UUID vàlid.
  • 403 Forbidden: customer_id invàlid (fallada en la validació de l’Access Key).
  • 404 Not Found: No s’ha pogut trobar l’empresa o el widget especificat.
  • 500 Internal Server Error: S’ha produït un error inesperat en generar el wrapper.
🧭 Important: Si el widget apareix encallat en una pantalla de “Loading Widget…”, comprova la consola del navegador. Assegura’t que el teu entorn permeti iframes de cross-origin i no bloquegi la comunicació postMessage entre el WebView i widget.lovi.ai.