aller au contenu principal
Parcourir la documentation

Configuration du widget

Configurez le widget avec des attributs data-* sur la balise de script.

Vous configurez le widget avec des attributs data-* sur la balise de script. Voici l’ensemble complet.

Attributs principaux

  • data-key — votre clé publiable (pk_test_… ou pk_live_…). Obligatoire.
  • data-position — coin du lanceur : bottom-right (par défaut), bottom-left, top-right ou top-left.
  • data-locale — un indice de langue (par exemple ar ou en-US) ; l’entrée de langue la plus prioritaire.
  • data-chat-size — small (par défaut), medium, large, fullscreen ou embedded.
  • data-chat-mode — normal (par défaut) ou split (une disposition à deux volets).
  • data-env — development ou production (sinon déduit du préfixe de la clé).
  • data-theme — une chaîne JSON de surcharges de tokens de thème.

Attributs avancés

  • data-origin — l’origine de l’API Syncanix (par défaut, l’API de production).
  • data-mount-target — un sélecteur CSS indiquant où monter un widget intégré.
  • data-config-load — lazy (charger les réglages à la première ouverture, par défaut) ou eager (au montage).
  • data-executor — le nom d’une fonction globale qui exécute des actions du navigateur ou de l’hôte.
  • data-token-provider — le nom d’une fonction globale renvoyant le jeton de l’utilisateur final.
  • data-step-up-provider — le nom d’une fonction globale qui déclenche la réauthentification renforcée.
  • data-client-witness — activez l’observation passive du trafic de l’API, sur sa forme uniquement (désactivé par défaut).
  • data-act-on-behalf-consent — exigez un consentement unique « agir en votre nom » (désactivé par défaut).

Étapes suivantes