Crear ticket de ayuda
Crea un ticket propio en Reportes y mejoras desde una sesión autenticada. El ticket se envía con tipo, título, descripción, contexto activo opcional y hasta 5 adjuntos ya subidos, y queda abierto para seguimiento.
En este artículo
Usa esta guía cuando un usuario autenticado necesite reportar una incidencia, mejora o consulta desde la app. La creación no requiere permisos de soporte: el ticket queda asociado al usuario que lo envía.
El formulario usa el contexto activo de la app. Si están seleccionados Grupo Marea Demo y Marea Gran Via, el ticket se enviará con ese contexto; si no hay organización o ubicación activa, puede enviarse sin contexto adicional.
Los adjuntos no se cargan como binarios en `POST /api/app/me/reports`. Primero se suben desde el bloque Adjuntos y el ticket guarda sus `file_id`.
Antes de empezar
- Tener una sesión iniciada en la app.
- Poder abrir el menú de usuario y entrar en Reportes y mejoras.
- Si el ticket debe asociarse a Grupo Marea Demo o a Marea Gran Via, trabajar con ese contexto activo y con membresía aceptada.
- Si se van a adjuntar archivos, subirlos desde Adjuntos antes de enviar el ticket.
Instrucciones
- 1.
Abrir Reportes y mejoras
Desde el menú de usuario, entra en Reportes y mejoras. En Mis tickets, pulsa Nuevo ticket para abrir el formulario; también se puede llegar directamente a `/my-reports/new` dentro de una sesión autenticada.
- 2.
Revisar el contexto activo
Comprueba el resumen de contexto del formulario. El ticket usará la organización y ubicación seleccionadas en la app; esta pantalla no permite escoger otro contexto.
- 3.
Elegir el tipo de ticket
Selecciona `bug`, `improvement` u `other`. La pantalla empieza por defecto en `bug`, pero el tipo puede cambiarse antes de enviar.
- 4.
Rellenar título y descripción
Escribe un título claro y una descripción suficiente para que soporte entienda el caso. La app recorta espacios iniciales y finales antes de enviar.
- 5.
Añadir adjuntos opcionales
Usa Adjuntos para aportar capturas, documentos o texto de apoyo. Cada archivo se sube primero con `POST /api/app/files`; el ticket solo guarda las referencias devueltas.
- 6.
Enviar el ticket
Pulsa Enviar ticket. La app bloquea el botón mientras envía o mientras haya adjuntos subiendo, crea el ticket en estado `open` y abre el detalle del ticket recién creado.
- 7.
Consultar el seguimiento
En el detalle revisa título, estado, contexto y mensaje inicial. Ese primer mensaje se reconstruye desde la descripción y los adjuntos del ticket.
Validaciones y límites
- El título es obligatorio.
- El tipo es obligatorio y el backend solo acepta `bug`, `improvement` u `other`.
- La descripción es obligatoria y debe tener al menos 10 caracteres.
- No se puede enviar mientras un adjunto esté subiendo o haya quedado en error.
- Se admiten como máximo 5 adjuntos, con 10 MB por archivo, en imágenes, PDF, Word o `text/plain`.
- Si se envía organización o ubicación, el usuario debe tener membresía `accepted` en ese contexto.
- `POST /api/app/me/reports` requiere sesión autenticada y solo recibe `attachment_file_ids`, no binarios.
Resultado esperado
El ticket queda creado en estado `open`, sin fecha de resolución, la lista Mis tickets se actualiza y los usuarios de soporte con `user-reports:manage` reciben notificación cuando corresponde.