Subir adjunto de ticket
Adjunta evidencias a un ticket de ayuda subiendo primero el archivo autenticado a POST /api/app/files. La aplicación recibe un FileMeta.id y lo asocia al ticket o mensaje cuando envía attachment_file_ids.
En este artículo
Este flujo se usa cuando un usuario necesita añadir imágenes o documentos a un ticket de ayuda, o cuando soporte responde una conversación con un archivo asociado.
La subida y la asociación son dos pasos distintos: POST /api/app/files guarda el archivo y devuelve FileMeta; el ticket o mensaje solo queda vinculado cuando el formulario se envía con attachment_file_ids.
Antes de empezar
- Iniciar sesión en la aplicación con una cuenta autenticada.
- Tener el servicio de archivos y el filestore configurados en la instalación.
- Usar archivos aceptados por la interfaz de reportes: imágenes, PDF, Word o texto plano.
- Mantener cada archivo por debajo de 10 MB y no superar 5 adjuntos por ticket o mensaje.
- Para responder desde soporte, usar una cuenta con permiso user-reports:manage.
Instrucciones
- 1.
Abrir la superficie de ayuda
Para crear un ticket, entra en /my-reports/new y localiza la sección Adjuntos. Para responder un caso existente, abre /my-reports/{reportId}; soporte usa /support-requests/{reportId?} desde una cuenta autorizada.
- 2.
Seleccionar el archivo
Pulsa Seleccionar archivos o el botón de adjuntar y elige el documento o medio. La pantalla añade el archivo a la lista y lo marca temporalmente como uploading.
- 3.
Esperar a que termine la subida
La aplicación envía el archivo a POST /api/app/files y guarda el FileMeta.id cuando la API responde. No envíes el ticket o la respuesta mientras algún adjunto siga subiendo o esté en error.
- 4.
Enviar el ticket o la respuesta
Completa los campos obligatorios y envía el formulario. La pantalla manda solo los ids de archivos subidos en attachment_file_ids; no envía binario inline al crear el ticket ni al responder.
- 5.
Revisar los adjuntos asociados
Después de enviar, el detalle del ticket muestra los adjuntos como metadatos de archivo. Si quitaste un adjunto antes del envío, ese archivo no queda asociado al ticket o mensaje.
Validaciones y límites
- POST /api/app/files requiere sesión autenticada y un user_id válido.
- En multipart, el campo requerido es file; si falta, la API devuelve error de validación para file.
- La UI limita a 5 adjuntos y 10 MB por archivo, y acepta imágenes, PDF, Word y text/plain.
- El backend valida attachment_file_ids al asociarlos: recorta ids vacíos, elimina duplicados, rechaza más de 5 y exige que cada file_id exista.
- Para crear ticket, description debe tener al menos 10 caracteres y type debe ser bug, improvement u other; para responder, body es obligatorio.
- Si svc.Files o el filestore no están configurados, la subida no queda disponible.
Resultado esperado
El ticket o mensaje queda asociado a los FileMeta.id enviados en attachment_file_ids, y el detalle hidrata esos ids como adjuntos visibles. La subida aislada solo guarda el archivo; no modifica el ticket por sí misma.