You are viewing the Spanish (Mexico) site, but your language preference is set to English. Switch to English site →

Menu

Exportar datos desde Flex Insights a través de la API

Aprende a exportar informes desde Insights para almacenar los datos en un almacén propio con esta guía.

El proceso de exportación consta de los siguientes pasos:

Requisitos previos

Antes de empezar a exportar datos, deberás contar con los siguientes elementos:

  • Un espacio de trabajo de Flex Insights suministrado
  • Las credenciales de un usuario con acceso al espacio de trabajo de Insights
  • Un informe de tabla que contenga los datos que necesitas exportar
  • Compatibilidad del cliente de la API REST con las cookies que se utilizan para pasar tokens de autenticación

Autenticación de la API

Asegúrate de que estás realizando la autenticación con la API de Flex Insights; para ello, comprueba que tengas un TT (token temporal) válido.

El procedimiento se detalla en Autenticación de la API.

Exportar el informe sin procesar

Exportar el informe sin procesar es útil para obtener datos que se puedan procesar de forma automática de cualquier informe creado a través del portal de análisis de Flex Insights. Necesitarás el ID del espacio de trabajo y el ID del objeto report para exportar los datos.

ID del espacio de trabajo: inicia sesión en el portal de análisis y revisa la URL en la barra de direcciones del navegador. Por ejemplo:

Workspace id

El ID del espacio de trabajo es la cadena que aparece entre el segmento #s=/gdc/projects/ y la barra vertical. En este caso, el ID del espacio de trabajo es z2nxqtb1r6weuly0iivexz6hu5dathua.

ID de objeto: en el portal de análisis, desplázate hasta el informe que deseas exportar y revisa la URL en la barra de direcciones. Podría tener este aspecto:

Report ID

El ID de objeto es la expresión numérica que se encuentra al final de la dirección URL y suele estar precedida del segmento obj/. En el ejemplo anterior, el ID de objeto es 3295.

El tamaño máximo del informe para las exportaciones sin procesar es de 1 GB. La exportación de un informe de este tamaño puede tomar minutos.

Descargar el informe

Descarga el informe mediante el URI de la exportación anterior.

Si recibes una respuesta 202 de la API, significa que la solicitud fue aceptada, pero no está lista para entregarse (todavía se está calculando o preparando el archivo CSV).
Como la API de exportación puede tardar varios segundos o minutos en casos periféricos, según el volumen de datos y la cantidad de columnas, debes agregar un reintento en caso de que el servidor devuelva 202. Los datos solo están listos para la descarga cuando el servidor devuelve 200.

        
        
        

        Flex Insights - Download the report

        Cerrar sesión

        Después de realizar todas las operaciones necesarias, debes cerrar la sesión para invalidar el SST. Para ello, necesitas conocer el ID de tu perfil, el cual puedes encontrar en la respuesta de la autenticación de la API.

              
              
              

              Flex Insights - API Log out

              Calificar esta página:

              ¿Necesitas ayuda?

              Todos la necesitamos a veces; la programación es difícil. Obtén ayuda ahora de nuestro equipo de soporte, o recurre a la sabiduría de la multitud visitando Stack Overflow Collective de Twilio o navegando por la etiqueta de Twilio en Stack Overflow.

              Gracias por tus comentarios.

              Selecciona los motivos de tus comentarios. La información adicional que nos brindas nos ayuda a mejorar nuestra documentación:

              Enviando tus comentarios…
              🎉 Gracias por tus comentarios.
              Se produjo un error. Inténtalo de nuevo.

              Gracias por tus comentarios.

              thanks-feedback-gif