Skip to main content

​
Introduction

L’endpoint Widget WebView est un wrapper HTML interactif qui vous permet d’intégrer le widget de chat Lovi de manière sécurisée dans des pages web ou des applications mobiles. Au lieu de renvoyer une réponse JSON standard, cet endpoint sert un document HTML complet contenant une iframe pointant vers l’interface de chat. Ce wrapper agit comme un pont sécurisé, récupérant les métadonnées d’intégration nécessaires (comme le message de bienvenue de l’agent et les paramètres de langue) côté serveur et les injectant en toute sécurité dans la webview à l’aide de la communication postMessage standard.

​
🌐 Obtenir le WebView du Widget

Méthode : GET Format : HTML

​
Endpoint

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

​
Paramètres de Requête

Si vous n’utilisez pas la structure de chemin mentionnée ci-dessus, vous devez passer les paramètres requis dans la chaîne de requête.

​
Comment ça marche

  1. Authentification : Le serveur valide le customer_id (Access Key) et vérifie la propriété du widget_id.
  2. Récupération des métadonnées : Il récupère la configuration du widget et interroge éventuellement le backend de traduction Lovi pour traduire le message de bienvenue de l’agent dans la langue lang demandée.
  3. Livraison HTML : Le serveur renvoie une page HTML contenant un <iframe src="https://widget.lovi.ai/?cw_id=...">.
  4. Pont PostMessage : Le HTML chargé contient du JavaScript qui écoute les événements get_widget et get_customer déclenchés par l’iframe. Il répond en toute sécurité avec la configuration du widget (widgetData) et gère le stockage local (comme la génération d’un identifiant utilisateur unique).

​
Erreurs Courantes

Si le widget ne parvient pas à se charger, vous pouvez recevoir l’un des codes de statut HTTP suivants au lieu de la charge utile HTML :
  • 400 Bad Request : customer_id ou widget_id manquant, ou widget_id n’est pas un UUID valide.
  • 403 Forbidden : customer_id invalide (échec de la validation de la Access Key).
  • 404 Not Found : L’entreprise ou le widget spécifié n’a pas pu être trouvé.
  • 500 Internal Server Error : Une erreur inattendue s’est produite lors de la génération du wrapper.
🧭 Important : Si le widget semble bloqué sur un écran “Loading Widget…”, vérifiez la console de votre navigateur. Assurez-vous que votre environnement autorise les iframes cross-origin et ne bloque pas la communication postMessage entre le WebView et widget.lovi.ai.