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’exécute automatiquement pendant la configuration initiale et conserve 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 :

Archbee
Crisp
Document360
Docusaurus
Fernand
Featurebase
Fumadocs
GitBook
Gleap
HelpDocs
HelpJuice
HelpKit
Help Scout
HubSpot
Intercom
KnowledgeOwl
Mintlify
Plain
Slite
Stoplight
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’exécute en arrière-plan. Vous pouvez quitter la page et revenir plus tard pour vérifier l’avancement. Les centres d’aide volumineux peuvent prendre plusieurs minutes.

Éléments conservés

Ferndesk conserve les éléments suivants pendant la migration :

Articles et collections, y compris la structure et la mise en forme
Images et ressources intégrées
Liens entre les articles et vers des pages externes
Liens d’ancrage vers des sections spécifiques des articles
Anciens formats d’URL de votre plateforme source
Icônes d’articles et de collections, remplacées par un équivalent visuel lorsqu’une icône source n’a pas de correspondance exacte

Ferndesk configure également des redirections automatiques de vos anciennes URL vers les nouvelles. Votre référencement naturel est ainsi préservé et les liens enregistrés dans les favoris ou partagés continuent de diriger 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 traits d’union : tous les slugs utilisent des lettres minuscules, des chiffres et des traits d’union

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érifier vos liens après la migration

Une fois la migration terminée, examinez quelques articles pour confirmer que les liens internes, les liens d’ancrage et les images fonctionnent correctement. Si vous trouvez des liens brisés, 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’image d’origine 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éversement 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. Relisez 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.

Foire aux questions

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 disposant d’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. Les URL pointant vers localhost, des noms d’hôte de réseau interne ou des adresses IP privées sont bloquées pour des raisons de sécurité.

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, puisqu’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 nécessaire.

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 indiquant des informations sur votre plateforme actuelle et nous vous dirons ce qui est possible.

Dépannage

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

Assurez-vous d’utiliser 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 votre 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 basées sur JavaScript avant de les importer. Si votre site s’appuie sur JavaScript pour afficher son contenu, le moteur de migration prend désormais en charge les formats de réponse actuels et hérités de Firecrawl afin que les pages rendues soient importées de manière fiable.

Si des articles sont toujours manquants sur un site rendu en JS, assurez-vous que l’URL de votre centre d’aide est accessible au public et contactez le support afin que nous puissions enquêter.

Certains articles sont manquants après l’importation

Cela peut se produire si certains articles sont définis comme privés, brouillons 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 lui fournissant 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’image d’origine, qui peut sembler brisée si la source n’est plus accessible.

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

Les liens internes sont brisés après la migration

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

La migration prend trop de temps

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

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