Exportar los datos de Zendesk Guide a un archivo CSV puede ser un paso crucial para las empresas que desean analizar, migrar o reutilizar el contenido de su Centro de ayuda. Hay dos métodos principales para lograrlo:
- Uso de un script de Python – Este enfoque fue sugerido por Scott Havard en la comunidad de Zendesk. Implica utilizar la API del Centro de ayuda de Zendesk para extraer datos manualmente. Es una excelente opción para quienes están familiarizados con la programación y desean personalizar la salida según necesidades específicas.
- Exportación automatizada con Help Desk Migration – Este servicio simplifica el proceso al ofrecer una solución lista para usar para exportar el contenido de Zendesk Guide, eliminando la necesidad de scripts complejos.
A continuación, exploraremos en detalle el método del script de Python, incluyendo los pasos necesarios, consejos para solucionar problemas y consideraciones. Además, destacaremos cómo Help Desk Migration ofrece una alternativa fácil de usar para exportar y migrar los datos de Zendesk Guide.
Exportar datos de Zendesk Guide usando un script de Python
- Descargar Python Asegúrese de que Python esté instalado en su sistema. Puede descargar Python desde el sitio web oficial.
- Instalar dependencias Abra la línea de comandos o terminal y ejecute:
bash
pip install requests pandas - Descargar scripts Clone o descargue el repositorio de scripts de Python. Asegúrese de tener los archivos de script necesarios que correspondan al tipo de exportación deseada.
- Editar el script Los scripts requieren credenciales de Zendesk para acceder a los datos de su Centro de ayuda. Abra el script y modifique lo siguiente:
- Su subdominio de Zendesk
- Credenciales de API (token de API o credenciales OAuth)
Asegúrese de que su cuenta tenga los permisos necesarios para acceder a los datos que necesita exportar.
- Ejecutar el script Navegue al directorio donde se encuentra el script. Por ejemplo, si el script está guardado en su escritorio, ejecute:
bash
cd /users/sunombre/desktopLuego, ejecute el script usando:
bash
python articleid.pyReemplace
articleid.pycon el nombre del script adecuado que desea ejecutar. - Ver el resultado Después de ejecutar el script, se creará un archivo .csv en el directorio actual. El archivo incluirá títulos de artículos, identificadores de artículos y otra información relevante de Zendesk Guide.
- Script Article_Information_Export:
Este script exportará todos los datos disponibles en un único archivo .csv. - Otros scripts: Estos scripts exportan tipos específicos de datos (por ejemplo, solo los títulos de los artículos) en un archivo .csv.
- Script Article_Information_Export:
Solución de errores comunes
Errores de sintaxis
Si encuentra errores de sintaxis como «Non-ASCII character,» asegúrese de que el script esté guardado con una codificación adecuada (preferiblemente UTF-8). Use un editor de texto como Visual Studio Code o Sublime Text para editar y guardar correctamente el script.
Problemas de codificación de caracteres
Para evitar UnicodeEncodeError, especialmente al trabajar con caracteres especiales, puede que sea necesario eliminar o reemplazar los caracteres problemáticos en el script. Por ejemplo:
decode_10_nozwsp = decode_10.replace(u'\u200b', '')
Faltan datos (Artículos internos)
Si intenta exportar artículos internos o en borrador, OAuth por sí solo puede no ser suficiente, ya que solo exporta contenido publicado de forma predeterminada. Puede usar Basic Auth para recuperar artículos internos o modificar el endpoint para especificar secciones/categorías internas. Sin embargo, esto podría no devolver datos debido a cambios de seguridad. Considere ajustar su enfoque o usar Basic Auth para una exportación más completa.
Siguiendo estos pasos y usando los scripts proporcionados, puede exportar con éxito los datos de los artículos de Zendesk Guide en formato .csv para facilitar su manejo. Si encuentra problemas relacionados con artículos internos, limitaciones de OAuth o errores de codificación, ajuste el script para que se adapte mejor a sus necesidades.
Servicio de Migración de Help Desk: Exportación automatizada de datos de Zendesk Help Center
Además del uso de scripts API, Help Desk Migration ofrece un servicio de migración de datos automatizado que simplifica el proceso de exportación de datos del Zendesk Help Center y su migración a otras instancias de Zendesk o a diferentes plataformas.
Con Help Desk Migration, puedes:
- Exportar datos del Help Center: Exporta fácilmente todo el contenido de tu Zendesk Help Center, incluyendo artículos, secciones y categorías, directamente a un archivo CSV.
- Migración automatizada y segura: Transfiere tus datos del Help Center de una instancia de Zendesk a otra o a otra plataforma de soporte de manera segura. El proceso está automatizado, garantizando una migración rápida, precisa y sin complicaciones, sin necesidad de scripts API complejos.
A diferencia de la creación manual de scripts, Help Desk Migration agiliza todo el proceso, lo que lo convierte en la solución ideal para empresas que necesitan exportar y migrar datos del Zendesk Help Center de manera eficiente y sin complejidad técnica.
Cómo migrar Zendesk Guide con Help Desk Migration
Help Desk Migration puede migrar el contenido de Zendesk Guide como parte de un proceso de migración de help desk. La migración generalmente incluye la transferencia de datos como artículos, categorías y secciones desde la base de conocimientos de Zendesk Guide hacia una plataforma de destino compatible. A continuación, se presenta una descripción general de cómo funciona el proceso:
- Evaluación: Analiza la estructura de Zendesk Guide para determinar qué datos deben migrarse, incluidos los artículos, secciones, categorías y formato.
- Preparación:
- Recopila las credenciales necesarias, como las claves API, para la fuente (Zendesk Guide).
- Asegúrate de que la plataforma de destino sea compatible con la migración de la base de conocimientos y tenga la estructura necesaria para albergar el contenido de Zendesk Guide.
- Configuración:
- Utiliza el Migration Wizard para mapear los campos de datos entre Zendesk Guide y la plataforma de destino.
- Personaliza la configuración para mantener las jerarquías de artículos, los archivos adjuntos, las etiquetas y otros metadatos.
- Migración de prueba: Realiza una migración de prueba gratuita para transferir un pequeño conjunto de datos. Esto asegura la integridad de los datos y te permite verificar cómo se mostrará el contenido en la plataforma de destino.
- Migración completa: Una vez que los resultados de la demostración se han revisado y confirmado, procede con la migración completa de los datos de Zendesk Guide. El proceso está automatizado, lo que minimiza el trabajo manual y el riesgo de errores.
- Verificaciones post-migración:
- Revisa el contenido de la base de conocimientos transferida en la plataforma de destino.
- Confirma que los artículos, secciones y categorías estén correctamente organizados y formateados.
Conclusión
Ambas opciones para exportar datos del Zendesk Guide ofrecen ventajas distintas, pero la elección depende de tus necesidades específicas y tu experiencia técnica. Mientras que el uso de un script de Python proporciona flexibilidad para quienes están cómodos con la codificación, requiere tiempo y esfuerzo para configurar, solucionar problemas y personalizar. Por otro lado, Help Desk Migration ofrece una solución de migración de datos automatizada y fácil de usar que elimina la complejidad y garantiza precisión. Ya sea que estés exportando datos para análisis, migración o reutilización, Help Desk Migration agiliza el proceso, ahorrándote tiempo y recursos valiosos. Para las empresas que buscan eficiencia y confiabilidad, este servicio automatizado es la opción ideal.