Instalación y permisos

HeadsUp es una app de Atlassian Forge. Funciona por completo sobre la infraestructura de Atlassian, no opera servidores propios y no define ningún endpoint externo. La app está construida para cumplir los criterios del programa Runs on Atlassian de Atlassian; el distintivo todavía no está concedido.

Instalación

La instalación se hace por sitio de Jira Cloud a través del Atlassian Marketplace. Después no hace falta configurar nada: cada persona crea sus propios recordatorios y no hay ajustes que mantener a nivel de sitio. Cualquier cambio en los permisos solicitados exige un nuevo consentimiento de administración al actualizar.

Ámbitos solicitados

Ámbito	Por qué lo necesita la app
read:jira-work	Leer tickets, comentarios e historial de cambios para evaluar los disparadores, validar la JQL y cargar las listas de estados de los selectores
read:jira-user	Resolver los nombres visibles a partir de los identificadores de cuenta («asignado a Jane Doe»)
write:jira-work	Enviar notificaciones mediante la API notify de Jira (correo) y publicar los comentarios opcionales en el ticket
storage:app	Guardar recordatorios, notificaciones y registros de auditoría en el almacenamiento alojado de Forge
read:servicedesk-request	Leer los datos de SLA de las solicitudes abiertas de JSM para el aviso anticipado de SLA (edición Advanced)
manage:jira-configuration	Se usa con un único fin: leer el número de usuarios de Jira con licencia, que determina el fondo mensual de créditos de IA del sitio.

Sobre este último punto: el número de usuarios con licencia procede de las métricas de licencia de Jira, y Atlassian sitúa esa área detrás de este ámbito. La app lee un solo número por producto de Jira y no cambia nada. Cada llamada que hace una app queda visible para la administración en el registro de auditoría del sitio.

Comentarios restringidos y el usuario de app

HeadsUp funciona con su propio usuario de app. Lo que ese usuario no ve no llega a la app: un comentario restringido a un rol de proyecto no se entrega a HeadsUp como evento, así que un recordatorio sobre él no se activa. Ese es el comportamiento predeterminado y no requiere ninguna configuración.

La administración del proyecto puede cambiarlo para un proyecto concreto. El usuario de app aparece en la administración de roles con el nombre de la app en el Marketplace, HeadsUp: AI Reminders and Notifications for Jira. Añádelo, en la configuración del proyecto, en el área de personas y roles, al rol al que están restringidos los comentarios. A partir de ahí el evento llega a la app y el recordatorio se activa.

El contenido sigue oculto en ambos casos. Incluso en un comentario que la app ya ve, la notificación, la entrada de la bandeja y el registro de auditoría llevan la frase neutra «Hay un nuevo comentario con visibilidad restringida. Su contenido no aparece aquí, abre el ticket para leerlo.», no se escribe ningún comentario automático y los recordatorios de IA omiten el comentario sin consumir crédito. Los dos niveles se apoyan uno en otro: la pertenencia al rol decide si se activa algo, la supresión decide qué se muestra.

Las notas internas de Service Management se comportan de otro modo. Allí la app tiene la visibilidad de los agentes, así que sus eventos siempre llegan y solo se aplica el segundo nivel.

Ediciones

	Standard	Advanced
Recordatorios de tickets, alertas de filtro, bandeja de entrada	✓	✓
Detección de IA	✓	✓
Créditos de IA por usuario con licencia y mes	20	200
Aviso anticipado de SLA (JSM)	✗	✓

La edición sigue automáticamente a la licencia del Marketplace, no hay nada que configurar en la app. Bajar de Advanced a Standard tiene dos consecuencias que conviene planificar.

• Las alertas de SLA existentes siguen guardadas, pero no vuelven a activarse. En la edición Standard, la comprobación horaria de SLA termina de inmediato. Las alertas siguen en la lista y parecen activas, y no se pueden crear nuevas. Una alerta de filtro tampoco se puede cambiar a otro disparador, así que el camino es borrarla y, si hace falta, crear una alerta nueva con otro disparador. Al volver a Advanced, las alertas existentes se activan de nuevo sin hacer nada más.
• El límite de créditos de IA se recalcula al momento. El límite sigue a la edición actual, mientras que el contador de consumo del mes en curso se mantiene. Un sitio que ya haya consumido más de lo que permite Standard queda por encima del límite desde ese momento, y la evaluación con IA se detiene hasta el día 1 del mes siguiente. Todo lo demás sigue funcionando.