Comment activer les recommandations de Fern
Les recommandations de Fern vous aident à identifier les lacunes de votre documentation en se basant sur les tickets de support et les modifications de produits. Pour recevoir des recommandations, vous devez d'abord configurer la surveillance.
Avant de commencer : connectez au moins une intégration pour activer la surveillance. La connexion de votre codebase (GitHub) est fortement recommandée - cela fournit des recommandations plus précises et puissantes que les seuls outils de support.
Où apparaissent les recommandations
Une fois la surveillance activée, les recommandations s'affichent dans la Boîte de réception Fern. C'est ici que vous examinerez, prioriserez et assignerez les tâches de documentation à Fern.
Le tableau de bord Signals existe toujours en tant que vue de données séparée montrant les demandes de support brutes et les lancements de produits qui alimentent les recommandations.
Configuration de la surveillance
Vous pouvez lancer le processus de configuration depuis plusieurs endroits :
Carte Opportunités du tableau de bord
Page Boîte de réception Fern (/fern)
Tableau de bord Signals dans votre barre latérale
Recherchez un bouton ou une carte « Configurer la surveillance ». 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 codebase
Outils de support :
Vous avez besoin d'au moins une intégration pour activer la surveillance. Les deux types sont optionnels, mais les intégrations de codebase génèrent des recommandations plus précises en analysant directement les changements de produits.
Commencez par les intégrations de codebase 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 de rétrospection
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 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 : Lancer la surveillance
Cliquez sur « Lancer la surveillance » pour commencer l'analyse. Fern va :
Importer les tickets et les modifications de produits de vos outils connectés
Lire et analyser les données
Identifier les lacunes dans 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 Boîte de réception Fern. Vous verrez :
Les lacunes de documentation identifiées à partir des modèles de support
Un classement par priorité basé sur le volume et la récence des tickets
Le contexte 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 avec les analyses quotidiennes activées, vous pouvez déclencher des analyses manuelles à tout moment :
Après avoir connecté une nouvelle intégration
Suite à un lancement de produit majeur
Pour analyser une période historique spécifique
Allez sur le tableau de bord Signals, cliquez sur « Vérifier les nouveaux tickets », choisissez votre période de rétrospection et lancez l'analyse.
La surveillance automatique quotidienne maintient 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 la surveillance. Connectez d'abord un outil de codebase (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 Boîte de réception est vide :
Vérifiez que vos intégrations contiennent des données pour la période 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 de rétrospection plus longue pour capturer plus 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 interruption d'API)
Essayez une période de rétrospection 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, il se peut que la surveillance soit déjà activée. Vérifiez votre Boîte de réception Fern pour voir les recommandations existantes ou visitez le tableau de bord Signals pour voir votre statut de surveillance.
Prochaines étapes
Une fois que les recommandations commencent à arriver :
Examinez les éléments de votre Boîte de réception Fern et assignez les lacunes les plus 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.