Get Storage File URL

Tipo: storage-get-file-url · Paquete: Storage Activities v1.0.5 · Salida: string

Devuelve un enlace temporal para descargar un archivo del Almacenamiento de Zoan Cloud. Sirve para compartir un archivo sin descargarlo en el robot: incluirlo en un correo, enviarlo por un chat o pasárselo a otro sistema que lo descargue por HTTP.

Cómo funciona

Identifica el archivo por su id o por bucket + name. Si indicas id, se ignoran bucket y name.
Zoan Cloud genera un enlace firmado que funciona durante 15 minutos. Quien tenga el enlace puede descargar el archivo en ese tiempo, sin iniciar sesión.
Los PDF y las imágenes (PNG, JPEG, WebP, GIF) se abren en el navegador; los demás tipos se descargan con su nombre original.

Cada llamada genera un enlace nuevo; los anteriores siguen valiendo hasta que vencen. Si el bucket tiene activada la auditoría de descargas, cada enlace generado queda registrado.

Parámetros requeridos

Ninguno. Pero debes indicar id o name; si no, la actividad falla con “Indica ‘id’ o ‘name’.”.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
`id`	`string`	—	Id del archivo (alternativa a `bucket` + `name`).
`name`	`string`	—	Nombre del archivo dentro del bucket, con sus carpetas. Ej: `2026/ventas.xlsx`.
`bucket`	`string`	`"default"`	Nombre del bucket. Solo se usa con `name`.

Salida

Devuelve un string con el enlace de descarga temporal (URL https firmada, válida 15 minutos).

Errores comunes

Mensaje	Causa y solución
`Indica 'id' o 'name'.`	No indicaste ni `id` ni `name`.
`… HTTP 404: …File not found in this environment.`	No hay un archivo con esa referencia en el ambiente del robot. Comprueba el `id` o el `bucket` + `name`.
`Zoan Cloud no devolvió una URL.`	La respuesta de Zoan Cloud no trajo el enlace. Reintenta.
`Las actividades de almacenamiento requieren el contexto de ejecución de Zoan Cloud. Falta: …`	El proceso no corre desde Zoan Cloud ni desde el Designer con sesión iniciada.

Los errores llegan con el prefijo “No se pudo obtener la URL del archivo: ”.

Ejemplo

Upload Storage File    path = "C:/reportes/estado-cuenta.pdf"   bucket = "clientes"   → output: archivo
Get Storage File URL   id = archivo["id"]   → output: enlace
Log   level = info   message = "Enlace (válido 15 minutos): " + enlace

Actividades relacionadas

Download Storage File — descargar el archivo en el robot.
Upload Storage File — subir el archivo que quieres compartir.