Vos visiteurs reconnaissent votre marque à ses couleurs et à sa police. Votre CSS personnalisé (la feuille de style qui décrit l'apparence d'une page) les donne au widget genii, et le place là où il ne gêne pas vos pages.

Commencez par les recettes, prêtes à copier. La liste complète des sélecteurs (les noms qui désignent chaque élément du widget) se trouve en fin de page.

L'essentiel

Où écrire votre CSS. Sur la plateforme, ouvrez Widget, puis Apparence : votre CSS s'écrit dans l'Éditeur CSS. Les pages Hot Topics, Carrousel, Sparks, Finder fixed, Finder floating et Ask AI ont aussi un bloc Apparence, avec des presets et des sélecteurs de couleur. Le preset « Votre couleur » reprend la couleur de votre widget. Celui des Hot Topics propose en plus des modèles de mise en page en un clic. Tout est réuni dans un seul fichier.

Ce que la plateforme vérifie. Avant d'enregistrer, la plateforme contrôle votre CSS avec stylelint (un outil qui détecte les erreurs de syntaxe). Les deux blocages les plus fréquents sont plusieurs déclarations sur une même ligne et un bloc vide. Écrivez une déclaration par ligne, comme dans les recettes. Un sélecteur écrit deux fois bloque aussi l'enregistrement : si le sélecteur d'une recette existe déjà dans votre CSS, ajoutez ses lignes dans le bloc existant.

Où votre CSS s'applique. Le widget s'affiche dans trois cadres séparés (des iframes) posés sur votre page : la fenêtre de conversation, la bulle (le widget fermé avec l'avatar et son accroche, appelée hook sur la plateforme) et les Suggestions (les Hot Topics de la plateforme). Votre CSS s'applique dans ces trois cadres, dans Sparks, Finder fixed, Finder floating et Ask AI, et aussi sur votre page elle-même. C'est ce qui permet de déplacer le widget, mais une règle trop large, comme body ou .btn, modifie aussi votre site.

Le cadre de la bulle fait 68px de haut : l'avatar, sa pastille verte et l'accroche « Besoin d'aide ? ».

Le cadre de la bulle fait 68px de haut : l'avatar, sa pastille verte et l'accroche « Besoin d'aide ? ».

Mobile, tablette, ordinateur. Le widget ajoute une classe selon la largeur de votre page, sur #genii-widget-container et dans chaque cadre :

Préférez ces classes aux media queries. Dans la fenêtre, une media query mesure la fenêtre elle-même (416px de large sur ordinateur), pas votre page.

Thème sombre. Une règle précédée de [data-color-mode='dark'] ne s'applique qu'en thème sombre. La recette plus bas montre le principe.

Recettes

Adapter les couleurs à votre charte

Ces règles colorent les messages de vos visiteurs, les boutons proposés par l'agent IA et le pouce levé après un vote.

.genii-message--user {
  background-color: #e0e7ff;
}

button.genii-message__button {
  border-color: #2b4d93;
  color: #2b4d93;
}

.genii-thumb-up__icon--active {
  fill: #16a34a;
}

Appliquer votre police

Déclarez votre police une fois, puis appliquez-la au widget : tous les textes de la fenêtre, de la bulle et des Suggestions la reprennent. Le sélecteur html[data-color-mode] ne vise que ces cadres, votre site garde sa propre police. Remplacez le nom et l'adresse par ceux de votre police. Cette recette ne change pas la police de Sparks, Finder fixed, Finder floating et Ask AI.