Snippet Smart Context

Description

La solution de FAQ contextualisée permet d’ajouter un bloc sur la page de votre choix, afin de récupérer dynamiquement les questions/réponses présentes dans votre base de connaissances, filtrées ou non en fonction d’un ou plusieurs critères.

Integration

HTML

Ajouter dans votre code HTML un conteneur avec un identifiant qui permettra d’afficher le widget à l’endroit de votre choix sur la page <div id="containerId_DE_VOTRE_CHOIX"></div>. Il faudra indiquer cet identifiant dans l'étape suivante (1.2) au niveau de containerId.

<div id="st-faq-context"></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('STFAQContextLoaded', function (e) {
    e.detail.init({
      kbId: 2,
      locale: 'fr',
      cookieOptin: false,
      filters: {
        thematics: ['category-1'],
        tags: ['tag-1'],
      },
      labels: {
        title: {
          fr: 'Questions pertinentes',
        },
        emptyMessage: {
          fr: 'Aucune question',
        },
        openOnFaq: {
          fr: 'Ouvrir sur la FAQ',
        },
        goToFaqLink: {
          fr: 'Voir la FAQ',
        },
      },
      limit: 5,
      faqUrl: 'https://example.com/faq',
      openInNewTab: true,
      containerId: 'st-faq-context',
      singleQuestionOpen: false,
    });
  });
</script>
<script
  type="text/javascript"
  async
  src="https://assets.app.smart-tribune.com/smart-tribune/FAQContext/faqcontext.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).
filters	obj	optionnel	filters : { thematics:[], tags:[] }	Cette variable de configuration permet de spécifier la contextualisation à appliquer. Il est possible de définir le filtrage en utilisant l'identifiant système thematics ou tags. L'opérateur utilisé est AND dans le cas de multiples valeurs au sein du même filtre ou entre les filtres. Il est possible de remplacer tags par tagsOr pour appliquer un opérateur OR entre chaque tag. Note : Ces objets contiennent un tableau (array) de chaîne de caractères (string).
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.
containerId	string	optionnel	containerId: "st-faq-context"	Il s’agit de l’identifiant du container qui va afficher le widget.
singleQuestionOpen	bool	optionnel	singleQuestionOpen: false	Permet de cacher le contenu de la précédente question ouverte lorsqu’on en ouvre une autre. (défaut: false)
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).