Ir al contenido principal

Importar artículos públicos desde Zendesk

Cómo migrar tu contenido desde una knowledge base de Zendesk en minutos.

Escrito por Beth-Ann Sher

Cómo funciona

Puedes importar fácilmente tu contenido público de ayuda de Zendesk en Intercom, sin necesidad de código. Esto te permite hacer de Intercom tu única fuente de verdad para artículos de soporte y usarlos para potenciar las funciones de IA de Intercom.

El importador de Zendesk está construido sobre una robusta y resistente canalización de servicio que reduce significativamente los errores y mejora la velocidad y fiabilidad de la integración de tu contenido.

Una vez que tus artículos estén en Intercom, puedes:

  • Usarlos para potenciar Fin AI Agent y Copilot con respuestas automáticas y precisas.

  • Hacerlos accesibles en el Inbox para que los compañeros los compartan en conversaciones.

  • Destacarlos en tu Help Center para que los clientes puedan autoatenderse.

Consejo: El importador también extrae metadatos valiosos de la fuente desde Zendesk, como etiquetas y categorías, y los aplica como tags a tus artículos en Intercom. Esto te ayuda a organizar el contenido y aplicar reglas para una resolución de IA más efectiva.

Nota: Esto intentará migrar todos tus artículos de ayuda publicados desde Zendesk. Para agregar artículos específicos, recomendamos copiarlos y agregarlos al Knowledge Hub en Intercom individualmente.


Elegir cómo conectar tus datos

Tienes dos opciones para gestionar tu contenido de Zendesk en Intercom.

Importar contenido

Elige esta opción si quieres hacer de Intercom tu nueva única fuente de verdad.

  • Esto realiza una migración única de todos tus artículos publicados de Zendesk a Intercom.

  • Una vez importados, la conexión se corta. Los cambios hechos en Zendesk no se reflejarán en Intercom.

  • Luego puedes editar y gestionar estos artículos directamente dentro de Intercom.

Sincronizar contenido

Elige esta opción para sincronizar una versión actualizada continuamente y de solo lectura de tu contenido. Zendesk sigue siendo tu fuente de verdad.

  • Esto es ideal para potenciar Fin AI Agent con tu knowledge base existente sin migrar.

  • La sincronización es fiable y transparente, asegurando que Fin siempre tenga el contenido más reciente.

  • Seguirás editando y gestionando tus artículos en Zendesk.


Antes de importar

Antes de comenzar, recomendamos habilitar indexación en motores de búsqueda en la configuración de tu Help Center para evitar retrasos en la aparición de tus artículos en los resultados de búsqueda. Puedes hacerlo yendo a Configuración > Help Center y haciendo clic en "configurar y estilizar":

Encontrarás la opción para habilitar la búsqueda de índice bajo General > Privacidad:


Conexión mediante token API

Usa este método para importar tu contenido de Zendesk usando un token API seguro.

Paso 1: Generar un token API de Zendesk

Primero, genera un token API en tu Zendesk Admin Center.

  1. En Zendesk, ve al Admin Center.

  2. Navega a Apps and integrations > APIs > Zendesk API.

  3. Haz clic en la pestaña API token y luego en Add API token.

  4. Ponle un nombre descriptivo al token (por ejemplo, "Intercom Integration") y cópialo. Cópialo y guárdalo en un lugar seguro. Zendesk no lo mostrará de nuevo.

Paso 2: Conectar Zendesk en Intercom

  1. Desde tu espacio de trabajo en Intercom, ve a Knowledge > Sources.

  2. Bajo Public articles, encuentra Zendesk y haz clic en Sync or Import.

  3. Introduce los detalles de tu conexión:

    • Introduce Subdomain: Proporciona tu subdominio de Zendesk (por ejemplo, mydomain.zendesk.com).

    • Elige Autenticación: Selecciona API Token para conectar.

    • Haz clic en Connect.

    • Opcionalmente, puedes activar "Sincronizar artículos para usuarios autenticados" para incluir contenido visible solo para usuarios autenticados.

      Cuando el proceso de Connect termine, puedes pasar al siguiente paso.

  4. Después de que Zendesk se conecte a Intercom, puedes usar la pestaña Metadata para prefiltrar exactamente qué contenido de Zendesk debe importarse a Intercom. Elige entre campos principales o tags personalizados para extender tu filtrado y segmentación. Haz clic en + Add Filter para reducir el contenido según criterios específicos como Categorías, Etiquetas o Marcas de tiempo. Si omites este paso, el importador traerá todo el contenido elegible por defecto.

  5. Usa la pestaña Target para decidir dónde se usa tu contenido importado en Intercom.

    • Fin AI Agent: Activa esto para usar artículos de Zendesk para respuestas automatizadas al cliente.

    • Copilot: Activa esto para proporcionar respuestas sugeridas a tus compañeros.

    • Help Center: Activa esto si quieres publicar el contenido de Zendesk directamente en tu Help Center de Intercom.

    • Control de audiencia: Elige qué audiencias específicas (por ejemplo, "Plan Enterprise" o "Audiencia del Reino Unido") pueden ver este contenido.

  6. Haz una revisión final de tu configuración antes de comenzar la importación.

    • Ingrese un nombre personalizado para la importación para identificarla en su lista de Knowledge (por ejemplo, "Zendesk - Public Support").

    • Revise el resumen para ver exactamente cuántos artículos y campos se están importando según sus filtros de metadata.

    • Verifique que sus configuraciones de Available in y Audience sean correctas.

  7. Haga clic en Sync and set live para comenzar la transformación de su contenido de Zendesk en artículos de Intercom.


Conectando vía OAuth

Paso 1: Autenticar Zendesk

Para importar su contenido, primero debe autenticar su fuente Zendesk:

  1. Ingrese su subdomain de Zendesk (por ejemplo, mydomain.zendesk.com).

  2. Seleccione OAuth como su método de autenticación.

  3. Haga clic en Connect.

Una vez establecida la conexión, puede opcionalmente activar Sync articles for signed-in users para incluir contenido visible solo para clientes autenticados. Haga clic en Next cuando la conexión sea exitosa.

Su subdomain es la parte de su URL antes de .zendesk.com. Por ejemplo, si su URL es https://help.zendesk.com, su subdomain es help.

Paso 2: Metadata

Después de que Zendesk se conecte a Intercom, use la pestaña Metadata para prefiltrar exactamente qué contenido debe ser traído a Intercom:

  • Elija entre campos principales o etiquetas personalizadas para limitar su importación.

  • Haga clic en + Add Filter para seleccionar contenido basado en criterios específicos como Categories, Labels o Timestamps.

Si omite este paso, el importador traerá todo el contenido elegible por defecto.

Paso 3: Target

Use la pestaña Target para decidir dónde se usa su contenido importado en Intercom:

  • Fin AI Agent: Active esto para usar artículos de Zendesk para respuestas automatizadas al cliente.

  • Copilot: Habilite esto para proporcionar respuestas sugeridas a sus compañeros de equipo.

  • Help Center: Active esto para publicar contenido de Zendesk directamente en su Help Center de Intercom.

  • Audience Control: Elija qué audiencias específicas (por ejemplo, "Enterprise plan") pueden ver este contenido.

Paso 4: Revisión

Haga una revisión final antes de comenzar la importación:

  1. Ingrese un nombre personalizado para la importación para identificarla en su lista de Knowledge (por ejemplo, "Zendesk - Public Support").

  2. Revise el resumen para ver el número de artículos y campos que se están importando.

  3. Verifique que sus configuraciones de Available in y Audience sean correctas.

Haga clic en Sync and set live para comenzar.


Importando con el importador heredado

  1. Para comenzar a importar artículos públicos, vaya a Knowledge Hub > Sources.

  2. En Public articles, busque Zendesk y haga clic en Sync or Import.

  3. Ahora ingrese su subdomain de Zendesk y elija la opción de “Import content” luego continúe y haga clic en Import.

Nota:

  • El importador heredado será descontinuado después del 25 de abril. Después de esta fecha:

    • Las sincronizaciones manuales y automáticas se detendrán.

    • Aún puede ejecutar una importación única en cualquier momento, pero la sincronización no se reanudará hasta que cambie al nuevo importador.

    • Una vez que esté en el nuevo importador (o después de editar una fuente migrada), tendrá acceso a los nuevos filtros y funciones de metadata.

  • Para iniciar una importación de artículos desde Zendesk usando el importador heredado, debe iniciar sesión con acceso de administrador para autenticar.

  • Necesitará elegir el Help Center objetivo en Intercom si usa Multi Help Center.

  • Si importa, sus artículos de Zendesk se convertirán en artículos públicos nativos que puede gestionar en Intercom.

  • Para importar artículos multilingües desde Zendesk, necesitará agregar los idiomas adicionales en la configuración de su Help Center, para que las traducciones importadas sean visibles.

  • Su dominio personalizado de Intercom Help Center debe estar configurado antes de la importación para que las redirecciones se generen usando el dominio personalizado.

Ahora, espere a que la importación se complete. Durante este tiempo rastrearemos su sitio de documentos, importaremos todos sus artículos publicados y los colocaremos en colecciones de Help Center que coincidan con la estructura de su knowledge base existente. Esto podría tomar desde unos minutos hasta una hora o más. Le enviaremos un correo electrónico cuando termine, así que no es necesario esperar 😄

Después de que la migración haya finalizado, actualice la página de Content en Knowledge para ver sus artículos importados en carpetas en la barra lateral izquierda.

Aprenda a gestionar artículos públicos desde Knowledge y habilítelos para Fin AI Agent y Copilot.

Importante: Si aún no lo ha hecho, deberá activar su Help Center o sus artículos no se publicarán ni podrán habilitarse para Fin o Copilot.

Después del 25 de abril

Una vez que el importador heredado sea descontinuado, estos son los cambios:

  • Las sincronizaciones manuales y automáticas se detendrán.

  • Aún puedes realizar una importación única en cualquier momento, pero la sincronización no se reanudará hasta que cambies al nuevo importador.

  • Una vez que estés en el nuevo importador (o después de editar una fuente migrada), tendrás acceso a los nuevos filtros y funciones de metadatos.


Después de la conexión

Comenzaremos a rastrear tu sitio Zendesk, importando tus artículos publicados y estructurándolos en colecciones que coincidan con tu knowledge base existente. Cualquier etiqueta o categoría de Zendesk se añadirá como etiquetas a los artículos en Intercom.

Este proceso puede tardar desde unos minutos hasta una hora. Te enviaremos un correo electrónico cuando esté completo. Puedes verificar el estado en cualquier momento en Knowledge > Sources.

Después de la migración, actualiza la página Content en Knowledge para ver tus artículos importados.


Cómo se importan los metadatos de Zendesk

Para ahorrarte tiempo, el importador trae automáticamente la estructura de tu knowledge base de Zendesk a Intercom.

Los metadatos de Zendesk como etiquetas, categorías y etiquetas de contenido se importan y convierten en etiquetas en tus artículos de Intercom.

Estos metadatos son críticos para que tu contenido sea útil. Con estas etiquetas aplicadas automáticamente, puedes:

  • Filtrar tu contenido en la sección Knowledge para ver artículos por una categoría determinada.

  • Excluir contenido irrelevante del Fin AI Agent.

  • Dirigir respuestas a la audiencia correcta creando audiencias específicas de Fin AI Agent basadas en las etiquetas de los artículos.

Por ejemplo, si tienes contenido en Zendesk etiquetado como "EMEA-only", esa etiqueta se convertirá en una etiqueta en Intercom. Luego puedes crear una audiencia para tus clientes europeos en Fin AI Agent y configurarla para usar solo artículos con la etiqueta "EMEA-only".


Redirecciones de artículos Zendesk

Las redirecciones de artículos se generan automáticamente durante el proceso de importación, y con la nueva canalización de importación, son más confiables que nunca. Aunque las URL de los artículos de Zendesk e Intercom tienen formatos diferentes, las redirecciones aseguran que cualquier enlace existente no se rompa después de la migración, preservando su puntuación SEO.

Las redirecciones se implementan en forma de redirecciones permanentes (respuestas HTTP 301).

Cómo funciona la coincidencia de redirecciones

Las redirecciones se emparejan con el ID numérico estable del artículo incrustado en la URL de Zendesk, no con el slug, que puede cambiar. Esto significa que todas las variantes de URL para el mismo artículo se asignan a un solo registro de redirección y al mismo artículo de Intercom.

Visitante llega a (URL original de Zendesk)

Redirige a

/hc/en-us/articles/12345678-how-to-reset-password

Artículo de Intercom

/hc/en-us/articles/12345678-reset-your-password

Mismo artículo de Intercom

/hc/en-us/articles/12345678

Mismo artículo de Intercom

Nota: Las redirecciones se crean automáticamente durante la importación y nunca bloquearán la importación si algo sale mal.

Soporte multilingüe

Al importar colecciones y artículos en varios idiomas, cada variante de idioma tendrá su propia redirección asociada con la URL original del artículo de Zendesk.

Revisión de redirecciones existentes

Después de que la importación esté completa, puedes revisar las redirecciones generadas a través de la sección Domains en Settings > Help Center > Configure and style:

Desde aquí, desplázate hacia abajo hasta Domains y haz clic en "manage redirects":

El panel muestra la URL original y el artículo/colección al que redirige.

Importante:

  • Las redirecciones solo se mostrarán para el dominio personalizado elegido. Por ejemplo, si estás importando artículos de un Help Center de Zendesk en https://support.examply.com, las redirecciones aparecerán en la sección de domain solo si has seleccionado support.examply.com como tu custom domain y estás usando el protocolo de seguridad HTTPS.

  • Si no estás listo para cambiar tu CNAME para apuntar a Intercom para tu custom domain, aún puedes crear las redirecciones al importar desde Zendesk agregando tu custom domain en tu Help Center de Intercom y seleccionando la opción de usar el protocolo de seguridad HTTPS.

  • Con Multi Help Center, las redirecciones no están conectadas a un Help Center específico. En cambio, están vinculadas a un domain. Esto significa que las redirecciones aparecerán en cualquier Help Center que use el mismo domain donde se encontraban los artículos de Zendesk.

  • Las redirecciones estarán disponibles para todos los artículos que se hayan importado desde Zendesk después del 22 de septiembre de 2022.


Contenido sin categorizar

Si tienes contenido sin categorizar en tu sitio, Articles creará automáticamente una colección ‘General’ para ti. Las colecciones ayudan a tus users a navegar y encontrar fácilmente lo que necesitan, así que considera reorganizar estos artículos por tema antes de publicarlos.


Contenido que aún no soportamos

Convertiremos tu contenido al formato que soportamos (por ejemplo, copiando imágenes). Sin embargo, aún no soportamos el siguiente formato:

La importación desde URL de categoría/colección tampoco está soportada. Necesitarás importar tu knowledge base desde la URL principal.


Artículos con formato no soportado

Si hay algún problema al importar tu contenido, añadiremos una etiqueta Review al artículo para que puedas corregirlo antes de publicarlo. Solo abre el artículo que necesitas revisar y lee la recomendación que hemos añadido. La recomendación actúa como marcador de posición, por lo que deberás eliminarla e insertar el contenido que recomendamos antes de publicar el artículo.


Preguntas frecuentes

¿Cuál es mi subdominio de Zendesk?

Este es el domain de tu cuenta Zendesk (no la URL de tu Help Center). Tu subdomain de Zendesk es su identificador único y hay varias formas de encontrarlo que puedes ver aquí.

Mi Help Center tiene artículos en 2 idiomas pero solo veo uno después de la importación?

Intercom importará todos los idiomas soportados, pero no habilitaremos ese idioma para el Help Center. Tendrás que agregar el idioma en sus configuraciones del Help Center, y después de eso la traducción será visible.

¿Tengo un artículo localizado en EN-US y EN-GB y se importó en dos artículos diferentes?

Intercom solo soporta una lista corta de versiones localizadas de idiomas: Portugués / Portugués Brasileño, Alemán / Alemán (Formal), Chino Tradicional / Simplificado.

Para todas las otras versiones localizadas, las asignamos al idioma más cercano soportado en Intercom (ej: EN-GB, EN-US, EN-AU todos se asignan a EN). En caso de conflicto, creamos un artículo diferente para cada versión localizada para evitar pérdida de datos.

Tengo artículos en irlandés pero no se importaron, ¿qué pasó?

Solo importamos artículos en uno de los idiomas soportados por el Intercom Messenger.

El correo dice que se importaron “X” artículos, pero solo veo “Y” en mi Help Center?

El total listado en el correo incluye todos los diferentes idiomas en los que existe el artículo. Un artículo con traducciones en inglés, francés y portugués contará como 3 artículos en el correo.

¿Cuál es la diferencia entre "Sincronizar contenido" e "Importar contenido" desde Zendesk?

La principal diferencia entre sincronizar contenido e importar contenido desde Zendesk es dónde planeas editar tus artículos en el futuro.

  • Elige sincronizar contenido si quieres mantener Zendesk como tu editor principal. Esto crea una versión solo de vista de tus artículos en Intercom que se mantiene actualizada con tu knowledge base de Zendesk.

  • Elige importar contenido si quieres migrar completamente a Intercom. Esto crea una copia editable de tus artículos en Intercom, que se convierte en tu nueva fuente única de verdad.

Si elimino un artículo en Zendesk, ¿también se eliminará de Intercom?

Sí, si eliminas un artículo en Zendesk mientras tienes una sincronización activa configurada, también se eliminará de Intercom. Esto sucede automáticamente durante la siguiente sincronización para asegurar que ambas knowledge bases permanezcan consistentes.

¿Es seguro usar una clave API de Zendesk para autenticación?

Sí, es seguro usar una clave API de Zendesk para autenticación. Este es un método estándar y seguro para conectar aplicaciones que otorga a Intercom permisos específicos para acceder a tus artículos sin exponer tu contraseña de administrador u otra información sensible de la cuenta.

¿Ha quedado contestada tu pregunta?