Annoncer les mises à jour du journal des modifications dans le widget

Affichez les entrées annoncées du journal des modifications à vos visiteurs sous forme de message « Nouveautés » dans le widget libre-service. Annoncez chaque entrée lors de sa publication et choisissez si les annonces s’ouvrent automatiquement ou uniquement lorsque votre code le demande.

Prérequis

Le seul prérequis est de disposer d’un journal des modifications dans votre centre d’aide : le widget affiche les entrées annoncées de votre journal, vous devez donc commencer par en créer un. Consultez Créer un journal des modifications.

Les annonces sont activées par défaut et ne nécessitent aucune option de configuration. Elles sont envoyées aux visiteurs identifiés et connectés avec Ferndesk('identify') : les visiteurs anonymes ne sont jamais interrompus et une nouvelle inscription n’a encore aucune annonce en attente. Consultez la référence du SDK Ferndesk pour connaître les paramètres d’annonce facultatifs.

Annoncer une entrée lors de sa publication

L’annonce est un choix que vous effectuez pour chaque entrée, au moment de sa publication ou juste après. Une entrée publiée discrètement apparaît tout de même dans le fil du journal des modifications : l’annonce concerne uniquement le message « Nouveautés ».

Ouvrez l’entrée du journal des modifications dans l’éditeur.
Cliquez sur Publier l’entrée du journal des modifications.
Lorsque la question Annoncer dans le widget ? s’affiche, choisissez Oui, l’annoncer pour afficher l’entrée sous forme de message « Nouveautés », ou Non, publier discrètement pour l’ajouter uniquement au fil du journal des modifications.

Vous pouvez également modifier ce choix après la publication : ouvrez les paramètres de l’entrée et activez ou désactivez Annoncer dans le widget dans la section Annonce, avec le texte d’aide « Affiche une invite « Nouveautés » aux utilisateurs connectés du widget qui ne l’ont pas encore vue. »

Choisir le moment d’ouverture des annonces

Par défaut, une annonce éligible s’ouvre automatiquement lorsqu’un visiteur connecté charge le widget. Définissez changelogAnnouncementTrigger sur manual pour choisir vous-même le moment, par exemple une fois que le visiteur a terminé une tâche dans votre application :

Ferndesk('init', {
  widgetId: 'YOUR_WIDGET_ID',
  changelogAnnouncementTrigger: 'manual'
})

En mode manuel, le widget affiche toujours l’indicateur de contenu non consulté pour une annonce éligible, mais ne l’ouvre pas. Appelez Ferndesk('showChangelogAnnouncement') lorsque vous souhaitez afficher l’annonce :

Ferndesk('showChangelogAnnouncement')

La commande ouvre uniquement une annonce à laquelle le visiteur a droit et qu’il n’a pas encore vue. Le déclenchement manuel modifie le moment d’ouverture d’une annonce, et non les personnes éligibles : les annonces sont toujours envoyées uniquement aux visiteurs connectés.

auto est la valeur par défaut : les installations qui n’ont jamais défini cette option continuent donc à ouvrir automatiquement les annonces.

FAQ

À quoi l’annonce ressemble-t-elle pour les visiteurs ?

Le message « Nouveautés » s’ouvre avec un message d’accueil, personnalisé avec le nom du visiteur lorsqu’il est connu, et propose Afficher toutes les mises à jour pour ouvrir le fil complet, Mise à jour précédente et Suivante pour passer d’une entrée à l’autre, ainsi que Terminer sur la dernière entrée.

Pourquoi certains visiteurs ne voient-ils pas mon annonce ?

Les annonces sont envoyées uniquement aux visiteurs identifiés et connectés. Les visiteurs anonymes ne sont jamais interrompus, et une nouvelle inscription n’a elle non plus aucune annonce en attente. Une entrée annoncée est également proposée uniquement aux visiteurs qui ne l’ont pas encore vue, et seulement dans les 30 jours suivant l’annonce. Les visiteurs qui ont déjà vu l’entrée ne reçoivent pas à nouveau l’invite.

Les annonces suivent-elles les visiteurs d’un appareil à l’autre ?

Oui. La confirmation d’une annonce est mémorisée pour le visiteur connecté : elle reste donc considérée comme vue sur les autres appareils. Le chargement anonyme du widget n’enregistre aucun état de lecture ; une visite anonyme ne marque donc jamais une annonce comme vue. La déconnexion ferme une annonce affichée sans la marquer comme lue : elle reste donc en attente lorsque le visiteur se reconnecte.

Puis-je désactiver les annonces ?

Définissez changelogAnnouncements sur false dans la configuration de votre widget, ou désactivez Annoncer dans le widget pour certaines entrées. Définir cette option sur true produit le même effet que de ne pas la renseigner. Les messages d’annonce et les badges de contenu non consulté disparaissent, mais le fil « Nouveautés » reste disponible.

Les développeurs peuvent-ils contrôler le journal des modifications depuis mon site ?

Oui. Les développeurs peuvent ouvrir le journal des modifications, vérifier s’il contient des mises à jour non consultées et ouvrir eux-mêmes l’annonce. Consultez la référence du SDK Ferndesk.

Cela vous a-t-il été utile ?