Ferndesk
Migraciones

Migra tu centro de ayuda a Ferndesk

Ferndesk puede importar el contenido de tu centro de ayuda existente desde la mayoría de las principales plataformas. La migración se ejecuta automáticamente durante la incorporación y conserva tus artículos, colecciones, imágenes y enlaces, al tiempo que configura redirecciones para mantener tu SEO.

Plataformas compatibles

Puedes importar desde estas plataformas:

  • Crisp

  • Document360

  • Docusaurus

  • Fernand

  • Featurebase

  • GitBook

  • HelpDocs

  • HelpJuice

  • HelpKit

  • Help Scout

  • HubSpot

  • Intercom

  • KnowledgeOwl

  • Mintlify

  • Plain

  • ProProfsKB

  • Zendesk

Si tu plataforma no aparece en la lista o tu centro de ayuda es privado, contacta con soporte y te ayudaremos a migrarlo.

Cómo funciona la migración

La migración ocurre automáticamente durante la incorporación. Cuando crees tu cuenta de Ferndesk, se te preguntará si ya tienes un centro de ayuda existente para importar.

La importación se ejecuta en segundo plano. Puedes abandonar la página y volver más tarde para comprobar el progreso. Los centros de ayuda grandes pueden tardar varios minutos.

Qué se conserva

Ferndesk conserva lo siguiente durante la migración:

  • Artículos y colecciones, incluida la estructura y el formato

  • Imágenes y recursos incrustados

  • Enlaces entre artículos y a páginas externas

  • Enlaces de anclaje a secciones específicas dentro de los artículos

  • Formatos de URL anteriores de tu plataforma de origen

Ferndesk también configura redirecciones automáticas desde tus antiguas URL a las nuevas. Esto conserva tu SEO y garantiza que los enlaces guardados o compartidos sigan llevando al artículo correcto.

Normalización de URL y slugs

Durante la importación, Ferndesk normaliza las URL de los artículos y las colecciones para que cumplan los requisitos de su URL pública:

  • Caracteres no válidos eliminados: Se eliminan la puntuación y los caracteres especiales de los slugs

  • En minúsculas y con guiones: Todos los slugs usan letras minúsculas, números y guiones

Esto significa que las URL de los artículos importados pueden diferir ligeramente de las URL de tu plataforma de origen. Las redirecciones automáticas garantizan que los enlaces antiguos sigan funcionando.

Para obtener más detalles sobre las reglas de validación de slugs, consulta Configurar ajustes de SEO del artículo.

Comprobación de tus enlaces después de la migración

Después de que la migración se complete, revisa algunos artículos para confirmar que los enlaces internos, los enlaces de anclaje y las imágenes funcionan correctamente. Si encuentras enlaces rotos, contacta con soporte para obtener ayuda.

Para redirecciones personalizadas después de la migración, consulta Gestionar redirecciones del centro de ayuda.

Gestión de imágenes durante la migración

Durante la migración, Ferndesk descarga las imágenes de tus artículos de origen y reescribe sus URL para que apunten a tu centro de ayuda de Ferndesk. Si no se puede acceder a una imagen de origen porque la URL no funciona o la plataforma de origen bloquea el acceso externo, Ferndesk omite esa imagen y continúa con el resto de la importación. El artículo conserva la URL original de la imagen para que puedas reemplazarla más adelante.

Este comportamiento de omisión es específico de las migraciones. Si agregas una imagen a un artículo mediante el editor o la API después de la migración, un fallo de subida seguirá haciendo fallar la solicitud como siempre.

Después de la migración

Tu contenido importado aparece en tu panel de Ferndesk como borradores. Revisa tus artículos, haz los ajustes necesarios y publícalos cuando estés listo. Puedes publicar los artículos de forma individual o en bloque.

¿Necesitas ayuda?

Si encuentras algún problema durante la migración, contacta con soporte y te ayudaremos a solucionarlo.

Preguntas frecuentes

¿Seguirán funcionando mis antiguas URL después de la migración?

Sí. Ferndesk configura redirecciones automáticas desde las URL antiguas de tu centro de ayuda a tus nuevas URL de Ferndesk. Cualquiera que tenga un enlace guardado o compartido seguirá llegando al artículo correcto.

¿Puedo migrar un centro de ayuda privado o protegido con contraseña?

Sí, pero no mediante el flujo automático de incorporación. Contacta con soporte y te ayudaremos a organizar una migración manual para centros de ayuda privados.

¿Puedo usar una URL local o interna para la migración?

No. Ferndesk solo importa sitios web accesibles públicamente durante la incorporación. Las URL que apuntan a localhost, nombres de host de red interna o direcciones IP privadas se bloquean por motivos de seguridad.

Esto incluye:

  • localhost y 127.0.0.1

  • Dominios que terminan en .local, .internal o .localhost

  • Rangos de direcciones IP privadas (10.x.x.x, 172.16.x.x-172.31.x.x, 192.168.x.x)

  • URL que redirigen a cualquiera de las anteriores

Si tu centro de ayuda no es accesible públicamente, contacta con soporte para organizar una migración manual.

¿Qué ocurre con mis imágenes y contenido incrustado?

Las imágenes y los recursos se importan junto con tus artículos. Los vídeos incrustados y los elementos incrustados de terceros siguen funcionando como antes, ya que hacen referencia a fuentes externas.

¿Necesito claves de API o acceso a la cuenta para migrar?

No. Para los centros de ayuda públicos, Ferndesk importa el contenido directamente desde la URL de tu centro de ayuda. No se necesitan claves de API ni conexiones de cuenta.

¿Puedo migrar desde una plataforma que no está en la lista de compatibles?

Es posible. Contacta con soporte con detalles sobre tu plataforma actual y te diremos qué es posible.

Solución de problemas

Mi plataforma no se detectó automáticamente

Asegúrate de que estás usando la URL correcta del centro de ayuda. Debe ser la dirección pública donde se muestran tus artículos, no la URL interna de administración. Si la URL es correcta y la detección sigue fallando, contacta con soporte.

Mi sitio usa renderizado con JavaScript y algunos artículos no se importaron

Ferndesk usa Firecrawl para renderizar las páginas impulsadas por JavaScript antes de importarlas. Si tu sitio depende de JavaScript para mostrar contenido, el motor de migración ahora gestiona tanto las estructuras de respuesta actuales como las heredadas de Firecrawl para que las páginas renderizadas se importen de forma fiable.

Si todavía ves artículos que faltan en un sitio renderizado con JS, asegúrate de que la URL de tu centro de ayuda sea accesible públicamente y contacta con soporte para que podamos investigarlo.

Faltan algunos artículos después de la importación

Esto puede ocurrir si determinados artículos están configurados como privados, borrador o restringidos en tu plataforma de origen. Revisa la configuración de visibilidad de tu plataforma de origen. Si todos los artículos deberían haberse importado, contacta con soporte con una lista de los artículos que faltan.

Las imágenes no se muestran correctamente

Las importaciones de imágenes pueden fallar si la plataforma de origen bloquea el acceso externo a los archivos de imagen. Durante la migración, Ferndesk omite las imágenes que no puede obtener y continúa con el resto de la importación. El artículo conserva la URL original de la imagen, que puede aparecer rota si la fuente ya no es accesible.

Si notas imágenes que faltan o rotas después de la migración, contacta con soporte y te ayudaremos a recuperarlas.

Los enlaces internos están rotos después de la migración

La mayoría de los enlaces internos y de anclaje se conservan automáticamente. Si encuentras enlaces rotos, comprueba que el artículo de destino se haya importado o exista en tu centro de ayuda publicado. Si ambos artículos existen y el enlace sigue roto, contacta con soporte.

La migración está tardando demasiado

Los centros de ayuda grandes con muchos artículos e imágenes pueden tardar varios minutos en importarse. Puedes abandonar la página y volver más tarde para comprobar el progreso. Si la migración parece estar atascada durante más de 30 minutos, contacta con soporte.

¿Te fue útil?