v1.29: el estado Gestionado llega a las exportaciones y a la API

FormFlow v1.29.0, publicada el 2026-10-02, saca el estado Gestionado de la bandeja de entrada. Hasta ahora, marcar un envío como Gestionado solo se veía dentro de FormFlow. Desde esta versión, las exportaciones CSV, Excel y JSON registran cuándo ocurrió, y la API de gestión devuelve ese mismo momento y puede filtrar por él.

Qué cambió

• Las exportaciones CSV y Excel incorporan una columna Gestionado. En el archivo, su encabezado es _handled_at, escrito igual que las demás columnas de detalle del envío (por ejemplo, _id).

• Las exportaciones JSON incluyen una clave handled_at en cada envío.

• La API de gestión devuelve handled_at en cada envío, tanto en la lista como en un envío individual.

• La lista de envíos acepta handled=true o handled=false, para obtener solo los envíos gestionados o solo los abiertos.

• El selector de exportación muestra la columna, de modo que puede desmarcarla.

Qué registra la hora

El valor es el momento en que el equipo marcó el envío como Gestionado, como una marca de tiempo ISO 8601 del tipo 2026-10-02T09:30:00+00:00. El reloj de la aplicación de FormFlow está configurado en UTC, por lo que el desfase es +00:00. El estado pertenece al equipo, no a un miembro: no hay persona asignada, y la exportación incluye una hora, no una persona.

Tres comportamientos se derivan de cómo se escribe el estado. Marcar como Gestionado un envío que ya lo está no hace nada, así que se conserva la primera hora. Reabrir un envío borra la hora, y la celda vuelve a quedar vacía mientras el envío está abierto. Si lo reabre y más tarde lo vuelve a marcar como Gestionado, la columna muestra la nueva hora y la anterior desaparece. Además, enviar desde FormFlow una respuesta al remitente también marca el envío como Gestionado, por lo que la hora puede proceder de una respuesta y no de un clic.

En el selector de exportación

Para CSV y Excel, el selector de exportación enumera las columnas que puede incluir. Una exportación con todas las columnas seleccionadas ahora contiene la columna Gestionado. Si la desmarca, el archivo conserva el diseño que tenía antes, lo cual importa si otra herramienta lee el archivo por posición. Aun así, es más seguro leer el archivo por nombre de encabezado.

El selector no se muestra para JSON. Una exportación JSON siempre incluye handled_at, y su valor es null mientras el envío está abierto. Una exportación en cola es una copia de un instante concreto, así que los archivos que descargó antes de v1.29.0 no cambian y una exportación nueva refleja el estado en el momento en que se puso en cola.

Qué muestra la API

En la API de gestión, un envío gestionado incluye handled_at con el mismo formato de marca de tiempo. Un envío abierto omite la clave por completo, igual que read_at ya se omite mientras un envío no está leído. Eso difiere de la exportación JSON, que conserva la clave y la establece en null, por lo que un consumidor que maneje ambas debe tratar una clave ausente y un null como lo mismo.

En la lista, handled=true devuelve solo los envíos que tienen hora de gestión, y handled=false devuelve solo los abiertos. Si omite el parámetro, obtiene ambos. Se combina con los filtros existentes is_spam y unread y con la búsqueda q.

Dónde es poco preciso

• Es una hora, no un historial. Solo se exporta la última hora de gestión, por lo que no puede ver que un envío fue reabierto.

• No nombra a nadie. No use la columna para comparar a los miembros.

• Gestionado significa atendido, no necesariamente respondido. Un envío puede estar gestionado sin que nadie escriba al remitente.

• Por sí sola, no es una métrica de tiempo de respuesta. Puede calcular un intervalo entre la hora de recepción y la hora de gestión, pero ese intervalo incluye cada motivo por el que un envío permaneció abierto, y al reabrirlo se reinicia.

• No reescribe nada que ya se haya exportado.

Este artículo explica la versión. La entrada del Registro de cambios de v1.29.0 sigue siendo el registro de lo que se publicó.