Cómo exportar artículos del centro de ayuda de Intercom con la API: Guía 2025

Así que has invertido incontables horas en crear una fantástica base de conocimientos en Intercom, llenándola de artículos realmente útiles que resuelven los problemas de tus clientes. Ahora necesitas sacar ese contenido, y probablemente te hayas dado cuenta de que no hay ningún botón grande y brillante que diga "exportar" por ninguna parte. Si te estás volviendo loco buscándolo, no estás solo.

Ya sea que estés migrando a una nueva plataforma, creando una copia de seguridad local para tu tranquilidad o quieras realizar un análisis profundo de tu contenido, sacar tus datos no debería ser un proyecto monumental. Esta guía está aquí para guiarte a través de los pasos técnicos para exportar artículos del centro de ayuda de Intercom con la API.

Pero seamos realistas, la ruta de la API puede ser complicada y tiene sus propias trampas. Por eso, también te mostraremos una alternativa mucho más sencilla y automatizada que te permite conectar y gestionar tu conocimiento sin escribir una sola línea de código.

Antes de empezar: lo que necesitarás

Sumergirse en el método de la API requiere un poco de preparación. Es una tarea técnica, por lo que tener estas cosas listas hará que todo el proceso sea mucho más fluido. Aquí tienes una lista rápida:

• Acceso de administrador a tu espacio de trabajo de Intercom: Definitivamente necesitas esto, ya que tendrás que obtener los permisos adecuados para crear credenciales de API.

• Un token de acceso de desarrollador: Piensa en esto como una contraseña segura que permite que tu script o herramienta se comunique con Intercom. Cubriremos cómo crear uno en el primer paso.

• Una herramienta para hacer peticiones a la API: Puedes usar una herramienta de línea de comandos como cURL si te sientes cómodo en ese entorno, o una aplicación más fácil de usar como Postman.

• Un conocimiento básico de las API: Será útil si sabes qué son los endpoints, las peticiones GET y los datos JSON, ya que facilitará el seguimiento de los pasos.

Una guía paso a paso para exportar artículos con la API de Intercom

¿Listo para empezar? Aquí tienes el proceso completo para exportar tus artículos utilizando la API REST de Intercom, dividido en cuatro pasos.

Paso 1: Obtén tu token de acceso de desarrollador de Intercom

Para empezar, necesitas una forma de demostrar a Intercom que tienes permiso para acceder a los datos de tu espacio de trabajo. Ahí es donde entra en juego un token de acceso.

Conseguir uno es bastante sencillo. Simplemente dirígete al Developer Hub en la configuración de Intercom. Desde allí, puedes crear una nueva aplicación para uso interno. Dale un nombre que recuerdes (como "Exportador de Artículos"), e Intercom generará un token de acceso para ti. Copia este token y guárdalo en un lugar seguro; lo necesitarás para cada llamada a la API.

Paso 2: Lista todos los artículos para obtener sus ID

Aquí hay una pequeña peculiaridad de la API de Intercom: no puedes simplemente pedir todo el contenido de tus artículos de una sola vez. Primero, tienes que solicitar una lista de todos tus artículos para obtener sus ID únicos. Es como obtener el catálogo de una biblioteca antes de poder sacar algún libro.

Para hacer esto, usarás el endpoint "List all articles". Cuando envíes una petición a este endpoint con tu token de acceso, Intercom te devolverá un objeto JSON con una lista de tus artículos, cada uno con su propio "id".

Paso 3: Recupera el contenido de cada artículo

Con tu lista de ID de artículos lista, ahora puedes empezar a extraer el contenido real. Esto implica hacer una petición por separado para cada artículo, uno por uno.

Usarás el endpoint "Retrieve an Article", asegurándote de incluir el "id" específico del artículo en la URL de la petición. La respuesta para cada petición será un objeto JSON que contiene todo sobre el artículo: su título, autor, estado y, por supuesto, el "body" (cuerpo), que contiene el contenido en formato HTML.

Esta es, sin duda, la parte más repetitiva del proceso. Si tienes 500 artículos, vas a hacer 500 peticiones a la API individuales.

Paso 4: Formatea y guarda tus datos exportados

A medida que obtienes el contenido de cada artículo, depende de ti guardarlo. El cuerpo del artículo se devuelve como HTML, por lo que necesitarás guardar esos datos en archivos. Podrías guardarlos como archivos .html o, si necesitas algo diferente, escribir un script para convertir el HTML a otro formato como Markdown o texto plano.

Para hacer esto para todo un centro de ayuda, es casi seguro que querrás escribir un pequeño script que obtenga la lista completa de ID (manejando la paginación), recorra cada uno, haga una petición a la API para obtener el contenido, extraiga el título y el cuerpo, y lo guarde todo en un archivo local.

Y ahí lo tienes. Has exportado tus artículos. Como puedes ver, sin embargo, no es exactamente un simple clic de botón.

Desafíos comunes al exportar artículos con la API

Aunque el método de la API cumple su función, está lejos de ser perfecto. Muchos equipos se encuentran con las mismas frustraciones que pueden convertir esta tarea en un verdadero desperdicio de recursos.

• Es un proceso técnico y que consume mucho tiempo. A menos que seas un ingeniero, todo este proceso puede resultar intimidante. Requiere conocimientos técnicos, tiempo para escribir y depurar scripts, y mantenimiento continuo si necesitas hacerlo más de una vez. Para las personas no técnicas, es prácticamente inviable, y para los desarrolladores, es solo otra tarea que los aleja de sus proyectos principales.

• Los artículos internos no se pueden exportar. Este es un gran problema. Actualmente, la API de Intercom no permite exportar artículos de uso exclusivamente interno. Todo ese valioso conocimiento que tu equipo utiliza a diario queda atrapado, dejándote con un trabajo manual de copiar y pegar que anula todo el propósito de una exportación automatizada.

• El formato y el contenido pueden resultar extraños. El HTML exportado no siempre es una réplica perfecta. Como menciona Intercom en su propia documentación, cualquier redimensionamiento de imagen personalizado que hayas hecho se perderá, y los elementos dinámicos como los destacados o las secciones desplegables no son totalmente compatibles. Tus artículos bellamente formateados podrían terminar viéndose un poco rotos.

• Es una instantánea única en el tiempo. Quizás el mayor inconveniente es que tu exportación queda desactualizada en el momento en que la terminas. Cualquier artículo nuevo, actualización o edición realizada en Intercom no estará en tus archivos exportados. Para mantener las cosas al día, tienes que volver a pasar por todo el proceso manual y técnico.

La mejor alternativa: Unificar tu conocimiento

Todos estos dolores de cabeza plantean una pregunta interesante: ¿y si exportar es la solución equivocada para el problema? El objetivo real no es solo obtener una carpeta de archivos HTML; es usar ese conocimiento en otro lugar.

¿Y si no necesitaras exportar tus artículos en absoluto? ¿Y si pudieras simplemente conectar de forma segura tu base de conocimientos de Intercom a las otras herramientas que usas y mantenerlo todo actualizado y sincronizado automáticamente?

De eso se trata eesel AI. En lugar de luchar con una exportación única, eesel AI proporciona una integración con Intercom en un solo clic que te permite evitar todos estos problemas por completo.

Así es como ayuda:

• Reúne todo tu conocimiento. Puedes conectar tu centro de ayuda de Intercom en minutos. Pero, ¿por qué detenerse ahí? También puedes conectar otros lugares donde tu equipo almacena información, como Confluence, Google Docs, e incluso tickets de soporte anteriores. Tu conocimiento siempre está activo y actualizado sin ningún esfuerzo manual.

• Empieza en minutos, no en meses. Olvídate del proceso de API de varios pasos que necesita un desarrollador. Con eesel AI, puedes registrarte, conectar tus fuentes y empezar a ver valor de inmediato, todo por tu cuenta.

• Pon tu conocimiento a trabajar. Una exportación estática tiene usos limitados. Una base de conocimientos viva y conectada, por otro lado, es una ventaja seria. Una vez conectado, tu conocimiento de Intercom puede ayudar a potenciar un Copiloto de IA que redacta respuestas para tus agentes, un Agente de IA autónomo que resuelve tickets por sí solo, o un bot interno de preguntas y respuestas en Slack. Eso es un resultado real, no solo un volcado de datos.

El Copiloto de IA de eesel redactando una respuesta, mostrando cómo el conocimiento unificado puede potenciar directamente las herramientas de soporte.

Consejos profesionales para la gestión del conocimiento en Intercom

Cuando cambias tu forma de pensar y te alejas de las exportaciones manuales, abres la puerta a mejores formas de gestionar tu conocimiento. Aquí tienes algunos consejos para ayudarte a construir una estrategia más efectiva.

1. Encuentra y llena los vacíos de conocimiento automáticamente. Una de las partes más difíciles de gestionar un centro de ayuda es saber qué escribir a continuación. En lugar de adivinar, deja que las conversaciones con tus clientes te guíen. Una herramienta de IA como eesel AI puede analizar tus tickets de soporte, detectar preguntas recurrentes que no están respondidas en tu centro de ayuda y generar automáticamente borradores de artículos para llenar esos vacíos.

Un panel de control de eesel AI que muestra cómo identifica vacíos de conocimiento a partir de las conversaciones de soporte, evitando la necesidad de exportar manualmente artículos del centro de ayuda de Intercom con la API para su análisis.

2. No dejes que el conocimiento se quede atascado en silos. La sabiduría colectiva de tu empresa no vive solo en Intercom. Los procesos importantes están documentados en Confluence, las actualizaciones de productos se comparten en Google Docs, y las soluciones rápidas se intercambian en Slack. Una mejor estrategia de soporte unifica todas estas fuentes, dando a tu equipo y a tu IA un único lugar fiable para encontrar respuestas.

3. Simula antes de automatizar. Si vas a utilizar tu conocimiento para potenciar la IA, necesitas confiar en que funcionará correctamente. Busca herramientas que te permitan probar sin riesgos. Por ejemplo, el modo de simulación de eesel AI te permite ejecutar tu configuración de IA en miles de tickets pasados. Puedes ver exactamente cómo habría respondido y obtener pronósticos sólidos sobre las tasas de resolución, lo que te ayuda a generar confianza antes de activarlo para los clientes en vivo.

La función de simulación en eesel AI, que permite a los equipos probar su configuración de IA en tickets pasados y generar confianza antes de ponerla en marcha.

Superando la necesidad de exportar artículos del centro de ayuda de Intercom con la API

Aunque técnicamente puedes exportar artículos del centro de ayuda de Intercom con la API, está bastante claro que el proceso es manual, técnicamente exigente y tiene algunas limitaciones significativas. Deja atrás tu conocimiento interno y te da una instantánea estática de tu contenido que rápidamente se vuelve inútil.

Un enfoque más moderno y eficiente es dejar de pensar en exportaciones únicas y empezar a construir un sistema de conocimiento vivo y unificado. En lugar de sacar datos, deberías estar conectando tus herramientas.

Herramientas como eesel AI están diseñadas para esto. Permiten a los equipos conectar sus fuentes de conocimiento en minutos e inmediatamente poner esa información a trabajar, todo sin tener que lidiar con API ni escribir código. Es hora de desbloquear lo que tu base de conocimientos realmente puede hacer.

¿Listo para unificar tu conocimiento?

Deja de perder tiempo en exportaciones manuales y scripts de API complejos. Conecta todas tus fuentes de conocimiento, incluido tu centro de ayuda de Intercom, en minutos con eesel AI.

Comienza tu prueba gratuita hoy mismo y descubre lo fácil que es potenciar tu soporte con un conocimiento verdaderamente unificado.