Ferndesk
Migrationen

Migrieren Sie Ihr Help Center zu Ferndesk

Ferndesk kann Ihre vorhandenen Help-Center-Inhalte von den meisten großen Plattformen importieren. Die Migration läuft während der Einrichtung automatisch ab und übernimmt Ihre Artikel, Sammlungen, Bilder und Links. Gleichzeitig werden Weiterleitungen eingerichtet, damit Ihre SEO erhalten bleibt.

Unterstützte Plattformen

Sie können von diesen Plattformen importieren:

  • Crisp

  • Document360

  • Docusaurus

  • Fernand

  • Featurebase

  • GitBook

  • Gleap

  • HelpDocs

  • HelpJuice

  • HelpKit

  • Help Scout

  • HubSpot

  • Intercom

  • KnowledgeOwl

  • Mintlify

  • Plain

  • Slite

  • ProProfsKB

  • Zendesk

Wenn Ihre Plattform nicht aufgeführt ist oder Ihr Help Center privat ist, kontaktieren Sie den Support, damit wir Ihnen bei der Migration helfen können.

So funktioniert die Migration

Die Migration erfolgt automatisch während der Einrichtung. Wenn Sie Ihr Ferndesk-Konto erstellen, werden Sie gefragt, ob Sie bereits über ein Help Center verfügen, das importiert werden soll.

Der Import läuft im Hintergrund. Sie können die Seite verlassen und später zurückkehren, um den Fortschritt zu überprüfen. Bei großen Help Centern kann der Vorgang mehrere Minuten dauern.

Was wird übernommen?

Ferndesk übernimmt während der Migration Folgendes:

  • Artikel und Sammlungen einschließlich Struktur und Formatierung

  • Bilder und eingebettete Ressourcen

  • Verknüpfungen zwischen Artikeln und zu externen Seiten

  • Ankerlinks zu bestimmten Abschnitten innerhalb von Artikeln

  • Ältere URL-Formate Ihrer Quellplattform

  • Artikel- und Sammlungssymbole; wenn ein Quellsymbol nicht exakt zugeordnet werden kann, wird ein optisch entsprechendes Symbol verwendet

Ferndesk richtet außerdem automatische Weiterleitungen von Ihren alten URLs zu den neuen URLs ein. Dadurch bleibt Ihre SEO erhalten und über Lesezeichen oder geteilte Links aufgerufene Seiten führen weiterhin zum richtigen Artikel.

Normalisierung von URLs und Slugs

Während des Imports normalisiert Ferndesk die URLs von Artikeln und Sammlungen entsprechend den Anforderungen an öffentliche URLs:

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

  • Kleinbuchstaben und Bindestriche: Alle Slugs verwenden Kleinbuchstaben, Zahlen und Bindestriche

Das bedeutet, dass sich die URLs Ihrer importierten Artikel geringfügig von den URLs Ihrer Quellplattform unterscheiden können. Die automatischen Weiterleitungen sorgen dafür, dass alte Links weiterhin funktionieren.

Details zu den Regeln für die Slug-Validierung finden Sie unter SEO-Einstellungen für Artikel konfigurieren.

Überprüfen Sie nach Abschluss der Migration einige Artikel, um sicherzustellen, dass interne Links, Ankerlinks und Bilder ordnungsgemäß funktionieren. Wenn Sie fehlerhafte Links finden, kontaktieren Sie den Support.

Informationen zu benutzerdefinierten Weiterleitungen nach der Migration finden Sie unter Weiterleitungen im Help Center verwalten.

Umgang mit Bildern während der Migration

Während der Migration lädt Ferndesk Bilder aus Ihren Quellartikeln herunter und schreibt ihre URLs so um, dass sie auf Ihr Ferndesk Help Center verweisen. Wenn ein Quellbild nicht erreichbar ist, weil die URL nicht mehr gültig ist oder die Quellplattform den externen Zugriff blockiert, überspringt Ferndesk dieses Bild und setzt den restlichen Import fort. Der Artikel behält die ursprüngliche Bild-URL, sodass Sie das Bild später ersetzen können.

Dieses Überspringverhalten 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 dazu, dass die Anfrage fehlschlägt.

Nach der Migration

Ihre importierten Inhalte werden in Ihrem Ferndesk-Dashboard als Entwürfe angezeigt. Überprüfen Sie Ihre Artikel, nehmen Sie gegebenenfalls Anpassungen vor und veröffentlichen Sie sie, sobald sie fertig sind. Sie können Artikel einzeln oder gesammelt veröffentlichen.

Benötigen Sie Hilfe?

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

Häufig gestellte Fragen

Funktionieren meine alten URLs nach der Migration weiterhin?

Ja. Ferndesk richtet automatische Weiterleitungen von den URLs Ihres alten Help Centers zu Ihren neuen Ferndesk-URLs ein. Personen mit einem als Lesezeichen gespeicherten oder geteilten Link gelangen weiterhin zum richtigen Artikel.

Kann ich ein privates oder passwortgeschütztes Help Center migrieren?

Ja, jedoch nicht über den automatischen Einrichtungsprozess. Kontaktieren Sie den Support, damit wir eine manuelle Migration für private Help Center organisieren können.

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

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

Dazu gehören:

  • localhost und 127.0.0.1

  • Domains mit der Endung .local, .internal oder .localhost

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

  • URLs, die zu einem der oben genannten Ziele weiterleiten

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

Was geschieht mit meinen Bildern und eingebetteten Inhalten?

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

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

Nein. Bei öffentlichen Help Centern importiert Ferndesk die Inhalte direkt über die URL Ihres Help Centers. Es sind keine API-Schlüssel oder Kontoverbindungen erforderlich.

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

Möglicherweise. Kontaktieren Sie den Support mit Angaben 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 Ihres Help Centers verwenden. Dabei sollte es sich um die öffentlich zugängliche Adresse handeln, unter der Ihre Artikel angezeigt werden, nicht um 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 auf JavaScript angewiesen ist, um Inhalte anzuzeigen, verarbeitet die Migrations-Engine jetzt sowohl aktuelle als auch ältere Antwortformate von Firecrawl, damit gerenderte Seiten zuverlässig importiert werden.

Wenn weiterhin Artikel von einer per JavaScript gerenderten Website fehlen, stellen Sie sicher, dass die URL Ihres Help Centers öffentlich zugänglich ist, und kontaktieren Sie den Support, damit wir die Ursache untersuchen können.

Nach dem Import fehlen einige Artikel

Dies kann passieren, wenn bestimmte Artikel auf Ihrer Quellplattform als privat, Entwurf oder eingeschränkt eingestellt sind. Überprüfen Sie die Sichtbarkeitseinstellungen Ihrer Quellplattform. Wenn alle Artikel importiert worden sein sollten, kontaktieren Sie den Support und senden Sie eine Liste der fehlenden Artikel.

Bilder werden nicht korrekt angezeigt

Bildimporte können fehlschlagen, wenn die Quellplattform den externen Zugriff auf Bilddateien blockiert. Während der Migration überspringt Ferndesk Bilder, die nicht abgerufen werden können, und setzt den restlichen Import fort. Der Artikel behält die ursprüngliche Bild-URL, die möglicherweise fehlerhaft angezeigt wird, wenn die Quelle nicht mehr erreichbar ist.

Wenn Ihnen nach der Migration fehlende oder fehlerhafte Bilder auffallen, kontaktieren Sie den Support. Wir helfen Ihnen dabei, sie wiederherzustellen.

Die Migration dauert zu lange

Bei großen Help Centern mit zahlreichen Artikeln und Bildern kann der Import mehrere Minuten dauern. Sie können die Seite verlassen und später zurückkehren, um den Fortschritt zu überprüfen. Wenn die Migration länger als 30 Minuten festzustecken scheint, kontaktieren Sie den Support.

War das hilfreich?
War das hilfreich?