Aller au contenu
AurionAI

Ajouter le widget web à votre site

6 min de lecturePar Emmanuel Yazbeck

Le widget web intègre le support AurionAI sur votre propre site web. Les visiteurs l'ouvrent depuis un bouton situé dans un coin de la page. Sur la page Widget, vous activez le widget, choisissez les sites web autorisés à l'afficher, modifiez son apparence et copiez le code d'intégration.

Disponibilité : tous les profils. La voix dans le widget nécessite le profil AI Voice ou AI Voice + Helpdesk. Administrateurs uniquement.

Prérequis

  • Vous avez le rôle Propriétaire ou Administrateur. Les autres utilisateurs voient Accès refusé.
  • Vous pouvez ajouter un script aux pages de votre site web, ou vous pouvez demander à votre équipe web de le faire.
  • Vous connaissez l'adresse web de chaque site qui affichera le widget, par exemple https://portal.northwind.example.

Ouvrir la page du widget

  1. Dans la barre latérale, sélectionnez Paramètres.
  2. Ouvrez la catégorie Intégrations.
  3. Sélectionnez Widget.

La page contient les cartes Statut et sécurité, Apparence et Code d'intégration. Avec le profil Helpdesk ou AI Voice + Helpdesk, elle contient également la carte Paramètres de chat.

La page Widget avec la carte Statut et sécurité.

Chat, voix ou les deux

Votre profil produit détermine ce que le widget propose. La carte Statut et sécurité l'indique :

  • AI Voice : Ce widget est configuré en mode voix uniquement selon votre plan AI Voice.
  • Helpdesk : Ce widget est configuré en mode chat uniquement selon votre plan Helpdesk.
  • AI Voice + Helpdesk : Ce widget prend en charge le chat et la voix selon votre plan.

La partie voix utilise le même agent IA que votre ligne téléphonique. Consultez Nom de l'agent, message d'accueil et comportement. La partie chat utilise le persona de service client de votre agent et répond à partir des articles publiés dans votre Centre d'aide. Pour les articles du Centre d'aide, consultez Rédiger et publier des articles et Paramètres de la base de connaissances.

Activer le widget et définir les sites autorisés

  1. Dans la carte Statut et sécurité, activez Activer le widget web.
  2. Dans Origines autorisées, saisissez chaque site web autorisé à afficher le widget. Indiquez un site par ligne, avec https://, le nom d'hôte et, si nécessaire, le port. N'ajoutez pas de chemin.
  3. Sélectionnez Enregistrer les paramètres du widget web.

Comment AurionAI vérifie les sites autorisés :

  • Le site de la page doit correspondre exactement à une entrée : le même http ou https, le même nom d'hôte et le même port. https://northwind.example et https://www.northwind.example sont deux sites différents.
  • Les chemins ne sont pas pris en compte. Une entrée couvre toutes les pages d'un site.
  • Vous pouvez saisir jusqu'à 50 sites.
  • Sur tout autre site, AurionAI refuse de démarrer le widget.
  • Votre Centre d'aide AurionAI affiche toujours le widget, sur son adresse aurionai.net et sur votre propre domaine une fois celui-ci vérifié. Vous n'avez pas besoin de les ajouter, et ils ne dépendent pas de Activer le widget web. Consultez Utiliser votre propre domaine.

Pour l'authentification unique dans le widget, consultez Authentification unique pour les utilisateurs finaux.

Modifier l'apparence du widget

Dans la carte Apparence :

  1. Sélectionnez le Position du lanceur : En bas à droite ou En bas à gauche.
  2. Sélectionnez un Thème d'accent. Pour utiliser vos propres couleurs, activez Utiliser des couleurs personnalisées et définissez le Couleur principale et le Couleur d'accent.
  3. Dans Langue à modifier, sélectionnez une langue. Saisissez ensuite le Titre du widget, le Libellé du lanceur, le Texte d'accueil et le Message de bulle du lanceur pour cette langue. Répétez l'opération pour chaque langue dont vous avez besoin.
  4. Facultatif : sous Logo d'entreprise, téléversez un fichier PNG, SVG ou JPG de 200 Ko ou moins.
  5. Facultatif : définissez Thème du widget, Actions rapides et Afficher le badge "Powered by".
  6. Sélectionnez Enregistrer les paramètres du widget web.

Le widget affiche les textes dans la langue du navigateur du visiteur. Lorsqu'une langue ne dispose pas de texte, il utilise le texte en anglais.

Ajouter le widget à votre site web

  1. Dans la carte Code d'intégration, sélectionnez le Langue du widget. Détection automatique (langue de la page) suit la langue de la page.
  2. Sélectionnez Copier l'extrait.
  3. Collez le code dans les pages de votre site web, ou transmettez-le à votre équipe web.

Le code contient votre Clé publique du widget. Si vous sélectionnez Régénérer la clé, AurionAI crée immédiatement une nouvelle clé. La régénération de la clé invalide les anciens extraits qui utilisent la clé précédente. Copiez le nouveau code sur votre site web après avoir régénéré la clé.

Résultat

Sur un site autorisé, le bouton du widget apparaît dans le coin que vous avez choisi. Les visiteurs peuvent discuter, parler à l'agent IA, ou les deux, selon votre profil. Le widget lit ses paramètres à chaque chargement d'une page contenant le widget, de sorte que vos modifications enregistrées s'affichent au prochain chargement de page.

En cas de problème

  • Au moins une origine autorisée est requise lorsque le widget est activé. Saisissez au moins un site, ou désactivez le widget.
  • L'enregistrement échoue avec un message concernant une origine autorisée. Chaque ligne doit commencer par http:// ou https:// et contenir un nom d'hôte. Supprimez les chemins, les chaînes de requête et les noms d'utilisateur.
  • L'enregistrement échoue avec un message commençant par « Widget GA gate checks failed ». AurionAI vérifie certains paramètres de sécurité lorsque le widget devient utilisable pour la première fois sur un site. Si le message mentionne recording_consent, désactivez l'enregistrement des appels ou saisissez un texte de consentement. Consultez Enregistrement des appels. Pour les autres mentions, contactez le support AurionAI. Consultez Obtenir de l'aide.
  • Le widget n'apparaît pas sur votre site. Vérifiez que Activer le widget web est activé, que le site figure dans Origines autorisées avec le bon https, le bon nom d'hôte et le bon port, et que la page utilise le code actuel. Après Régénérer la clé, l'ancien code ne fonctionne plus. Le widget s'arrête également lorsque votre compte est suspendu.
  • Le logo doit être PNG, SVG ou JPG. Utilisez un fichier PNG, SVG ou JPG.
  • Échec du chargement de la configuration du widget web. Veuillez actualiser et réessayer. Rechargez la page.
  • Échec de l'enregistrement des paramètres du widget vocal Réessayez. Si l'erreur persiste, contactez le support AurionAI.

Articles connexes

Besoin d’aide supplémentaire ? Envoyez une demande ou .