Smart Form - Select

Integration Smart Form - Input

HTML

Ajouter dans votre code HTML un conteneur avec un identifiant qui permettra d’afficher Smart Form à l’endroit de votre choix sur la page <div id="containerId_DE_VOTRE_CHOIX"></div>. Sur votre liste déroulante, pensez à spécifier un identifiant afin de pouvoir le préciser dans le code JS <select id="selectId_DE_VOTRE_CHOIX"></select>.

<select id="my-select"></select>
<div id="st-contact-form-select-container"></div>

JS

Intégrer le snippet Javascript juste avant la fermeture de la balise </body>. Le script Smart Tribune doit être chargé le plus en aval possible dans la chaîne de chargement des scripts afin d’éviter d’éventuels conflits avec les scripts présents sur la page client.

<script type="text/javascript">
  window.addEventListener('STContactFormSelectLoaded', function (e) {
    e.detail.init({
      kbId: 2,
      locale: 'fr',
      cookieOptin: false,
      labels: {
        title: {
          en: 'Suggestions',
        },
        openOnFaq: {
          fr: 'Ouvrir la faq knowledge',
        },
        goToFaqLink: {
          fr: 'Aller à la faq knowledge',
        },
      },

      limit: 5,
      faqUrl: 'https://example.com/faq',
      openInNewTab: true,
      selectId: 'my-select',
      containerId: 'st-contact-form-select-container',
      mapping: {
        'option-1': {
          thematics: ['category-1'],
          tags: [],
        },
        'option-2': {
          thematics: ['category-2'],
          tags: ['tag-1'],
        },
      },
    });
  });
</script>
<script
  type="text/javascript"
  async
  src="https://assets.app.smart-tribune.com/smart-tribune/ContactFormSelect/contactformselect.main.js"
></script>

Lien vers la démonstration : Cliquez ici

info

Les domaines faisant appel à la base de connaissances spécifiée devront être préalablement déclarés directement dans la configuration de la base de connaissances dans Smart Dashboard.

Liste des variables

Variable	Type	Condition	Exemple	Description
kbId	int	requis	kbId : 2	Variable spécifique à chaque client, elle correspond à l'identifiant (identifiant système) de la base de connaissances à utiliser. Celle-ci est disponible dans Smart Dashboard, l'interface d'administration de contenus. La base de connaissances intégrant déjà du contenu de test est identifié par la valeur : 2. Vous pouvez retrouver votre kbId sur la page d'accueil du Dashboard dans le cadre "Sélectionner une base de connaissances" puis "identifiant système".
locale	string	requis	locale : "fr"	Elle permet au client de spécifier dans quelle langue le dispositif doit être affiché. Cela est valable uniquement pour les bases de connaissances multilingues.
cookieOptin	bool	requis	cookieOptin : false	Elle permet d'empêcher ou non l'activation du cookie Google Analytics (valeur possible : true ou false). En désactivant cette fonctionnalité, il ne sera plus possible d'envoyer des informations dans Google Analytics pour votre FAQ. La valeur par défaut est false.
customVariables	obj	optionnel	customVariables : { brand:"Smart Tribune"}	Cette variable permet de remplacer la valeur d'un jeton de personnalisation créé dans le contenu d'une réponse via Smart Dashboard. Note : On attend ici une chaîne de caractères qui peut contenir des balises HTML (span, a, b, u, i, br, img) avec ses attributs (id, class, style, name, title, target, href, rel, src, alt).
labels	obj	optionnel	labels : { title:{}, emptyMessage:{}, openOnFaq:{}, goToFaqLink:{} }	Cette variable permet de surcharger les chaines de caractères du widget par celles de votre choix. Nous vous conseillons de vous baser sur le snippet d'exemple ci-dessus pour ajouter vos propres textes.
limit	int	optionnel	limit: 5	Limite du nombre d’éléments à afficher (max: 25).
faqUrl	string	optionnel	faqUrl: "https://example.com/faq"	Cela permet de rediriger les utilisateurs vers la FAQ.
openInNewTab	bool	optionnel	openInNewTab: true	Permet d’ouvrir les liens des suggestions dans un nouvel onglet.
selectId	string	optionnel	selectId: "my-select"	Il s’agit de l’identifiant du champ du formulaire sur lequel il faut appliquer la recherche.
containerId	string	optionnel	containerId: "st-contact-form-select-container"	Il s’agit de l’identifiant du container qui va afficher le widget.
mapping	obj	optionnel	mapping : { option-1:[], option-2:[]}	Cette variable permet de spécifier les catégories et les tags qui doivent être associés au motif sélectionné dans la liste déroulante (option value). Nous vous conseillons de vous baser sur le snippet d'exemple ci-dessus.
customResponses	arr	optionnel	customResponses : [ "tag" ]	Cette variable permet de spécifier la contextualisation de la réponse personnalisée à appliquer en utilisant l'identifiant système des tags. Note : Cette variable est un tableau (array) de chaîne de caractères (string).