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. 1
    --olotalk-font-familyTout le texte
  2. 2
    --olotalk-accentLiens, envoi, focus
  3. 3
    --olotalk-surfaceArrière-plan du panneau
  4. 4
    --olotalk-textTexte des messages
  5. 5
    --olotalk-radiusCoins des boutons et champs
  6. 6
    --olotalk-borderSéparateurs et contours

Tokens

TokenContrôle
--olotalk-font-familyPolice 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-sizeTaille de texte de base.
--olotalk-line-heightInterligne de base.
--olotalk-accentCouleur d’accent / primaire : liens, envoi, focus.
--olotalk-textCouleur de texte principale.
--olotalk-mutedTexte secondaire : horodatages, légendes, placeholders.
--olotalk-surfaceFond principal du panneau.
--olotalk-surface-altFond secondaire : en-tête, lignes survolées, chips.
--olotalk-borderCouleur des séparateurs et bordures.
--olotalk-radiusRayon des coins pour boutons, champs et chips.
--olotalk-radius-panelRayon des coins du panneau externe.
--olotalk-shadowOmbre 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-family et --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 :

token --olotalk-*
dans votre feuille de style
overrides
apparence du dashboard
configurée par assistant
overrides
valeur intégrée par défaut
ce qui est livré

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.