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 a 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 origen de 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.

Nota: La importación funciona en dos etapas: Intercom primero sincroniza tu contenido de Zendesk, luego lo convierte en artículos nativos. Una vez completada la importación, la sincronización se elimina automáticamente. Cualquier filtro de sincronización de Zendesk se elimina y tu contenido se convierte en artículos editables regulares en tu espacio de trabajo.

Sincronizar contenido

Elige esta opción para sincronizar una versión actualizada continuamente y solo de 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 la indexación en motores de búsqueda en la configuración de tu Help Center para evitar retrasos en que tus artículos aparezcan en los resultados de búsqueda. Puedes hacerlo yendo a Configuración > Help Center y haciendo clic en "configurar y estilo":

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

Nota: El contenido se importa en el idioma que estaba configurado en Zendesk. Para inglés, solo se soportan EN-US, EN-UK y EN-CA; no hay opción genérica EN. Los artículos importados tampoco se colocarán automáticamente en una colección; deberás organizarlos manualmente después de la importación.


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 Añadir token API.

  4. Dale al token un nombre descriptivo (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 Subdominio: Proporciona tu subdominio de Zendesk (por ejemplo, mydomain.zendesk.com).

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

    • Haz clic en Conectar.

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

      Cuando el proceso de Conexión 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 ampliar tu filtrado y segmentación. Haz clic en + Añadir filtro 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 en respuestas automatizadas al cliente.

    • Copilot: Actívalo para proporcionar respuestas sugeridas a tus compañeros.

    • Help Center: Actívalo si quieres publicar el contenido de Zendesk directamente en tu Help Center de Intercom.

    • Control de audiencia: Elige qué audiencias específicas (por ejemplo, "Enterprise plan" o "UK audience") pueden ver este contenido.

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

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

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

    • Verifica que tus configuraciones de Disponible en y Audience sean correctas.

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


Conectando vía OAuth

Paso 1: Autenticar Zendesk

Para importar tu contenido, primero necesitas autenticar tu fuente Zendesk:

  1. Introduce tu subdomain de Zendesk (por ejemplo, mydomain.zendesk.com).

  2. Selecciona OAuth como tu método de autenticación.

  3. Haz clic en Connect.

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

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

Paso 2: Metadata

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

  • Elige entre campos principales o etiquetas personalizadas para delimitar tu importación.

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

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

Paso 3: Destino

Usa la pestaña Target para decidir dónde se usará tu contenido importado en Intercom:

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

  • Copilot: Actívalo para proporcionar respuestas sugeridas a tus compañeros.

  • Help Center: Activa esto para publicar contenido de Zendesk directamente en tu Help Center de Intercom.

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

Paso 4: Revisión

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

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

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

  3. Verifica que tus configuraciones de Disponible en y Audience sean correctas.

Haz clic en Sync and set live para comenzar.


Importando con el importador heredado

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

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

  3. Ahora introduce tu subdomain de Zendesk y elige la opción “Import content”, luego haz 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 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 metadata.

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

  • Necesitarás elegir el Help Center destino en Intercom si usas Multi Help Center.

  • Si importas, tus artículos de Zendesk se convertirán en artículos públicos nativos que puedes gestionar en Intercom.

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

  • Tu 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, espera a que la importación se complete. Durante este tiempo rastrearemos tu sitio de documentos, importaremos todos tus artículos publicados y los colocaremos en colecciones de Help Center que coincidan con la estructura de tu knowledge base existente. Esto puede tomar desde unos minutos hasta una hora o más. Te enviaremos un correo cuando termine, así que no necesitas esperar 😄

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

Aprende a gestionar artículos públicos desde Knowledge y habilitarlos para Fin AI Agent y Copilot.

Importante: Si aún no lo has hecho, necesitarás activar tu Help Center o tus artículos no se publicarán ni podrán habilitarse para Fin o Copilot.

Después del 25 de abril

Una vez que se descontinúe el importador heredado, esto es lo que cambia:

  • 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 tags a los artículos en Intercom. Los artículos importados no se colocarán automáticamente en una colección; usa los tags importados para filtrar y organizar tu contenido.

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 que la importación esté completa, ve a Knowledge > All Content para encontrar tus artículos importados. Aparecerán como artículos individuales, no dentro de una colección. Usa los tags importados de Zendesk para filtrarlos y organizarlos.


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 tags de contenido se importan y convierten en tags en tus artículos de Intercom.

Estos metadatos son críticos para que tu contenido sea útil. Con estos tags aplicados 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 tags de artículos.

Por ejemplo, si tienes contenido en Zendesk etiquetado como "EMEA-only", esa etiqueta se convertirá en un tag en Intercom. Luego puedes crear una audiencia para tus clientes europeos en Fin AI Agent y configurarla para usar solo artículos con el tag "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 URLs de 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 Configuración > Help Center > Configurar y estilo:

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

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 importas artículos de un Help Center de Zendesk en https://support.examply.com, las redirecciones aparecerán en la sección de dominios solo si has seleccionado support.examply.com como tu dominio personalizado y estás usando el protocolo de seguridad HTTPS.

  • Si no estás listo para cambiar tu CNAME para apuntar a Intercom para tu dominio personalizado, aún puedes crear las redirecciones al importar desde Zendesk agregando tu dominio personalizado 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 dominio. Esto significa que las redirecciones aparecerán en cualquier Help Center que use el mismo dominio donde se encontraban los artículos de Zendesk.

  • Las redirecciones estarán disponibles para todos los artículos importados de 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:

Importar desde URL de categoría/colección tampoco está soportado. 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 un 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 de Zendesk (no la URL de tu Help Center). Tu subdominio 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 la configuración 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: Portuguese / Brazilian Portuguese, German / German (Formal), Chinese Traditional / Simplified.

Para inglés específicamente, Intercom soporta EN-US, EN-UK y EN-CA — no hay una opción genérica EN. En caso de conflicto de locales, se crea un artículo separado para cada variante 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 lectura 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 la autenticación?

Sí, es seguro usar una clave API de Zendesk para la 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?