Ferndesk
Migrations

Migrer votre centre d’aide vers Ferndesk

Ferndesk peut importer le contenu de votre centre d’aide existant depuis la plupart des grandes plateformes. La migration s’effectue automatiquement pendant l’onboarding et conserve vos articles, collections, images et liens, tout en configurant des redirections pour préserver votre SEO.

Plateformes prises en charge

Vous pouvez importer depuis ces plateformes :

  • Crisp

  • Document360

  • Docusaurus

  • Fernand

  • Featurebase

  • GitBook

  • HelpDocs

  • HelpJuice

  • HelpKit

  • Help Scout

  • HubSpot

  • Intercom

  • KnowledgeOwl

  • Mintlify

  • Plain

  • ProProfsKB

  • Zendesk

Si votre plateforme ne figure pas dans la liste ou si votre centre d’aide est privé, contactez l’assistance et nous pourrons vous aider à migrer.

Comment fonctionne la migration

La migration se fait automatiquement pendant l’onboarding. Lorsque vous créez votre compte Ferndesk, il vous sera demandé si vous avez 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 la progression. Les grands centres d’aide peuvent prendre plusieurs minutes.

Ce qui est conservé

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 dans les articles

  • Anciens formats d’URL de votre plateforme source

Ferndesk configure également des redirections automatiques de vos anciennes URL vers les nouvelles. Cela préserve votre SEO et garantit que les liens enregistrés ou partagés renvoient toujours vers le bon article.

Normalisation des URL et des slugs

Lors de l’importation, Ferndesk normalise les URL des articles et des collections afin qu’elles respectent ses exigences d’URL publiques :

  • Caractères non valides supprimés : la ponctuation et les caractères spéciaux sont retirés des slugs

  • En minuscules et avec des tirets : tous les slugs utilisent des lettres minuscules, des chiffres et des tirets

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

Pour en savoir plus 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 cassés, contactez l’assistance pour obtenir de l’aide.

Pour les 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 depuis vos articles source et réécrit leurs URL pour qu’elles pointent vers votre centre d’aide Ferndesk. Si une image source est inaccessible parce que l’URL est morte 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 plus tard.

Ce comportement d’omission est spécifique aux migrations. Si vous ajoutez une image à un article via l’éditeur ou l’API après la migration, un envoi en échec échouera toujours la requête comme d’habitude.

Après la migration

Votre contenu importé apparaît dans votre tableau de bord Ferndesk sous forme de brouillons. Relisez vos articles, apportez les ajustements nécessaires, puis publiez-les quand vous êtes prêt. Vous pouvez publier des articles individuellement ou en lot.

Besoin d’aide ?

Si vous rencontrez un problème pendant la migration, contactez l’assistance et nous vous aiderons à régler la situation.

Foire aux questions

Les anciennes URL fonctionneront-elles encore 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é ou partagé arrivera toujours sur le bon article.

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

Oui, mais pas via le flux d’onboarding automatique. Contactez l’assistance 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 n’importe que depuis des sites web accessibles publiquement pendant l’onboarding. Les URL pointant vers localhost, les 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

  • 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 publiquement, contactez l’assistance pour organiser une migration manuelle.

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

Les images et ressources sont importées avec vos articles. Les vidéos intégrées et les intégrations tierces continuent de fonctionner comme auparavant, puisqu’elles font référence à des sources externes.

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

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

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

C’est possible. Contactez l’assistance avec des détails sur votre plateforme actuelle et nous vous dirons ce qui est possible.

Dépannage

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

Vérifiez que vous utilisez la bonne URL de centre d’aide. Il s’agit 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 encore, contactez l’assistance.

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

Ferndesk utilise Firecrawl pour rendre les pages pilotées par JavaScript avant de les importer. Si votre site s’appuie sur JavaScript pour afficher le contenu, le moteur de migration prend désormais en charge à la fois les formats de réponse Firecrawl actuels et hérités afin que les pages rendues soient importées de manière fiable.

Si vous voyez encore des articles manquants sur un site rendu en JS, vérifiez que l’URL de votre centre d’aide est accessible publiquement et contactez l’assistance 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, en brouillon ou restreints dans votre plateforme source. Vérifiez les paramètres de visibilité de votre plateforme source. Si tous les articles auraient dû être importés, contactez l’assistance avec une 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 d’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 cassée si la source n’est plus accessible.

Si vous remarquez des images manquantes ou cassées après la migration, contactez l’assistance et nous pourrons vous aider à les récupérer.

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

La plupart des liens internes et des liens d’ancrage sont conservés automatiquement. Si vous trouvez des liens cassés, 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 cassé, contactez l’assistance.

La migration prend trop de temps

Les grands centres d’aide 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 l’assistance.

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