Migración de Zendesk Guide desde otra plataforma: Una guía completa para 2026

Mover tu base de conocimientos a una nueva plataforma es uno de esos proyectos que suena sencillo hasta que empiezas. De repente, te encuentras lidiando con jerarquías de contenido, enlaces rotos, archivos adjuntos faltantes y permisos de usuario que no se asignan de la manera que esperabas.

Esta guía te explica cómo migrar a Zendesk Guide desde otra plataforma. Ya sea que vengas de Freshdesk, Gorgias o una solución personalizada, aprenderás los métodos disponibles, los escollos que debes evitar y cómo decidir si la migración es la decisión correcta para tu equipo.

¿Qué es Zendesk Guide y por qué migrar a él?

Zendesk Guide es el componente de base de conocimientos de la plataforma de servicio al cliente de Zendesk. Te permite crear, organizar y publicar artículos de ayuda a los que los clientes pueden acceder a través de un centro de ayuda de marca.

Los equipos suelen migrar a Guide por algunas razones:

• Consolidación Ya estás utilizando Zendesk para la gestión de tickets y deseas informes unificados
• Mejor búsqueda La búsqueda impulsada por IA de Zendesk muestra artículos relevantes de forma más eficaz que los sistemas heredados
• Enfoque de autoservicio Estás invirtiendo en la desviación y deseas una base de conocimientos diseñada para el autoservicio del cliente
• Crecimiento Tu plataforma actual no puede escalar con tu contenido o volumen de usuarios

Aquí está la versión corta: Guide funciona mejor si estás comprometido con el ecosistema de Zendesk. La base de conocimientos se integra estrechamente con los tickets de Zendesk, los agentes de IA y el análisis. Si no estás utilizando Zendesk para el soporte, Guide se convierte en una opción independiente costosa.

Planificación de tu migración a Zendesk Guide

La preparación separa las migraciones fluidas de los desastres. Antes de tocar cualquier dato, debes comprender con qué estás trabajando.

¿Qué datos puedes migrar?

Lista de verificación previa a la migración

• Audita tu contenido Elimina duplicados, artículos obsoletos y páginas huérfanas
• Mapea tu estructura Documenta tu jerarquía actual (carpetas, categorías, secciones) y planifica cómo se asigna a la estructura de Categorías → Secciones → Artículos de Guide
• Configura campos personalizados Crea campos en Zendesk para almacenar ID y metadatos heredados
• Crea cuentas de agente Tus autores de contenido necesitan cuentas de Zendesk antes de la migración
• Desactiva los activadores Desactiva las notificaciones para que los clientes no reciban spam durante la migración

Métodos de migración comparados

Tienes tres enfoques principales para introducir datos en Zendesk Guide. Cada uno se adapta a diferentes niveles de habilidad técnica y complejidades de migración.

Método 1: API de Zendesk (para equipos técnicos)

La API de Zendesk te da control total. Escribes scripts para extraer datos de tu sistema de origen e introducirlos en Guide a través de puntos finales REST.

Ideal para: Conjuntos de datos grandes, transformaciones complejas o cuando necesitas preservar relaciones específicas

Ventajas:

• Control total sobre la asignación de datos
• Maneja correctamente los archivos adjuntos y las imágenes en línea
• Puede ejecutarse de forma incremental y reanudarse si se interrumpe
• Gratis (más allá de tu tiempo de desarrollo)

Desventajas:

• Requiere recursos de ingeniería
• Se aplican límites de velocidad (~2.000 tickets/hora)
• Tú manejas todos los casos de error y las condiciones límite

Método 2: Herramientas de migración de terceros

Servicios como Help Desk Migration e Import2 proporcionan interfaces sin código para transferir datos.

Ideal para: Equipos sin desarrolladores que necesitan una migración fiable y rápida

Precios de Help Desk Migration:

Precios de muestra: ~$100 por 1.000 registros, ~$514 por 10.000 registros (precios no lineales)

Import2: Ofrece una migración de muestra gratuita en menos de 15 minutos. El precio es personalizado en función del volumen y las plataformas.

Método 3: Importación manual de CSV

Zendesk admite la importación de CSV para datos básicos de tickets y usuarios. Para el contenido de la base de conocimientos, esto es limitado y generalmente no se recomienda para nada más allá de un puñado de artículos.

Ideal para: Conjuntos de datos pequeños o transferencias únicas de registros específicos

Proceso de migración paso a paso

Aquí te mostramos cómo funciona la migración real, suponiendo que estés utilizando una herramienta de terceros o un enfoque de API.

Paso 1: Activa Zendesk Guide

Guide no está habilitado de forma predeterminada. Navega a Centro de administración → Configuración de Guide para activarlo. También querrás configurar el tema de tu centro de ayuda y la marca básica antes de importar contenido.

Paso 2: Crea tu estructura de contenido

Antes de importar artículos, configura el esqueleto:

1. Importa o crea tus agentes como usuarios de Zendesk
2. Crea categorías (organización de nivel superior)
3. Crea secciones dentro de cada categoría
4. Documenta todos los ID, los necesitarás para el siguiente paso

Guide utiliza una jerarquía de tres niveles: Categorías → Secciones → Artículos. Los planes Enterprise admiten hasta seis niveles con subsecciones.

Paso 3: Importa artículos

Ahora el trabajo pesado. Usando tu método elegido:

• Asigna contenido HTML al formato de artículo de Zendesk
• Maneja las imágenes en línea (necesitan una carga separada y un reemplazo de URL)
• Conserva las marcas de tiempo originales si es posible (requiere API)
• Almacena los ID heredados en campos personalizados para referencia

Paso 4: Maneja archivos adjuntos e imágenes

Los archivos adjuntos no se migran automáticamente con el texto del artículo. Necesitas:

• Cargar archivos adjuntos a través de la API o manualmente
• Actualizar el HTML del artículo para que apunte a las nuevas URL de los archivos adjuntos
• Probar que todas las imágenes y archivos se carguen correctamente

Paso 5: Establece permisos y segmentos de usuarios

Configura quién puede ver qué:

• Artículos públicos (visibles para todos)
• Solo usuarios registrados
• Segmentos de usuarios específicos (artículos internos, contenido VIP, etc.)

Paso 6: Valida y entra en funcionamiento

Antes de accionar el interruptor:

• Compara el recuento de artículos entre los sistemas antiguos y nuevos
• Verifica el formato, especialmente los bloques de código y las tablas
• Prueba la funcionalidad de búsqueda
• Configura redireccionamientos 301 desde las URL de tu antiguo centro de ayuda

Errores comunes de migración y cómo evitarlos

Después de revisar docenas de migraciones, estos son los problemas que surgen una y otra vez:

Se pierden los ID originales Zendesk genera nuevos ID para todo. Crea campos personalizados para almacenar tus ID heredados para que puedas hacer referencia a los números de ticket y los ID de artículo antiguos.

Confusión de zona horaria Las exportaciones JSON usan UTC. Las exportaciones CSV usan la zona horaria de tu cuenta. Documenta tus zonas horarias antes de exportar o las marcas de tiempo serán incorrectas.

Archivos adjuntos rotos Planifica un flujo de trabajo de migración de archivos adjuntos separado. No asumas que vendrán con el texto del artículo.

Comentarios faltantes Las conversaciones secundarias y las notas internas a menudo no se transfieren automáticamente. Es posible que debas convertirlas en notas privadas durante la migración.

Spam de notificaciones Siempre desactiva los activadores y las automatizaciones antes de la migración. No quieres que los clientes reciban notificaciones sobre cada ticket importado.

Problemas de formato Prueba la representación HTML, especialmente para bloques de código, tablas y medios incrustados. Lo que se ve bien en tu sistema antiguo puede romperse en Guide.

Una alternativa moderna a la migración: eesel AI

Aquí hay algo que las guías de migración rara vez mencionan: es posible que no necesites migrar en absoluto.

En eesel AI, adoptamos un enfoque diferente. En lugar de mover todo tu contenido a una nueva plataforma, nuestro agente de IA se conecta directamente a tu help desk existente, ya sea Zendesk, Freshdesk, Gorgias u otra plataforma, y aprende de tu contenido donde ya reside.

Así es como funciona:

1. Conéctate en minutos Sin migración de datos. Nos integramos con tu help desk existente y aprendemos de tus tickets, centro de ayuda y macros.

2. Comienza con la orientación Como cualquier nuevo empleado, nuestra IA comienza redactando respuestas para que tu equipo las revise. Verificas que comprenda tu negocio antes de expandir su función.

3. Sube de nivel a autónomo A medida que la IA demuestra su valía, puedes hacer que gestione el soporte de primera línea directamente, escalando solo los casos límite que definas.

4. Control en lenguaje sencillo Sin configuración compleja. Dile a la IA cosas como "Siempre escala las disputas de facturación a un humano" o "Para los clientes VIP, copia al gerente de cuenta".

¿El resultado? Obtienes soporte impulsado por IA sin el proyecto de migración de meses de duración. Tu equipo sigue trabajando con las herramientas que conoce. Tus clientes obtienen respuestas más rápidas. Y evitas el riesgo de pérdida de datos o enlaces rotos que conlleva cualquier migración importante de plataforma.

También ofrecemos AI Copilot para equipos que desean asistencia de IA sin automatización completa, y AI Triage para etiquetar, enrutar y priorizar automáticamente los tickets. Nuestra integración de Zendesk AI funciona a la perfección con tu configuración existente de Zendesk.

Consulta nuestros precios para obtener más detalles: cobramos por interacción, no por agente, por lo que no se te penaliza por hacer crecer tu equipo.

Elegir el enfoque correcto para tu equipo

Entonces, ¿qué camino debes tomar? Aquí hay un marco simple:

Migra a Zendesk Guide si:

• Ya estás comprometido con Zendesk para la gestión de tickets
• Necesitas informes unificados en todos los tickets y conocimientos
• Estás retirando tu antigua plataforma por completo
• Tienes los recursos para un proyecto de migración de varias semanas

Aumenta con eesel AI si:

• Tu plataforma actual todavía funciona bien
• Los costos de migración (tiempo + dinero) son demasiado altos
• Deseas los beneficios de la IA sin cambiar de plataforma
• Necesitas mostrar resultados rápidamente

En resumen: La migración es un medio para un fin, no el fin en sí mismo. Si tu objetivo es un mejor soporte al cliente, el aumento de la IA a menudo ofrece resultados más rápidos con menos riesgo que una migración completa de la plataforma.