Voici un scénario malheureusement fréquent : une équipe migre vers Freshdesk, active Freddy AI dès le premier jour et constate immédiatement que le bot donne des réponses erronées, manque de contexte ou interprète mal des détails de politique qui ont changé six mois auparavant. La plateforme est pointée du doigt. Freddy est désactivé. L’équipe reprend le support manuel.
Le problème ne vient pas de la plateforme, mais de la base de connaissances .
FreshdeskL'agent IA de Freshdeskreprésente un handicap majeur pour l'agent IA, qui risque de ne jamais s'en remettre.
Ce guide s'adresse aux équipes migrant vers Freshdesk (depuis Zendesk, Intercom, ServiceNowou une autre plateforme) et souhaitant que l'agent IA fournisse des réponses précises dès le premier jour de mise en production. Vous y trouverez la procédure de migration étape par étape, la checklist de nettoyage pré-migration, les règles de structure des articles sur lesquelles s'appuie l'agent IA, ainsi que le cadre de validation post-migration pour garantir la précision des réponses avant la mise en production.
1. Pourquoi la précision de Freddy AI dépend de vos connaissances
L'IA de Freshdesk, Freddy, fonctionne via AI Agent Studio. Lors de la création d'un agent IA, vous le connectez à des sources de connaissances : articles de solutions, fichiers téléchargés, URL publiques et paires question-réponse personnalisées. L'agent IA apprend ensuite de ces sources pour générer des réponses aux questions des clients.
Ici, pas de boîte noire. Freddy ne consulte ni l'historique de vos tickets, ni vos échanges de courriels, ni vos documents internes, sauf si vous le lui indiquez explicitement. La qualité de ses réponses dépend entièrement des informations que vous lui fournissez. Cela a une conséquence cruciale pour les équipes qui migrent vers Freshdesk:
Les équipes qui activent Freddy avant d'avoir terminé le nettoyage de la base de connaissances constatent généralement deux modes de défaillance : (1) des réponses hallucinées — Freddy fait référence avec assurance à des politiques ou des procédures qui n'existent plus dans votre base de connaissances mise à jour, car l'ancienne version a été migrée, et (2) une déviation de confiance nulle — Freddy dit « Je n'ai pas d'informations à ce sujet » pour des questions que votre base de connaissances couvre réellement, car les titres des articles ne correspondent pas au langage naturel utilisé par les clients.
Ce que Freddy lit réellement dans votre base de connaissances
Freddy's AI Agent Studio prend en charge quatre types de sources de connaissances :
- Articles de solutions — votre source principale. Freddy lit le titre, le contenu et les balises associées. La structure et la hiérarchie des titres influencent directement la façon dont Freddy interprète les limites des sujets.
- Questions-réponses personnalisées — paires question-réponse explicites que vous définissez. Il s’agit de la source la plus fiable : Freddy les considère comme des réponses faisant autorité.
- Fichiers — PDF, documents Word. Utiles pour les documents de politique et les spécifications techniques, mais moins structurés que les articles.
- URL — pages web publiques. Utiles pour la documentation produit hébergée en dehors de Freshdesk.
Pour une base de connaissances migrée, les articles de solution constituent la source principale. La qualité des articles, la structure des catégories et la couverture linguistique que vous importez déterminent directement les questions auxquelles Freddy peut répondre avec précision.
2. La migration de la base de connaissances compatible avec l'IA — étape par étape
La migration d'une base de connaissances vers Freshdesk se déroule en six étapes. Les étapes 1 à 4 ont lieu avant la migration. Les étapes 5 et 6 ont lieu après.
Cette section traite spécifiquement de la migration de la base de connaissances (articles, catégories, dossiers et versions linguistiques). Elle ne couvre pas la migration des tickets, des contacts ni la configuration des agents. Si vous effectuez une migration complète ou express en parallèle de celle de votre base de connaissances, suivez la procédure décrite dans le Guide de migration complète ou le Guide de migration express. La migration de votre base de connaissances doit être effectuée avant celle des tickets et avant l'activation de Freddy AI.
Étape 1 — Auditez votre base de connaissances existante
Avant toute migration, dressez un inventaire complet de votre base de connaissances actuelle. Vous devez savoir :
- Nombre total d'articles par statut (publié, brouillon, archivé)
- Structure des catégories et des dossiers — nombre de niveaux de profondeur
- Versions linguistiques — quels articles existent dans quelles langues
- Dates de dernière modification — nombre d’articles non mis à jour depuis plus de 12 mois
- Données sur la performance des articles : vues, évaluations de l’utilité et CSAT (lorsqu’elles sont disponibles)
Cet inventaire constitue votre liste de nettoyage avant migration. Tout article non mis à jour depuis 12 mois doit être examiné avant la migration. Tout article dont l'utilité est faible doit être réécrit ou supprimé. Tout article existant en anglais mais absent des autres langues prises en charge représente une lacune à combler pour que Freddy puisse servir correctement les clients non anglophones.
Étape 2 — Nettoyer avant la migration
C’est l’étape que la plupart des équipes négligent et celle qui est à l’origine de la majorité des problèmes de précision de l’IA après la migration. Le nettoyage de votre base de connaissances avant la migration comporte trois volets :
2a. Supprimer les articles obsolètes et de faible qualité
Tout article qui ne reflète plus vos produits, politiques ou procédures actuels doit être supprimé ou mis à jour avant la migration. Migrer des articles obsolètes vers Freshdesk signifie que Freddy apprendra à partir d'informations erronées. La correction est coûteuse après la migration : vous devez identifier les articles sur lesquels Freddy se base, les mettre à jour ou les supprimer, puis attendre que Freddy réapprenne. La correction avant la migration ne prend que quelques minutes par article.
2b. Normaliser les titres d'articles pour la mise en correspondance avec l'intention de l'IA
Freddy associe les requêtes des clients aux articles, notamment grâce à l'analyse des titres. Les titres d'articles utilisant un jargon interne plutôt que le langage courant (« FAQ sur la migration des abonnements » au lieu de « Comment modifier mon forfait ? ») empêchent Freddy de trouver les articles correspondant aux requêtes en langage naturel. Reformulez vos titres pour qu'ils correspondent à la façon dont les clients posent les questions, et non à la façon dont votre équipe décrit les fonctionnalités.
2c. Regrouper les articles en double et redondants
La présence de plusieurs articles traitant du même sujet avec des points de vue légèrement différents perturbe la classification de l'intention par Freddy. Il est conseillé de les fusionner en un seul article faisant autorité, doté d'un titre clair, de titres structurés et d'un premier paragraphe répondant directement à la question. Freddy est plus performant avec les articles spécifiques, à jour et autonomes.
Étape 3 — Planifiez la structure de vos catégories et dossiers pour Freddy
Freshdesk organise le contenu de sa base de connaissances en trois niveaux : catégories, dossiers et articles. Freddy utilise cette hiérarchie pour appréhender la portée des sujets. Une hiérarchie bien conçue améliore la capacité de Freddy à fournir des réponses contextuellement pertinentes. À l'inverse, une hiérarchie trop simple ou trop complexe la dégrade.
La structure recommandée pour une précision optimale de l'IA :
- Catégories : grands domaines thématiques correspondant aux principaux cas d’utilisation de votre produit (par exemple : facturation, gestion de compte, dépannage technique, prise en main)
- Dossiers : sous-thèmes spécifiques au sein de chaque catégorie (par exemple, sous Facturation : Factures, Modifications de forfait, Remboursements, Modes de paiement)
- Articles : chaque dossier contient des articles portant sur un seul sujet et proposant une réponse directe — un problème, un article
À éviter : les catégories qui mélangent des sujets sans rapport, les dossiers contenant plus de 15 articles et les articles traitant de plusieurs problèmes distincts. Chacun de ces éléments indique à Freddy que les limites des sujets sont floues.
À éviter : les catégories qui mélangent des sujets sans rapport, les dossiers contenant plus de 15 articles et les articles traitant de plusieurs problèmes distincts. Chacun de ces éléments indique à Freddy que les limites des sujets sont floues.
Étape 5 — Exécutez la migration et vérifiez la structure
Une fois votre base de connaissances source propre et votre Freshdesk définie, lancez la migration. L' connecte votre plateforme source, associe les catégories et les dossiers à leurs Freshdesk et transfère les articles en conservant leurs métadonnées, pièces jointes et traductions.
Une fois la migration terminée, avant d'activer Freddy, vérifiez :
- Le nombre d'articles dans Freshdesk correspond au nombre d'articles sur la plateforme source (par version linguistique)
- La structure des catégories et des dossiers a été correctement recréée — vérifiez les dossiers imbriqués
- Les liens internes entre les articles sont fonctionnels (mettez à jour les URL des plateformes sources codées en dur)
- Les images intégrées et les pièces jointes s'affichent et se téléchargent correctement
- Les articles en brouillon restent à l'état de brouillon (ils ne sont pas publiés accidentellement aux clients)
Étape 6 — Activez Freddy AI et validez sa précision avant la mise en production
N'activez Freddy qu'une fois la vérification de la structure de la base de connaissances terminée. Dans AI Agent Studio, connectez vos articles Freshdesk comme source de connaissances principale. N'activez pas encore l'agent IA pour les interactions clients en direct.
Le test de validation à 20 requêtes
Avant la mise en production, effectuez 20 requêtes sur Freddy correspondant aux catégories de tickets les plus fréquemment utilisées. Utilisez le langage naturel employé par vos clients, et non votre terminologie interne. Pour chaque requête, vérifiez :
- Freddy a-t-il renvoyé un article pertinent ? (et non une réponse générique par défaut)
- La réponse est-elle exacte et à jour (et non basée sur un article obsolète qui aurait dû être supprimé) ?
- Le niveau de confiance est-il approprié, sans excès de confiance dans les cas limites ?
- Pour les requêtes multilingues : Freddy renvoie-t-il la version linguistique correcte ?
Un score de 17 sur 20 ou plus (85 % de précision) est le seuil recommandé avant d'activer Freddy pour les clients. Si la précision est inférieure à 85 %, veuillez revenir à la structure de l'article et à la vérification du titre à l'étape 2 avant la mise en ligne.
3. Rédiger des articles que Freddy peut utiliser — règles de structure
Le processus de migration gère le transfert. La structure des articles détermine le traitement du contenu par Freddy après le transfert. Voici les cinq règles de structure des articles ayant le plus d'impact sur la précision de Freddy.
Règle 1 : Répondez à la question du premier paragraphe
Freddy extrait les réponses des articles pour générer des extraits optimisés. Les articles qui commencent par un contexte ou des informations générales avant la réponse peuvent générer des extraits incomplets ou hors sujet. Structurez chaque article comme suit : réponse directe (40 à 60 mots), puis explication, et enfin détails supplémentaires. Ce format améliore également l’éligibilité aux extraits de recherche Google.
Règle n° 2 : Un article, un sujet
Les articles traitant de plusieurs problèmes obligent Freddy à choisir la partie du contenu pertinente pour une requête donnée. Or, ce choix est souvent erroné. Divisez tout article abordant plusieurs problèmes ou procédures distincts en articles séparés. Les articles ainsi obtenus seront plus courts, plus clairs et Freddy les référencera plus efficacement.
Règle 3 : Utilisez le langage du client dans les titres et les en-têtes
Freddy associe les requêtes aux articles en analysant les titres et les balises H2. « Réinitialisation du mot de passe » correspond à une requête concernant un mot de passe oublié. « Processus de récupération d'identifiants » n'y correspond pas. Vérifiez que chaque titre et balise H2 d'article corresponde à la façon dont les clients formulent réellement leurs demandes d'assistance. L'historique de vos tickets est la meilleure source d'information : recherchez les sujets de tickets les plus fréquents.
Règle 4 : Inclure des étapes explicites pour le contenu procédural
Pour les articles pratiques, numérotez clairement vos étapes. Freddy reconnaît les séquences d'étapes numérotées et peut y faire référence dans les conversations à plusieurs tours (« À l'étape 3, vous devrez… ») ; cette fonctionnalité n'est disponible que si les étapes sont explicitement numérotées, et non décrites sous forme de paragraphe.
Règle 5 : Étiquetez les articles avec des mots-clés thématiques
Freshdesk vous permet d'ajouter des étiquettes aux articles de solutions. Ces étiquettes complètent la classification thématique de Freddy. Utilisez 3 à 5 étiquettes par article, reflétant le sujet, le domaine de produit et les termes de recherche courants des clients. Évitez d'utiliser des étiquettes redondantes : si une étiquette figure déjà dans le titre de l'article, elle est inutile.
4. Liste de contrôle du nettoyage de la base de connaissances avant la migration
Avant de lancer la migration, vérifiez votre base de connaissances à l'aide de cette liste de contrôle. Tout élément non traité avant la migration doit être complété dans Freshdesk après celle-ci, ce qui est plus long, plus risqué et entraîne une dégradation des performances de Freddy jusqu'à ce que la tâche soit terminée.
- Supprimer ou archiver les articles non mis à jour depuis plus de 12 mois et qui ne reflètent plus les produits ou politiques actuels
- Réécrivez les titres des articles en utilisant le langage du client (reprenez les 20 titres de tickets les plus fréquents)
- Regrouper les articles dupliqués traitant du même sujet en un seul article faisant autorité
- Vérifiez que toutes les versions linguistiques des articles sont présentes dans votre langue principale — comblez les lacunes de traduction avant la migration
- Normalisez les noms de catégories pour qu'ils correspondent aux principaux thèmes de votre produit (3 à 5 catégories maximum pour la plupart des équipes)
- Veuillez confirmer qu'il n'y a pas plus de 15 articles par dossier (divisez les dossiers trop volumineux avant la migration)
- Supprimez les liens intégrés vers la base de connaissances de la plateforme source ; ils ne fonctionneront plus après la migration
- Exportez les données de consultation et d'utilité des articles — utilisez-les pour prioriser le nettoyage des articles les plus consultés
- Marquez les articles véritablement obsolètes comme « archivés » dans la source plutôt que de les supprimer — Par défaut, l'outil Help Desk Migration ne migre que les articles publiés et les brouillons
- Effectuez un test de 20 requêtes sur votre base de connaissances source afin d'établir un score de précision de référence avant la migration
5. Quand faire appel à des services professionnels est la bonne solution
La plupart des équipes peuvent effectuer une migration de la base de connaissances en libre-service à l'aide de l'assistant Help Desk Migration . Trois scénarios indiquent que le recours à des services professionnels permettra d'obtenir de meilleurs résultats :
Bases de connaissances vastes ou complexes
Si votre base de connaissances contient plus de 500 articles dans plusieurs langues, nos services professionnels prennent en charge l'intégralité du processus : nettoyage, structuration et planification de la migration. Cette solution est particulièrement précieuse lorsque la plateforme source présente une structure de catégories non standard qui doit être repensée pour s'adapter à la hiérarchie à trois niveaux de Freshdeskavant la migration.
Migration parallèle à la migration des tickets et des contacts
Si vous effectuez une migration complète ou express (transfert simultané des tickets, contacts, entreprises et articles de la base de connaissances), les services professionnels coordonnent le séquencement. Les articles de la base de connaissances doivent être migrés et validés avant l'activation de Freddy et avant le début de la migration des tickets. La mise en place d'un séquencement correct exige une planification complexe à gérer en parallèle d'une activité de support en production.
Configuration et formation Freddy au-delà de la configuration de base
La configuration de Freddy avec des paires de questions-réponses personnalisées, plusieurs types de sources de connaissances, des automatisations de flux de travail et un déploiement multicanal (WhatsApp, chat web, Facebook) nécessite une prestation de services professionnels et non une installation en libre-service. Si vos besoins en matière d'agent IA dépassent la simple connexion d'articles de solutions à la configuration Freddy par défaut, notre équipe de services professionnels se chargera de définir et de mettre en œuvre l'ensemble de la configuration.
Commencez par une !
Avant de procéder à une migration complète de votre base de connaissances, effectuez une démonstration gratuite. Celle-ci migre 20 articles et 20 tickets (le cas échéant) vers votre Freshdesk , vous permettant ainsi de visualiser précisément le transfert de votre structure de catégories, la prise en charge des articles multilingues et de repérer d'éventuels problèmes de champs ou de formatage à résoudre avant la migration complète. La plupart des équipes identifient au moins un problème structurel lors de la démonstration, ce qui leur permet de gagner un temps précieux après la migration.
Conclusion : la qualité du KB prime, la précision de Freddy vient ensuite
L'IA Freddy n'améliore pas votre base de connaissances. C'est votre base de connaissances qui améliore Freddy. L'ordre des étapes est crucial : audit, nettoyage, structuration, migration, vérification, validation – dans cet ordre précis. Les équipes qui activent Freddy sur une base de connaissances migrée mais non nettoyée passent des semaines à corriger les problèmes de précision de l'IA, qui n'aurait jamais dû être dégradée.
La bonne nouvelle : le processus de nettoyage avant migration décrit dans ce guide a un double avantage. Les articles restructurés pour une meilleure précision de la part de Freddy sont également mieux référencés sur Google. Les titres reformulés pour correspondre au langage des clients améliorent à la fois la correspondance avec l'intention de Freddy et les taux de clics dans les résultats de recherche organiques. Vous ne fournissez pas de travail supplémentaire : vous effectuez le travail une seule fois, correctement.
Si vous migrez vers Freshdesk et souhaitez que votre base de connaissances et l'IA Freddy soient correctement configurées dès le premier jour, commencez par une migration de démonstration gratuite. En cinq minutes, vous verrez exactement comment la structure de vos articles est transférée vers Freshdesk avant de vous engager dans la migration complète.
Prochaines étapes
Effectuez votre : découvrez comment vos articles de base de connaissances sont transférés vers Freshdesk avant de vous engager : help-desk-migration.com/demo.
Contactez notre équipe de services professionnels pour discuter de la migration de votre base de connaissances et de la configuration de Freshdesk.
basé sur l’IA helpdesk et qui ont besoin d’un cadre complet pour la qualité des données.
Foire aux questions
Pour la plupart des bases de connaissances de moins de 500 articles, la migration s'effectue en quelques heures. Les bases de connaissances plus importantes, avec plusieurs versions linguistiques et une structure de dossiers complexe, peuvent nécessiter entre 6 et 12 heures. Commencez par une migration de démonstration gratuite : elle s'effectue en moins de 5 minutes et vous fournit une estimation précise en fonction du nombre et de la structure de vos articles.
Freddy ne s'active pas automatiquement après la migration. Une fois vos articles de la base de connaissances importés dans Freshdesk, vous devez les connecter comme source de connaissances dans AI Agent Studio, configurer votre agent IA et exécuter le test de validation de 20 requêtes avant d'activer Freddy pour vos clients. Prévoyez 2 à 4 heures pour la configuration de Freddy après la migration de la base de connaissances.
Oui — Help Desk Migration préserve la mise en forme des articles, y compris les titres, les listes numérotées, les puces, les tableaux et les images intégrées. Les images incorporées sont transférées avec l'article. Les liens internes pointant vers les URL de la base de connaissances de votre plateforme source devront être mis à jour avec les nouvelles URL Freshdesk après la migration. Exécutez la vérification des liens internes à l'étape 5 de ce guide immédiatement après la migration.
Help Desk Migration prend en charge la migration des bases de connaissances depuis plus de 90 plateformes, dont Zendesk, Intercom, ServiceNow, Jira Service Management, HubSpotet bien d'autres. Demandez une démonstration gratuite pour vérifier la compatibilité de votre paire source/Freshdesk et prévisualiser la structure de vos articles avant de lancer la migration complète.
Les brouillons sont transférés en tant que tels ; ils ne sont pas publiés automatiquement dans Freshdesk. Les articles publiés sont transférés tels quels. Les articles archivés ne sont pas transférés par défaut. Avant le transfert, vérifiez votre liste de brouillons : les brouillons obsolètes doivent être supprimés de la source plutôt que transférés, car ils sont comptabilisés dans le total de vos articles et peuvent apparaître dans la liste des sources de connaissances d'AI Agent Studio.
Help Desk Migration transfère toutes les versions linguistiques simultanément en une seule opération. Il n'est pas nécessaire d'effectuer des migrations distinctes par langue. Avant la migration, vérifiez sur votre plateforme source que les versions traduites des articles sont publiées ou en brouillon. Les versions en attente de traduction risquent de ne pas pouvoir être exportées via l'API et doivent être traduites avant le début de la migration.
Une migration de base de connaissances bien structurée et nettoyée améliore la précision de Freddy. À l'inverse, une migration mal structurée ou non nettoyée la dégrade. Le processus en six étapes décrit dans ce guide — audit, nettoyage, structuration, migration, vérification, validation — est spécifiquement conçu pour garantir que la précision de Freddy s'améliore dès la migration, et non après des semaines de nettoyage post-migration.
Les articles de solution sont, dans la base de connaissances Freshdesk, les articles publiés et visibles par les clients et les agents. Les sources de connaissances Freddy correspondent aux types de contenu à partir desquels Freddy AI apprend ; il s’agit notamment des articles de solution, mais aussi des questions-réponses personnalisées, des fichiers et des URL. Lorsque vous activez Freddy AI, vos articles de solution sont connectés comme source de connaissances. Les règles de qualité et de structure des articles décrites dans ce guide s’appliquent spécifiquement aux articles de solution.
