Cómo exportar tickets desde Zendesk: Guía completa (CSV y API)

Publicado por Natalia Tomchyshyn

Actualizado el 25 de mayo de 2026

¿Necesitas extraer tus datos Zendesk ? Ya sea para generar un informe, hacer una copia de seguridad de tu historial, migrar a una nueva plataforma o simplemente responder a una pregunta de la dirección con datos concretos, tienes varias maneras de hacerlo. No todas son igual de efectivas.

Esta guía abarca todos los métodos de exportación que ofrece Zendesk , qué ofrece realmente cada uno (y qué omite discretamente), y cuándo conviene recurrir a una herramienta de migración.

Qué puedes —y qué no puedes— exportar desde Zendesk

Antes de hacer clic en nada, conviene saber qué abarca el sistema de exportación de Zendesk. Hay cuatro tipos de datos que puede exportar:

• **Tickets** — campos del ticket, estado, responsable, solicitante, etiquetas, fechas
• **Usuarios** — registros de agentes y usuarios finales
• **Organizaciones** — nombres de organizaciones, dominios, campos personalizados

Lo que se echa notablemente en falta en las exportaciones estándar:

• Comentarios del ticket e historial de conversaciones: las respuestas reales y las notas internas no se incluyen en la exportación de la vista CSV
• Archivos adjuntos: los archivos adjuntos a los tickets no se incluyen en ninguna exportación nativa
• Comentarios de texto sobre la satisfacción con los tickets: si bien la calificación bruta de satisfacción "Buena" o "Mala" se incluye como metadatos en las exportaciones masivas de tickets, los comentarios de texto escritos reales dejados por el cliente se eliminan por completo
• Transcripciones de chat en tiempo real: producto independiente, ruta de exportación independiente
• Datos de objetos personalizados: solo disponibles a través de la API

Conocer estas limitaciones defront ahorra mucho tiempo. Si necesitas el historial de conversaciones, la exportación estándar no te servirá, y más adelante en esta guía te explicaremos las opciones disponibles.

Método 1: Exportar tickets Zendesk desde una vista (CSV)

El método de exportación más rápido y accesible. Funciona sin necesidad de configuración de cuenta especial, y cualquier agente con los permisos adecuados puede ejecutarlo.

Instrucciones paso a paso

1. Inicia sesión en tu cuenta Zendesk .
2. En la barra lateral izquierda, haga clic en el icono **Vistas** (la cuadrícula de líneas horizontales).
3. Seleccione la vista que contiene los tickets que desea exportar. Si no tiene una vista personalizada configurada, utilice una de las vistas integradas, como *Todos los tickets sin resolver*.
4. Diríjase a la esquina superior derecha de la página de visualización. Nota: Si tiene algún filtro de búsqueda temporal activo aplicado a la vista, el botón de exportación estará completamente oculto. Borre primero todos los filtros activos. Según su versión, haga clic en Exportar CSV o en el menú desplegable Acciones y seleccione Exportar como CSV.
5. Confirma la exportación CSV . Zendesk procesará el archivo y enviará un enlace de descarga a la dirección de correo electrónico asociada a tu cuenta.
6. Abre el correo electrónico y descarga el archivo ZIP que contiene tu CSV.

¿Qué incluye el archivo CSV

El CSV exportado incluye los campos de columna visibles en su vista, además de los campos estándar:

El límite de 1.000 entradas y cómo sortearlo

Este es el punto de frustración más común: Zendesk trunca las exportaciones de vistas a los 1000 tickets. Si su vista contiene más registros, la exportación se detiene silenciosamente en 1000 sin ninguna advertencia ni mensaje de error.
Para solucionar esto:

• Cree varias vistas filtradas con rangos de fechas que contengan menos de 1000 entradas cada una, y luego exporte cada vista por separado.
• En su lugar, utilice la exportación masiva completa (Método 2); no tiene límite de tickets por exportación.
• Utilice la API Zendesk (Método 4) para acceder programáticamente a todos los registros.

Método 2: Exportación masiva completa de datos (CSV)

La exportación completa de datos le proporciona un repositorio completo de sus datos principales sin límites en la cantidad de tickets. Es el método adecuado cuando necesita una copia de seguridad completa o se está preparando para una migración.

Cómo habilitar la exportación de datos (se requiere el propietario de la cuenta)

Por defecto, la exportación completa de datos está desactivada por motivos de seguridad. El propietario de la cuenta no necesita contactar con soporte, pero debe activarla explícitamente accediendo a Centro de administración → Cuenta → Seguridad → Exportación de datos. Allí, deberá especificar los dominios de correo electrónico autorizados para recibir los archivos exportados. Una vez configurado, cualquier administrador podrá solicitar la exportación a una dirección de correo electrónico autorizada.

Paso a paso: solicita la exportación completa de tu billete

1. En Zendesk, haga clic en el icono del Centro de administración (icono de cuadrícula).
2. Navegue a Cuenta → Seguridad → Exportación de datos.
3. Desplácese hasta la sección de exportación CSV .
4. Establezca un rango de fechas si desea limitar el alcance, o déjelo en blanco para obtener todos los registros históricos.
5. Haga clic en Exportar.
6. Zendesk procesa la exportación en segundo plano y envía por correo electrónico una carpeta ZIP que contiene el archivo CSV a la dirección de correo electrónico autorizada.

Paso a paso: exportar usuarios y organizaciones

Debido a que la herramienta nativa de exportación masiva de datos restringe los archivos CSV exclusivamente a los registros de tickets, extraer una hoja de cálculo limpia de los directorios de clientes y organización requiere un script de API programático:

1. Genera un token de API navegando a Centro de administración → Aplicaciones e integraciones → API → API Zendesk .
2. Asegúrese de que la opción Acceso mediante token esté activada y, a continuación, haga clic en Agregar token de API para generar una credencial segura.
3. Utilice un script programático (como Python) para realizar solicitudes a los puntos finales /api/v2/users.json o /api/v2/organizations.json.
4. Configure su bucle de código para que analice sus directorios de usuarios y organizaciones activos, extraiga sus atributos personalizados y los escriba directamente en un archivo local con formatocsv en su máquina.

Guía de formato y metodología

¿Cuánto tiempo tarda una exportación Zendesk ?

• Cuentas pequeñas (< 10.000 tickets): normalmente unos minutos
• Cuentas medianas (10.000 – 500.000 boletos): de 30 minutos a unas pocas horas
• Cuentas grandes (> 1.000.000 de tickets): puede tardar hasta 24 horas; se exportan automáticamente en incrementos de 31 días

Método 3: Exportar datos de la base de conocimientos/guía Zendesk a CSV

Los métodos anteriores abarcan datos de tickets, usuarios y organizaciones. Zendesk Guide (su base de conocimientos) es un tipo de contenido independiente y requiere un enfoque diferente.

Utilizando la función de exportación integrada del Centro de ayuda

Zendesk no ofrece un botón nativo de exportación con un solo clic para artículos o categorías de la Guía dentro del panel de administración estándar. Si bien la vista **Gestionar artículos** permite seleccionar varios artículos para actualizar su configuración (como cambiar etiquetas o autores en bloque), no permite descargar ni exportar su contenido. Para exportar la Guía completa a CSV, la opción más fiable es utilizar un script de API de Python.

Exportación de datos de la guía con un script de Python

Para exportar una guía completa a CSV, un script de Python que utilice la API del Centro de ayuda Zendesk es el método más fiable. Aquí tienes un ejemplo mínimo funcional:

Requisitos previos:

• Python 3 instalado
• Librería `requests`: ejecute `pip install requests`
• Tu subdominio Zendesk , correo electrónico de administrador y token de API

import requests import csv SUBDOMAIN = "tu-subdominio" EMAIL = "tu-correo@example.com" API_TOKEN = "tu-token-api" url = f"https://{SUBDOMAIN}.zendesk.com/api/v2/help_center/articles.json" auth = (f"{EMAIL}/token", API_TOKEN) articles = [] while url: response = requests.get(url, auth=auth) data = response.json() articles.extend(data["articles"]) url = data.get("next_page") with open("zendesk_guide_export.csv", "w", newline="", encoding="utf-8") as f: writer = csv.DictWriter(f, fieldnames=["id", "title", "body", "section_id", "created_at", "updated_at"]) writer.writeheader() para artículo en artículos: writer.writerow({ "id": article["id"], "title": article["title"], "body": article.get("body", ""), "section_id": article.get("section_id", ""), "created_at": article["created_at"], "updated_at": article["updated_at"], }) print(f"Se exportaron {len(articles)} artículos a zendesk_guide_export.csv")

El script recorre automáticamente todos los artículos página por página. Ejecútalo y obtendrás un CSV limpio con los ID de los artículos, los títulos, el contenido HTML sin formato, las secciones asignadas y las marcas de tiempo.

Solución de problemas:

• **Errores de sintaxis/terminal**: asegúrese de estar ejecutando Python 3 (en algunos sistemas operativos se usa `python3`, no `python`)
• **Problemas de codificación de caracteres**: el parámetro `encoding="utf-8"` en el script maneja la mayoría de los formatos de estilo; si ve etiquetas HTML rotas o texto ilegible en Excel, use el menú Datos → Elegir **Texto/CSV** de Excel y seleccione explícitamente el formato UTF-8 al importar el archivo.
• **Faltan artículos restringidos**: los artículos restringidos o solo para agentes internos requieren credenciales de API de nivel de administrador; compruebe que su token de API pertenece a una cuenta de administrador activa con permisos para ver todos los segmentos de la Guía.

Comparación de los 4 métodos de exportación

Para extraer de forma nativa flujos de conversación (el texto real dentro de los mensajes y notas internas) en bloque, debe consultar el punto final de Eventos de Ticket Incrementales en lugar del punto final del contenedor de ticket básico. Este flujo devuelve parámetros de conversación específicos cuando aplica el parámetro de carga lateral include=comment_events:

Reemplace `start_time=0` con una marca de tiempo Unix para obtener solo los registros actualizados después de esa hora; esto resulta útil para las sincronizaciones incrementales diarias.

Autenticación: utilice la autenticación básica con `{email}/token` como nombre de usuario y su token de API como contraseña, o OAuth si lo ha configurado.

Paginación: Los puntos finales incrementales utilizan marcadores de flujo. Para el seguimiento basado en el tiempo, debe capturar la cadena entera `end_time` de la carga útil de la respuesta JSON e insertarla como el nuevo `start_time` en su solicitud API posterior. Repita este bucle continuamente hasta que la propiedad booleana `end_of_stream` de la carga útil sea verdadera.

Cómo exportar comentarios y conversaciones de tickets Zendesk

Esta es la pregunta que la mayoría de los guías pasan por alto, y es la que más suele perjudicar a los equipos.

El problema: la exportación estándar CSV como la exportación masiva completa omiten los comentarios de los tickets. Se obtiene el encabezado del ticket (estado, responsable, fechas, etiquetas), pero no la conversación real: las respuestas, las notas internas y el contexto que hacen que los tickets sean útiles como registros.

¿Por qué faltan los comentarios en la exportación estándar?

La exportación CSV de Zendeskse diseñó para la elaboración de informes y análisis, no para la portabilidad completa de los datos. Se parte de la base de que seguirás utilizando Zendesk, por lo que no necesitas el cuerpo de la conversación como un archivo portátil.

Cómo obtener comentarios a través de la API

Uso de la API de Tickets con carga lateral:

Esto devuelve todas las respuestas públicas, notas internas privadas y eventos del sistema relacionados con un ticket en orden cronológico, incluyendo el autor y la marca de tiempo de cada comentario.

Para exportar comentarios de forma masiva en todos los tickets, utilice el punto final de exportación incremental con `include=comment_events` como se muestra en el Método 4.

La desventaja: extraer los comentarios de una cuenta grande a través de la API lleva tiempo y requiere escribir código para vincular los tickets con sus comentarios y generar una estructura coherente.

Cuando una herramienta de migración es la opción más rápida

Si necesitas comentarios porque estás cambiando de plataforma, hay una forma más rápida. Help Desk Migration migra todo el historial de conversaciones (respuestas públicas, notas internas y archivos adjuntos) directamente a tu nuevo servicio de asistencia, con asignación automática de campos y sin necesidad de un archivo CSV intermedio.

¿Qué migra HDM desde Zendesk?

• Boletos con historial completo de conversaciones (públicas y privadas)
• Archivos adjuntos
• Usuarios y organizaciones
• Artículos de la base de conocimientos (Guía)
• Campos y etiquetas personalizados

Comparación de los 4 métodos de exportación

Solución de problemas comunes de exportación en Zendesk

El correo electrónico de exportación nunca llegó

• Primero, revisa tu carpeta de correo no deseado
• Asegúrese de que la dirección de correo electrónico de su cuenta de Zendesk sea accesible
• Para exportaciones a granel, las cuentas grandes pueden tardar hasta 24 horas; espere antes de volver a solicitarlas
• Si se vuelve a solicitar una exportación mientras se está procesando una, se pueden producir conflictos en la cola; cancele primero la solicitud pendiente desde la pestaña Informes
• Tenga en cuenta que, una vez solicitada una exportación, no se puede cancelar ni modificar desde la interfaz de usuario. Solicitar varias extracciones en un corto período de tiempo puede saturar la cola del servidor; lo mejor es dejar que el sistema termine de procesar la solicitud inicial.

El enlace de descarga ha caducado

Los enlaces de descarga de exportaciones Zendesk caducan tras un periodo determinado (normalmente 3 días para exportaciones masivas, menos para exportaciones de visualización). Si su enlace ha caducado, vuelva a **Centro de administración → Informes → Exportar** y solicite el archivo de nuevo.

Errores de sintaxis en el archivo descargado

Lo más común es con las exportaciones JSON. Zendesk exporta en formato NDJSON (JSON delimitado por saltos de línea): cada línea es un objeto JSON independiente, no una matriz JSON estándar. Las herramientas que esperan una matriz `[...]` generarán un error de análisis.

Solución: envuelva el archivo en una matriz JSON o conviértalo con un script sencillo:

Problemas de codificación de caracteres

Si los caracteres especiales (acentos, alfabetos no latinos, guiones largos) aparecen distorsionados en Excel:

1. No haga doble clic en el CSV para abrirlo
2. En Excel, vaya a **Datos → Desde texto/CSV**
3. Seleccione el archivo y elija **UTF-8** como codificación en el asistente de importación

Faltan artículos internos (restringidos) en la exportación de la guía

El script de Python o la llamada a la API requieren credenciales de administrador para acceder a los artículos internos. Si su token de API pertenece a una cuenta de agente, los artículos internos se filtrarán automáticamente. Cambie a un par de correo electrónico/token de administrador.

## Cuando las exportaciones manuales no son suficientes: Migración a una nueva plataforma

Las exportaciones manuales funcionan bien para copias de seguridad, informes y extracciones de datos puntuales. Sin embargo, resultan ineficaces cuando el objetivo es migrar a una plataforma diferente.

Los problemas se acumulan:
- Los comentarios y el historial de conversaciones requieren la API, no una exportación de la interfaz de usuario.
- Importar un JSON o CSV procesar a un nuevo servicio de asistencia requiere la asignación de campos, que rara vez coincide uno a uno.
- Los archivos adjuntos permanecen en Zendeskel almacenamiento de
. - Las cuentas grandes tardan horas o días en exportarse y luego horas más en importarse.
- Las actualizaciones incrementales entre el inicio de la exportación y la finalización de la migración crean lagunas de datos.

Para esto se han creado las herramientas específicas para la migración.

Cómo Help Desk Migration gestiona la transferencia completa de datos Zendesk

Help Desk Migration se conecta directamente a Zendesk a través de una API y a su plataforma de destino, y transfiere los datos sin un intermediario CSV :

1. **Conéctate Zendesk** — introduce tu subdominio y token de API
2. **Conecta tu destino** — Freshdesk, Jira Service Management, HubSpot, Intercomo más de 60 plataformas adicionales
3. **Asigna tus campos**: el asistente te muestra los campos de origen y destino uno al lado del otro; campos personalizados incluidos
4. **Ejecuta una migración de demostración**: migra una muestra de 20 tickets para que puedas verificar el resultado antes de confirmarlo
5. **Ejecuta la migración completa**: HDM gestiona automáticamente la paginación, la limitación de velocidad, los archivos adjuntos y el historial de conversaciones
6. **Migración delta**: ejecute una sincronización final después de la migración principal para capturar los tickets actualizados durante el período

Lo que se mueve:

• Boletos con historial completo de la conversación (notas públicas y privadas)
• Archivos adjuntos del boleto
• Usuarios y organizaciones
• Artículos de la base de conocimientos con estructura (categorías, secciones)
• Campos y etiquetas personalizados

Preguntas frecuentes