Configuration

Définir les options

Les options simples peuvent être ajoutées à la balise script sous forme d’attributs data-, avec des mots séparés par des tirets. Pour les options plus complexes, définissez window.YunoSettings avant le chargement du script.

<script src="https://cdn.yuno.chat/widget.js"
  data-site-id="site_8Kq2mXvR"
  data-position="bottom-left"
  data-color="#0f766e"
  data-title="Atelier Grès"
  data-avatar="https://atelier-gres.fr/team/thomas.jpg"
  data-launcher-label="Aide"
  data-locale="fr"
  async></script>

Pour modifier les options après le chargement du widget, appelez Yuno("update", options). Consultez l’API JavaScript.

Options

• siteIdstringobligatoire

  L’identifiant de votre site, site_….

• positionenum

  Le coin dans lequel apparaît la bulle. Vos visiteurs peuvent la glisser vers un autre coin. Valeur par défaut : bottom-right.

  bottom-rightbottom-lefttop-righttop-left

• offsetobject

  Distance par rapport au coin, en pixels, pour éviter une bannière de cookies par exemple.

  • xinteger

    Décalage horizontal. Valeur par défaut : 24.

  • yinteger

    Décalage vertical. Valeur par défaut : 24.

• colorstring

  Couleur de votre marque au format hexadécimal. La couleur du texte est choisie automatiquement pour assurer le contraste.

• titlestring

  Nom affiché dans l’en-tête du widget. Par défaut, le domaine de votre site.

• subtitlestring

  Ligne sous le titre, par exemple Thomas répond généralement sous un jour.

• avatarstring

  URL d’une image carrée pour l’en-tête, comme la photo d’un membre de l’équipe. Par défaut, la première lettre du titre.

• launcherLabelstring

  Texte à côté de l’icône de la bulle, par exemple Aide. Omettez cette option pour afficher uniquement l’icône.

• themeenum

  auto suit le réglage système du visiteur. Valeur par défaut : light.

  lightdarkauto

• localestring

  en, fr ou auto pour suivre la langue du navigateur. Valeur par défaut : fr.

• greetingstring

  Le premier message que voient les visiteurs.

• launcherboolean

  Définissez false pour masquer la bulle et ouvrir le widget uniquement avec vos propres boutons.

• hideOnPathsarray of strings

  Chemins sur lesquels le widget ne doit pas s’afficher. Accepte le caractère générique *, par exemple /checkout/*.

• featuresobject

  Désactivez certaines fonctionnalités du widget pour cette page. Depuis la balise script : data-handoff="false" ou data-tickets="false".

  • ticketsboolean

    Autorise les visiteurs à créer des tickets. Valeur par défaut : true.

  • handoffboolean

    Affiche l’option « Parler à quelqu’un ». Valeur par défaut : true.

• zIndexinteger

  Ordre de superposition du widget. Valeur par défaut : 2147483000.

• brandingboolean

  Définissez false pour masquer la mention « Propulsé par Yuno Chat » (Growth et Pro).

• modeenum

  Utilisez test pendant le développement. Les messages et les tickets sont enregistrés avec mode: test.

  livetest

• apiBasestring

  Adresse à laquelle le widget envoie les messages et les tickets. Nécessaire uniquement si vous hébergez vous-même le backend.