Migrez votre centre d’aide vers Ferndesk

Ferndesk peut importer le contenu existant de votre centre d’aide depuis la plupart des grandes plateformes. La migration s’effectue automatiquement pendant la configuration initiale et préserve vos articles, collections, images et liens, tout en configurant des redirections pour préserver votre référencement naturel.

Plateformes prises en charge

Vous pouvez importer depuis les plateformes suivantes :

Crisp
Document360
Docusaurus
Fernand
Featurebase
GitBook
HelpDocs
HelpJuice
HelpKit
Help Scout
HubSpot
Intercom
KnowledgeOwl
Mintlify
Plain
Slite
ProProfsKB
Zendesk

Si votre plateforme ne figure pas dans la liste ou si votre centre d’aide est privé, contactez le support et nous vous aiderons à effectuer la migration.

Fonctionnement de la migration

La migration s’effectue automatiquement pendant la configuration initiale. Lorsque vous créez votre compte Ferndesk, il vous sera demandé si vous disposez d’un centre d’aide existant à importer.

L’importation s’effectue en arrière-plan. Vous pouvez quitter la page et revenir plus tard pour vérifier la progression. Les centres d’aide volumineux peuvent prendre plusieurs minutes.

Éléments préservés

Ferndesk préserve les éléments suivants pendant la migration :

Articles et collections, y compris leur structure et leur mise en forme
Images et ressources intégrées
Liens entre les articles et vers des pages externes
Liens d’ancrage vers des sections précises des articles
Anciens formats d’URL de votre plateforme source
Icônes des articles et des collections, associées à un équivalent visuel lorsque l’icône source n’a pas de correspondance exacte

Ferndesk configure également des redirections automatiques de vos anciennes URL vers les nouvelles. Cela préserve votre référencement naturel et garantit que les liens enregistrés dans les favoris ou partagés dirigent toujours vers le bon article.

Normalisation des URL et des slugs

Pendant l’importation, Ferndesk normalise les URL des articles et des collections afin de respecter ses exigences en matière d’URL publiques :

Caractères non valides supprimés : la ponctuation et les caractères spéciaux sont supprimés des slugs
Minuscules et tirets : tous les slugs utilisent des lettres minuscules, des chiffres et des tirets

Cela signifie que les URL de vos articles importés peuvent différer légèrement de celles de votre plateforme source. Les redirections automatiques garantissent que les anciens liens continuent de fonctionner.

Pour plus d’informations sur les règles de validation des slugs, consultez Configurer les paramètres SEO des articles.

Vérification de vos liens après la migration

Une fois la migration terminée, consultez quelques articles pour vérifier que les liens internes, les liens d’ancrage et les images fonctionnent correctement. Si vous trouvez des liens rompus, contactez le support pour obtenir de l’aide.

Pour configurer des redirections personnalisées après la migration, consultez Gérer les redirections du centre d’aide.

Gestion des images pendant la migration

Pendant la migration, Ferndesk télécharge les images de vos articles sources et réécrit leurs URL pour qu’elles pointent vers votre centre d’aide Ferndesk. Si une image source est inaccessible parce que son URL n’est plus valide ou que la plateforme source bloque l’accès externe, Ferndesk ignore cette image et poursuit le reste de l’importation. L’article conserve l’URL d’origine de l’image afin que vous puissiez la remplacer ultérieurement.

Ce comportement d’ignorance est propre aux migrations. Si vous ajoutez une image à un article via l’éditeur ou l’API après la migration, un échec du téléchargement entraînera toujours l’échec de la requête, comme d’habitude.

Après la migration

Votre contenu importé apparaît sous forme de brouillons dans votre tableau de bord Ferndesk. Vérifiez vos articles, apportez les modifications nécessaires, puis publiez-les lorsque vous êtes prêt. Vous pouvez publier les articles individuellement ou en masse.

Besoin d’aide ?

Si vous rencontrez des problèmes pendant la migration, contactez le support et nous vous aiderons à les résoudre.

Questions fréquentes

Mes anciennes URL fonctionneront-elles toujours après la migration ?

Oui. Ferndesk configure des redirections automatiques de vos anciennes URL de centre d’aide vers vos nouvelles URL Ferndesk. Toute personne utilisant un lien enregistré dans ses favoris ou partagé sera toujours dirigée vers le bon article.

Puis-je migrer un centre d’aide privé ou protégé par mot de passe ?

Oui, mais pas via le processus automatique de configuration initiale. Contactez le support et nous pourrons organiser une migration manuelle pour les centres d’aide privés.

Puis-je utiliser une URL locale ou interne pour la migration ?

Non. Ferndesk importe uniquement depuis des sites web accessibles au public pendant la configuration initiale. Pour des raisons de sécurité, les URL pointant vers localhost, des noms d’hôte de réseau interne ou des adresses IP privées sont bloquées.

Cela inclut :

localhost et 127.0.0.1
Les domaines se terminant par .local, .internal ou .localhost
Les plages d’adresses IP privées (10.x.x.x, 172.16.x.x-172.31.x.x, 192.168.x.x)
Les URL qui redirigent vers l’un des éléments ci-dessus

Si votre centre d’aide n’est pas accessible au public, contactez le support pour organiser une migration manuelle.

Que deviennent mes images et mon contenu intégré ?

Les images et les ressources sont importées avec vos articles. Les vidéos intégrées et les contenus tiers continuent de fonctionner comme auparavant, car ils font référence à des sources externes.

Ai-je besoin de clés API ou d’un accès au compte pour effectuer la migration ?

Non. Pour les centres d’aide publics, Ferndesk importe directement le contenu depuis l’URL de votre centre d’aide. Aucune clé API ni connexion à un compte n’est requise.

Puis-je migrer depuis une plateforme qui ne figure pas dans la liste des plateformes prises en charge ?

C’est possible. Contactez le support en précisant votre plateforme actuelle et nous vous indiquerons ce qui est possible.

Dépannage

Ma plateforme n’a pas été détectée automatiquement

Vérifiez que vous utilisez l’URL correcte de votre centre d’aide. Il doit s’agir de l’adresse publique où vos articles sont affichés, et non de l’URL d’administration interne. Si l’URL est correcte et que la détection échoue toujours, contactez le support.

Mon site utilise le rendu JavaScript et certains articles n’ont pas été importés

Ferndesk utilise Firecrawl pour effectuer le rendu des pages générées en JavaScript avant de les importer. Si votre site dépend de JavaScript pour afficher son contenu, le moteur de migration gère désormais les formats de réponse Firecrawl actuels et hérités afin d’importer les pages rendues de manière fiable.

Si des articles manquent toujours sur un site utilisant le rendu JS, vérifiez que l’URL de votre centre d’aide est accessible au public et contactez le support afin que nous puissions enquêter.

Certains articles manquent après l’importation

Cela peut se produire si certains articles sont définis comme privés, en brouillon ou restreints sur votre plateforme source. Vérifiez les paramètres de visibilité de votre plateforme source. Si tous les articles auraient dû être importés, contactez le support en joignant la liste des articles manquants.

Les images ne s’affichent pas correctement

L’importation des images peut échouer si la plateforme source bloque l’accès externe aux fichiers image. Pendant la migration, Ferndesk ignore les images qu’il ne peut pas récupérer et poursuit le reste de l’importation. L’article conserve l’URL d’origine de l’image, qui peut apparaître comme rompue si la source n’est plus accessible.

Si vous remarquez des images manquantes ou rompues après la migration, contactez le support et nous vous aiderons à les récupérer.

Les liens internes sont rompus après la migration

La plupart des liens internes et des liens d’ancrage sont préservés automatiquement. Si vous trouvez des liens rompus, vérifiez que l’article cible a bien été importé ou qu’il existe dans votre centre d’aide en ligne. Si les deux articles existent et que le lien est toujours rompu, contactez le support.

La migration prend trop de temps

Les centres d’aide volumineux contenant de nombreux articles et images peuvent prendre plusieurs minutes à importer. Vous pouvez quitter la page et revenir plus tard pour vérifier la progression. Si la migration semble bloquée pendant plus de 30 minutes, contactez le support.

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