Comment activer les recommandations de Fern
Les recommandations de Fern vous aident à identifier les lacunes dans votre documentation en vous basant sur les tickets de support et les changements apportés aux produits. Pour recevoir des recommandations, vous devez d'abord configurer le monitoring.
Avant de commencer : Connectez au moins une intégration pour activer le monitoring. Connecter votre base de code (GitHub) est vivement recommandé - cela permet d'obtenir des recommandations plus précises et plus puissantes que les seuls outils de support.
Où apparaissent les recommandations
Une fois le monitoring activé, les recommandations s'affichent dans la Fern Inbox. C'est ici que vous examinerez, prioriserez et attribuerez les tâches de documentation à Fern.
Le tableau de bord Signals existe toujours en tant que vue de données séparée affichant les demandes de support brutes et les lancements de produits qui alimentent les recommandations.
Configuration du monitoring
Vous pouvez lancer le processus de configuration à partir de plusieurs endroits :
Carte Opportunities du tableau de bord
Page Fern Inbox (/fern)
Tableau de bord Signals dans votre barre latérale
Recherchez un bouton ou une carte « Setup monitoring ». Cliquez dessus pour commencer.
Étape 1 : Connecter les intégrations
La boîte de dialogue de configuration vérifiera vos intégrations. Vous pouvez connecter :
Votre base de code
Outils de support :
Vous avez besoin d'au moins une intégration pour activer le monitoring. Les deux types sont optionnels, mais les intégrations de base de code génèrent des recommandations plus précises en analysant directement les modifications du produit.
Commencez par les intégrations de base de code si vous utilisez GitHub. Elles fournissent les recommandations les plus puissantes. Ajoutez des outils de support pour obtenir un contexte supplémentaire à partir des questions des clients.
Étape 2 (facultatif) : Choisir une période d'analyse
Sélectionnez jusqu'où Fern doit remonter pour votre analyse initiale :
7 jours - Activité récente uniquement
14 jours - Bon point de départ
31 jours - Par défaut, équilibre entre profondeur et rapidité
90 jours - Vue trimestrielle
365 jours - Année complète (prend plus de temps)
L'analyse traite jusqu'à environ 3 000 tickets, en se concentrant sur les éléments les plus récents et pertinents si vous en avez davantage.
Étape 3 : Démarrer le monitoring
Cliquez sur « Start monitoring » pour commencer l'analyse. Fern va :
Importer les tickets et les changements de produits depuis vos outils connectés
Lire et analyser les données
Identifier les lacunes de la documentation
Créer des recommandations priorisées
Le processus prend de 5 à 30 minutes selon le volume de données. Vous pouvez quitter la page - l'analyse s'exécute en arrière-plan.
Après la première analyse
Une fois l'analyse terminée, les recommandations apparaissent dans votre Fern Inbox. Vous verrez :
Les lacunes documentaires identifiées à partir des modèles de support
Classements par priorité basés sur le volume et la récence des tickets
Le contexte issu des tickets de support ayant déclenché chaque recommandation
Fern effectue automatiquement des analyses quotidiennes par la suite, de sorte que de nouvelles recommandations apparaissent à mesure que des modèles émergent - aucun déclenchement manuel n'est nécessaire.
Exécuter des analyses manuelles
Même si les analyses automatiques quotidiennes sont activées, vous pouvez déclencher des analyses manuelles à tout moment :
Après avoir connecté une nouvelle intégration
À la suite d'un lancement de produit majeur
Pour analyser une période historique spécifique
Allez sur le tableau de bord Signals, cliquez sur « Check for new tickets », choisissez votre période d'analyse et lancez le scan.
Le monitoring automatique quotidien permet de garder les recommandations à jour sans travail manuel constant.
Dépannage
Le bouton de configuration est désactivé
Vous devez avoir au moins une intégration connectée avant de pouvoir activer le monitoring. Connectez d'abord un outil de base de code (GitHub ou Linear) ou un outil de support (Crisp, Intercom ou Zendesk).
Aucune recommandation après l'analyse
Si l'analyse se termine mais que votre Inbox est vide :
Vérifiez que vos intégrations ont des données durant la période d'analyse sélectionnée
Assurez-vous d'avoir une documentation de base - Fern compare les questions de support à ce qui existe déjà
Essayez une période d'analyse plus longue pour capturer davantage de données
L'analyse échoue ou affiche une erreur
Si vous voyez une erreur :
Vérifiez que vos intégrations sont toujours authentifiées (elles peuvent nécessiter une reconnexion)
Vérifiez que les outils intégrés sont accessibles (aucune panne d'API)
Essayez une période d'analyse plus courte si vous avez un volume de tickets très élevé
Utilisez le bouton de nouvel essai pour tenter de relancer l'analyse
Impossible de trouver le bouton de configuration
Si vous ne voyez pas d'invite de configuration, le monitoring est peut-être déjà activé. Vérifiez votre Fern Inbox pour voir les recommandations existantes ou visitez le tableau de bord Signals pour voir votre statut de monitoring.
Prochaines étapes
Une fois que les recommandations arrivent :
Examinez les éléments dans votre Fern Inbox et attribuez les lacunes prioritaires à Fern
Explorez le tableau de bord Signals pour comprendre les données brutes qui alimentent les recommandations
Connectez des intégrations supplémentaires pour une couverture plus complète
Plus vous connectez de sources de données, plus Fern devient efficace pour identifier les lacunes de votre documentation.