Ferndesk
Migrationen

Migrieren Sie Ihr Hilfezentrum zu Ferndesk

Ferndesk kann Ihre vorhandenen Hilfezentrum-Inhalte von den meisten gängigen Plattformen importieren. Die Migration läuft während des Onboardings automatisch ab und übernimmt Ihre Artikel, Sammlungen, Bilder und Links, während Weiterleitungen eingerichtet werden, um Ihr SEO zu erhalten.

Unterstützte Plattformen

Sie können aus diesen Plattformen importieren:

  • Crisp

  • Document360

  • Docusaurus

  • Fernand

  • Featurebase

  • GitBook

  • HelpDocs

  • HelpJuice

  • HelpKit

  • Help Scout

  • HubSpot

  • Intercom

  • KnowledgeOwl

  • Mintlify

  • Plain

  • ProProfsKB

  • Zendesk

Wenn Ihre Plattform nicht aufgeführt ist oder Ihr Hilfezentrum privat ist, kontaktieren Sie den Support, und wir helfen Ihnen beim Migrieren.

So funktioniert die Migration

Die Migration erfolgt automatisch während des Onboardings. Wenn Sie Ihr Ferndesk-Konto erstellen, werden Sie gefragt, ob Sie ein vorhandenes Hilfezentrum importieren möchten.

Der Import läuft im Hintergrund. Sie können die Seite verlassen und später zurückkehren, um den Fortschritt zu prüfen. Große Hilfezentren können mehrere Minuten dauern.

Was übernommen wird

Ferndesk bewahrt während der Migration Folgendes:

  • Artikel und Sammlungen, einschließlich Struktur und Formatierung

  • Bilder und eingebettete Inhalte

  • Links zwischen Artikeln und zu externen Seiten

  • Anker-Links zu bestimmten Abschnitten innerhalb von Artikeln

  • Ältere URL-Formate aus Ihrer Quellplattform

Ferndesk richtet außerdem automatische Weiterleitungen von Ihren alten URLs zu Ihren neuen ein. Dadurch bleibt Ihr SEO erhalten und es wird sichergestellt, dass Lesezeichen oder geteilte Links weiterhin beim richtigen Artikel landen.

URL- und Slug-Normalisierung

Während des Imports normalisiert Ferndesk die URLs von Artikeln und Sammlungen, damit sie den Anforderungen an öffentliche URLs entsprechen:

  • Ungültige Zeichen entfernt: Satzzeichen und Sonderzeichen werden aus Slugs entfernt

  • Kleingeschrieben und mit Bindestrichen: Alle Slugs verwenden Kleinbuchstaben, Zahlen und Bindestriche

Das bedeutet, dass sich die URLs Ihrer importierten Artikel leicht von den URLs Ihrer Quellplattform unterscheiden können. Die automatischen Weiterleitungen stellen sicher, dass alte Links weiterhin funktionieren.

Einzelheiten zu den Regeln zur Slug-Validierung finden Sie unter Artikel-SEO-Einstellungen konfigurieren.

Wenn die Migration abgeschlossen ist, überprüfen Sie einige Artikel, um sicherzustellen, dass interne Links, Anker-Links und Bilder korrekt funktionieren. Wenn Sie defekte Links finden, kontaktieren Sie den Support für Hilfe.

Für benutzerdefinierte Weiterleitungen nach der Migration siehe Weiterleitungen des Hilfezentrums verwalten.

Bilderverwaltung während der Migration

Während der Migration lädt Ferndesk Bilder aus Ihren Quellartikeln herunter und schreibt deren URLs um, sodass sie auf Ihr Ferndesk-Hilfezentrum verweisen. Wenn ein Quellbild nicht erreichbar ist, weil die URL nicht mehr existiert oder die Quellplattform externen Zugriff blockiert, überspringt Ferndesk dieses Bild und fährt mit dem restlichen Import fort. Der Artikel behält die ursprüngliche Bild-URL, sodass Sie sie später ersetzen können.

Dieses Überspringen gilt nur für Migrationen. Wenn Sie nach der Migration über den Editor oder die API ein Bild zu einem Artikel hinzufügen, führt ein fehlgeschlagener Upload wie gewohnt weiterhin zu einem fehlgeschlagenen Request.

Nach der Migration

Ihre importierten Inhalte erscheinen in Ihrem Ferndesk-Dashboard als Entwürfe. Überprüfen Sie Ihre Artikel, nehmen Sie bei Bedarf Anpassungen vor und veröffentlichen Sie sie, wenn Sie bereit sind. Sie können Artikel einzeln oder gesammelt veröffentlichen.

Brauchen Sie Hilfe?

Wenn während der Migration Probleme auftreten, kontaktieren Sie den Support, und wir helfen Ihnen weiter.

Häufig gestellte Fragen

Werden meine alten URLs nach der Migration noch funktionieren?

Ja. Ferndesk richtet automatische Weiterleitungen von Ihren alten Hilfezentrum-URLs zu Ihren neuen Ferndesk-URLs ein. Jeder mit einem gespeicherten oder geteilten Link gelangt weiterhin zum richtigen Artikel.

Kann ich ein privates oder passwortgeschütztes Hilfezentrum migrieren?

Ja, aber nicht über den automatischen Onboarding-Flow. Kontaktieren Sie den Support, und wir helfen Ihnen, eine manuelle Migration für private Hilfezentren zu arrangieren.

Kann ich für die Migration eine lokale oder interne URL verwenden?

Nein. Ferndesk importiert während des Onboardings nur von öffentlich zugänglichen Websites. URLs, die auf localhost, interne Netzwerk-Hostnamen oder private IP-Adressen verweisen, werden aus Sicherheitsgründen blockiert.

Dazu gehören:

  • localhost und 127.0.0.1

  • Domänen, die auf .local, .internal oder .localhost enden

  • Private IP-Adressbereiche (10.x.x.x, 172.16.x.x-172.31.x.x, 192.168.x.x)

  • URLs, die auf eines der oben genannten Ziele umleiten

Wenn Ihr Hilfezentrum nicht öffentlich zugänglich ist, kontaktieren Sie den Support, um eine manuelle Migration zu vereinbaren.

Was passiert mit meinen Bildern und eingebetteten Inhalten?

Bilder und Assets werden zusammen mit Ihren Artikeln importiert. Eingebettete Videos und Einbettungen von Drittanbietern funktionieren weiterhin wie zuvor, da sie auf externe Quellen verweisen.

Benötige ich API-Keys oder Kontozugriff für die Migration?

Nein. Bei öffentlichen Hilfezentren importiert Ferndesk Inhalte direkt über die URL Ihres Hilfezentrums. Keine API-Keys oder Kontoverknüpfungen erforderlich.

Kann ich von einer Plattform migrieren, die nicht auf der unterstützten Liste steht?

Möglicherweise. Kontaktieren Sie den Support mit Details zu Ihrer aktuellen Plattform, und wir teilen Ihnen mit, was möglich ist.

Fehlerbehebung

Meine Plattform wurde nicht automatisch erkannt

Stellen Sie sicher, dass Sie die richtige URL des Hilfezentrums verwenden. Es sollte die öffentliche Adresse sein, unter der Ihre Artikel angezeigt werden, nicht Ihre interne Admin-URL. Wenn die URL korrekt ist und die Erkennung weiterhin fehlschlägt, kontaktieren Sie den Support.

Meine Website verwendet JavaScript-Rendering und einige Artikel wurden nicht importiert

Ferndesk verwendet Firecrawl, um JavaScript-gesteuerte Seiten vor dem Import zu rendern. Wenn Ihre Website darauf angewiesen ist, Inhalte per JavaScript anzuzeigen, verarbeitet die Migrations-Engine jetzt sowohl aktuelle als auch ältere Firecrawl-Antwortformate, damit gerenderte Seiten zuverlässig importiert werden.

Wenn weiterhin fehlende Artikel von einer JS-gerenderten Website angezeigt werden, stellen Sie sicher, dass die URL Ihres Hilfezentrums öffentlich zugänglich ist, und kontaktieren Sie den Support, damit wir das untersuchen können.

Einige Artikel fehlen nach dem Import

Das kann passieren, wenn bestimmte Artikel in Ihrer Quellplattform als privat, Entwurf oder eingeschränkt festgelegt sind. Überprüfen Sie die Sichtbarkeitseinstellungen Ihrer Quellplattform. Wenn alle Artikel hätten importiert werden sollen, kontaktieren Sie den Support mit einer Liste der fehlenden Artikel.

Bilder werden nicht korrekt angezeigt

Bildimporte können fehlschlagen, wenn die Quellplattform externen Zugriff auf Bilddateien blockiert. Während der Migration überspringt Ferndesk Bilder, die nicht abgerufen werden können, und fährt mit dem restlichen Import fort. Der Artikel behält die ursprüngliche Bild-URL, die möglicherweise defekt erscheint, wenn die Quelle nicht mehr zugänglich ist.

Wenn Ihnen nach der Migration fehlende oder defekte Bilder auffallen, kontaktieren Sie den Support, und wir helfen Ihnen beim Abrufen.

Die Migration dauert zu lange

Große Hilfezentren mit vielen Artikeln und Bildern können mehrere Minuten für den Import benötigen. Sie können die Seite verlassen und später zurückkehren, um den Fortschritt zu prüfen. Wenn die Migration länger als 30 Minuten festzuhängen scheint, kontaktieren Sie den Support.

War das hilfreich?