Theming : l’intégrer visuellement à votre site
Chaque surface Olotalk se rend dans un shadow root ; la feuille de style de votre page ne peut donc pas atteindre son intérieur. C’est volontaire : cela garantit que les citations, le badge de grounding et les états “réponse / pas de réponse” restent intacts, quel que soit le style de la surface. Vous pouvez changer son apparence ; vous ne pouvez pas changer ce qu’elle dit.
Pour la styler, vous définissez un petit ensemble de propriétés CSS personnalisées. Celles-ci traversent bien la frontière du shadow DOM. Placez-les n’importe où dans l’arbre d’héritage de la surface, :root est le plus simple, et l’assistant les lira.
:root {
--olotalk-font-family: 'Inter', system-ui, sans-serif;
--olotalk-accent: #4f46e5;
--olotalk-surface: #ffffff;
--olotalk-text: #111827;
--olotalk-radius: 10px;
}
C’est toute l’intégration. Pas de JavaScript, pas d’objet de config, pas de rebuild. Cela fonctionne pour tous les placements : le corner bubble et l’assistant inline lisent les mêmes tokens.
Si vous ne définissez rien, la surface garde exactement son apparence de base. Chaque token retombe sur sa valeur intégrée ; ajouter ce bloc ne déclenche donc jamais un restyle inattendu. Seules les valeurs que vous définissez changent.
- 1
--olotalk-font-familyTout le texte - 2
--olotalk-accentLiens, envoi, focus - 3
--olotalk-surfaceArrière-plan du panneau - 4
--olotalk-textTexte des messages - 5
--olotalk-radiusCoins des boutons et champs - 6
--olotalk-borderSéparateurs et contours
Tokens
| Token | Contrôle |
|---|---|
--olotalk-font-family | Police de tous les textes. C’est le token à plus fort effet : quand la police correspond à celle de votre site, la surface semble immédiatement “à vous”. |
--olotalk-font-size | Taille de texte de base. |
--olotalk-line-height | Interligne de base. |
--olotalk-accent | Couleur d’accent / primaire : liens, envoi, focus. |
--olotalk-text | Couleur de texte principale. |
--olotalk-muted | Texte secondaire : horodatages, légendes, placeholders. |
--olotalk-surface | Fond principal du panneau. |
--olotalk-surface-alt | Fond secondaire : en-tête, lignes survolées, chips. |
--olotalk-border | Couleur des séparateurs et bordures. |
--olotalk-radius | Rayon des coins pour boutons, champs et chips. |
--olotalk-radius-panel | Rayon des coins du panneau externe. |
--olotalk-shadow | Ombre portée du panneau. |
Définissez uniquement les tokens qui vous importent. Un ensemble minimal fréquent est --olotalk-font-family, --olotalk-accent et --olotalk-surface : cela suffit souvent à rendre la surface native sur la plupart des sites.
Couverture
L’assistant de chat ne lit que les tokens qu’il peint réellement. Rien ne casse si vous en définissez un qu’il ignore : il restera simplement inerte.
- Assistant de chat (flottant et embarqué) lit tous les tokens sauf
--olotalk-font-size; il dérive ses tailles de texte depuis sa propre échelle typographique, pilotée par--olotalk-font-familyet--olotalk-line-height.
Ce que vous ne pouvez pas thématiser, volontairement
L’espacement et la mise en page. Il n’existe pas de tokens pour les paddings, les gaps ou les tailles d’élément. Hériter de l’intégralité du style de la page hôte est précisément ce qui fait casser un composant embarqué sur les pages au CSS atypique ; la surface conserve donc son rythme interne et n’expose que l’apparence. C’est une frontière volontaire, pas une fonctionnalité manquante.
La couche de confiance. Les citations, la liste des sources, le badge de grounding et le refus honnête “I don’t have that” sont structurels. Les tokens peuvent changer leur couleur, leur typographie et leur rayon, mais ils ne peuvent ni les masquer ni les supprimer.
Priorité
Quand une valeur est définie à plusieurs endroits, la plus spécifique l’emporte :
Un token --olotalk-* défini dans votre feuille de style remplace la même valeur configurée dans le dashboard Olotalk, qui remplace elle-même la valeur par défaut intégrée. Le token CSS gagne parce qu’il est l’expression la plus locale de votre intention.
Mode sombre
Les tokens servent à fondre l’assistant dans votre site, pas à basculer light/dark. Pour rendre l’assistant de chat en mode sombre, utilisez son option theme (theme: 'dark') : c’est un axe distinct des tokens. Vous pouvez ensuite superposer des tokens pour ajuster la palette sombre à votre marque.
Exemple : un chat intégré qui correspond à votre site
Vous intégrez le chat inline (voir Référence d’intégration → Embedded mode) et vous voulez qu’il paraisse faire partie de la page plutôt qu’être ajouté au chausse-pied ? Combinez l’embed avec quelques tokens :
<div id="chat" style="height: 560px;"></div>
<style>
:root {
--olotalk-font-family: var(--site-font, 'Inter', sans-serif);
--olotalk-accent: #0d9488;
--olotalk-surface: #fbfbf9;
--olotalk-surface-alt: #f0efe9;
--olotalk-border: #e4e2da;
--olotalk-text: #1c1b19;
--olotalk-radius: 8px;
--olotalk-radius-panel: 12px;
}
</style>
<script>
window.OlotalkConfig = {
assistantId: 'ast_oltk_7Kd2mQxRv9TbNhLpW3Zsy',
mode: 'inline',
mount: '#chat',
};
</script>
<script src="https://cdn.jsdelivr.net/npm/@olotalk/assistant-loader@0/dist/loader.iife.js" async></script>
Réutilisez une variable que votre site définit déjà (--site-font dans l’exemple ci-dessus) et l’assistant héritera automatiquement de votre typographie.