Sago Alerts for Jira and Google Chat™de SagoSoft

Documentación

Última actualización: 3 de octubre de 2026

En Jira, el menú de la app se llama siempre Sago Alerts — Google Chat; dentro, la página aparece en el idioma de tu Jira (inglés, español o portugués). Aquí se citan los textos en español.

1. Antes de empezar

  • Un sitio de Jira Cloud con la app instalada desde el Atlassian Marketplace. Los espacios compartidos los configura un administrador de Jira.
  • Una cuenta de Google Workspace Business o Enterprise con Google Chat. El administrador de Workspace debe permitir los webhooks entrantes. Las cuentas personales de Gmail no pueden crear webhooks.
  • Una computadora: Google Chat no deja crear webhooks desde su app móvil.

2. Crear un webhook en Google Chat

  1. Abre Google Chat en el navegador y entra al espacio que recibirá los avisos (crea uno nuevo si hace falta).
  2. Haz clic en el nombre del espacio, arriba → Apps e integraciones.
  3. Haz clic en Añadir webhooks, ponle un nombre como “Jira” (la URL del avatar es opcional) y pulsa Guardar.
  4. Junto al webhook nuevo abre el menú Más (⋮) → Copiar enlace. El enlace empieza con https://chat.googleapis.com/v1/spaces/.

Trata el enlace del webhook como una contraseña. Quien lo tenga puede publicar en el espacio. Pégalo solo en la app. Si se filtra, borra el webhook en Google Chat y crea otro.

Si no ves Añadir webhooks, el administrador de Google Workspace desactivó los webhooks entrantes en tu organización. Google puede cambiar el nombre de estos menús; su guía oficial está aquí.

3. Añadir un espacio en Jira

  1. En Jira ve a Configuración (⚙) → Apps y, en el menú de la izquierda, abre Sago Alerts — Google Chat. Solo los administradores de Jira ven esta página. La primera vez, Jira puede mostrar la pantalla de Atlassian Permitir acceso (Allow access): la app la usa para comprobar, como tú, que eres administrador de Jira.
  2. Pulsa Añadir espacio y llena el formulario (ver la tabla).
  3. Pulsa Enviar prueba. En unos segundos debe aparecer en el espacio el mensaje “Conectado a Jira ✅”.
  4. Pulsa Guardar. El espacio aparece en la lista con su filtro y sus eventos.
CampoPara qué sirve
NombreUna etiqueta para ti, p. ej. “Equipo backend”. También sale en el mensaje de prueba y en el título del resumen diario.
URL del webhook de Google ChatEl enlace que copiaste. Tras guardar, la página solo muestra una versión enmascarada; deja el campo vacío para conservar el enlace guardado.
ProyectosVacío = todos los proyectos.
Filtro JQL extraOpcional. Ver Filtrar por proyecto y JQL.
Avisar cuandoLos eventos que recibe este espacio. Ver Elegir de qué avisar.
Solo cambios de estado haciaOpcional; aparece si marcas “Cambia el estado”. Ver Solo ciertos cambios de estado.
Estilo del mensajeTarjeta con detalles, o compacto (una línea).
Agrupar los cambios de una incidencia en un mismo hiloActivado de inicio. Ver Hilos.
Idioma de los mensajesInglés, español o portugués.
Resumen diarioOpcional. Ver Resumen diario.

Puedes añadir todos los espacios que necesites, cada uno con sus filtros, eventos, estilo e idioma. Un mismo cambio de Jira puede ir a varios espacios.

4. Elegir de qué avisar

OpciónAvisa cuandoDe inicio
Se crea una incidenciaSe crea una incidencia nueva.✓
Cambia el estadoLa incidencia pasa a otro estado.✓
Cambia el responsableSe asigna, se reasigna o se deja sin asignar.✓
Hay un comentario nuevoSe publica un comentario nuevo. Editar un comentario no avisa.✓
Se resuelve una incidenciaSe pone una resolución. Reabrir (quitar la resolución) no cuenta.✓
Cambia la prioridadCambia la prioridad.
Cambian otros camposCambia cualquier otro campo: resumen, descripción, etiquetas, fecha de vencimiento, campos personalizados… Los campos internos de Jira (Rank, registro de tiempo y similares) se ignoran.
Se borra una incidenciaSe borra una incidencia. Ver Incidencias borradas.

Elige al menos un evento o activa el resumen diario. Si una sola edición cambia varias cosas (por ejemplo estado y responsable), el espacio recibe un mensaje: el titular muestra el cambio más importante y la tarjeta muestra los demás.

5. Filtrar por proyecto y JQL

Proyectos limita el espacio a uno o varios proyectos. Filtro JQL extra añade cualquier condición JQL. Los dos se combinan con AND:

project in ("WEB", "API") AND (tu JQL)

Algunos filtros útiles:

labels = backend
priority in (High, Highest)
issuetype = Bug AND component = "Pagos"
assignee in membersOf("equipo-soporte")
  • El JQL se valida al guardar; si Jira lo rechaza, el error aparece bajo el campo. Consejo: prueba la consulta antes en la búsqueda de incidencias de Jira.
  • Cuando llega un cambio, es Jira quien comprueba si la incidencia cumple el filtro, tal como queda después del cambio.
  • El resumen diario usa los mismos proyectos y JQL.

6. Solo ciertos cambios de estado

Si marcas Cambia el estado puedes llenar Solo cambios de estado hacia con estados de tu Jira, por ejemplo Done y En revisión. Así solo avisan las transiciones hacia esos estados; las demás se omiten. Déjalo vacío para recibir todos los cambios de estado.

Si la misma edición cambia además otra cosa que el espacio escucha (por ejemplo el responsable), el mensaje se envía igual, con ese otro cambio como titular.

7. Vista de tarjeta o compacta

  • Tarjeta con detalles: un encabezado con la clave, el resumen y el proyecto; filas de Estado (con “de → a” cuando cambió), Responsable y Prioridad; hasta cuatro campos más que hayan cambiado, con su valor nuevo; el texto del comentario (primeros 600 caracteres, con las menciones como nombres); y un botón Abrir en Jira que lleva a la incidencia o al comentario.
  • Compacto (una línea): clave, resumen, qué cambió, un extracto corto del comentario (200 caracteres) y un enlace. Útil en espacios con mucho movimiento.

8. Hilos

Con Agrupar los cambios de una incidencia en un mismo hilo activado, el primer mensaje de una incidencia abre un hilo y los siguientes cambios de esa incidencia responden en él. Si Google Chat no encuentra el hilo, abre uno nuevo. Desactivado, cada cambio es un mensaje aparte. El resumen diario y los mensajes de prueba nunca van a los hilos de incidencias.

9. Idioma de los mensajes

Cada espacio elige inglés, español o portugués para los textos de la app (titulares, etiquetas, botones). El contenido de la incidencia, como el resumen, los comentarios o los nombres de estado, queda tal como está en Jira. Las páginas de configuración siguen el idioma de Jira de cada usuario (inglés, español o portugués; en otros idiomas se muestran en inglés).

10. Resumen diario

  • Activa Resumen diario y elige la hora, la zona horaria (de inicio, la de tu navegador) y los días (de inicio, de lunes a viernes).
  • El resumen toma las 50 incidencias actualizadas más recientemente en las últimas 24 horas que cumplen los proyectos y el JQL del espacio, las cuenta por estado y lista las 10 más recientes con enlace, más un botón Ver todo en Jira. Si cambiaron más de 50, el subtítulo muestra “50+” y los conteos cubren solo esas 50; el botón abre la lista completa en Jira.
  • La app revisa cada hora: el resumen llega durante la hora elegida, o hasta 2 horas después si una revisión falló. Nunca más de uno al día.
  • Si no cambió nada, llega una línea: “No se actualizó ninguna incidencia en las últimas 24 h.”
  • Un espacio puede recibir solo el resumen: desmarca todos los eventos y deja el resumen activado.

11. Avisos personales

Cualquier usuario de Jira puede recibir avisos de su propio trabajo en un espacio de Google Chat suyo, sin administrador.

  1. En Google Chat, crea un espacio solo para ti y añádele un webhook (ver el paso 2).
  2. En Jira, abre tu foto de perfil (el menú de perfil de la barra superior) y elige Sago Alerts — Google Chat.
  3. Pega el enlace del webhook y elige tus motivos (tabla de abajo).
  4. Pulsa Enviar prueba y luego Guardar. La primera vez, Jira te pide permitir que la app compruebe tus permisos: acéptalo. Antes de cada aviso personal la app le pregunta a Jira, como tú, si puedes ver la incidencia (y el comentario). Sin esa comprobación no se envía nada.
MotivoTe avisa cuandoDe inicio
Me asignan una incidenciaAlguien te asigna una incidencia, o la crea ya asignada a ti.✓
Alguien me mencionaTe @mencionan en una incidencia o en un comentario.✓
Mis incidencias cambian de estado o reciben comentariosUna incidencia asignada a ti tiene un cambio importante: estado, comentario, resolución, prioridad o responsable.✓
Cambian las que yo reportéLos mismos cambios importantes, en incidencias que reportaste.
Cambian las que observoLos mismos cambios importantes, en incidencias que observas.
  • Ignorar mis propios cambios (activado de inicio) omite lo que cambiaste tú.
  • Recibes un solo mensaje por cambio aunque apliquen varios motivos; el subtítulo de la tarjeta dice por qué (por ejemplo “Te la asignaron”).
  • Los mensajes van solo al espacio cuyo webhook pegaste. Usa un espacio privado: si pegas el webhook de un espacio compartido, todos sus miembros leerán tus avisos.
  • Desactivar borra tu suscripción y el enlace de tu webhook de la app. Funciona también si la licencia de la app no está activa.
  • Las cuentas desactivadas en Jira no reciben avisos personales. Cuando una cuenta de Atlassian se cierra o se elimina, la app borra la suscripción de esa persona en su siguiente revisión semanal. Los administradores no pueden borrar desde la app la suscripción de otra persona; desinstalar la app las borra todas.
  • Los avisos personales no incluyen incidencias borradas.

12. Comentarios restringidos y notas internas

Los comentarios restringidos a un grupo o a un rol del proyecto y las notas internas de Jira Service Management se tratan con cuidado:

  • Los espacios nunca reciben nada de ellos, porque en el espacio de Google Chat puede haber gente que no tiene permiso para verlos.
  • Los comentarios restringidos a un grupo o rol normalmente ni siquiera llegan a la app: Atlassian no envía a las apps los eventos de comentarios que no pueden ver. En la práctica no recibes ningún aviso por ellos, ni siquiera personal.
  • Las notas internas de los proyectos de servicio sí llegan a la app. Entonces el aviso personal dice solo “… añadió un comentario restringido (ábrelo en Jira)”, sin el texto, y solo si Jira confirma que puedes ver esa nota.
  • Las @menciones dentro de un comentario restringido no generan “te mencionó”.

13. Incidencias borradas

Una vez borrada, Jira ya no puede comprobar la incidencia con JQL, así que:

  • Los espacios sin filtros reciben el borrado.
  • Los espacios filtrados solo por proyecto lo reciben si la incidencia era de uno de esos proyectos.
  • Los espacios con filtro JQL extra no reciben borrados. La página de configuración lo advierte.

14. Pausar, editar o borrar un espacio

  • Interruptor Activo en la lista: pausa el espacio y conserva su configuración.
  • Editar: cambia lo que quieras. Deja vacío el campo del webhook para conservar el enlace guardado, o pega uno nuevo para reemplazarlo.
  • Enviar prueba: comprueba que el webhook guardado sigue funcionando.
  • Borrar: elimina del almacenamiento de la app la configuración del espacio y el enlace de su webhook. Funciona también si la licencia no está activa. Los mensajes ya publicados en Google Chat se quedan ahí.

15. Prueba y licencia

  • La app se vende en el Atlassian Marketplace: gratis para sitios de hasta 10 usuarios y de pago por usuario a partir de ahí, con 30 días de prueba gratis. Atlassian se encarga de cotizaciones, cobros y facturas.
  • Si la licencia no está activa (terminó la prueba o se canceló la suscripción), la app deja de enviar avisos y resúmenes, y las páginas de configuración lo indican. La configuración se conserva mientras la app esté instalada y los avisos vuelven cuando la licencia se reactiva. Los cambios hechos mientras tanto no se envían después.
  • Mientras la licencia no esté activa puedes borrar espacios (página de administración) y desactivar los avisos personales (página personal).
  • Si desinstalas la app, Atlassian conserva sus datos guardados hasta 28 días y después los borra definitivamente. Reinstalar no recupera la configuración anterior y no ofrecemos recuperación de datos, así que anota tu configuración antes si piensas volver. Ver la política de privacidad.

16. Limitaciones conocidas

  • Retraso. Atlassian entrega los eventos de Jira a las apps de forma asíncrona. La mayoría llega en segundos, pero Atlassian documenta que pueden tardar hasta unos 3 minutos, y más durante incidentes de la plataforma (ver la página de estado de Atlassian Developer).
  • Cuotas y límites de Atlassian Forge. La app funciona en Atlassian Forge y está sujeta a sus cuotas y límites de plataforma: cuánto puede durar cada función, cuántas invocaciones y llamadas a la API de Jira puede hacer una app y cuánto puede guardar y leer. Si se alcanza un límite, los avisos o resúmenes pueden retrasarse u omitirse, y Atlassian puede suspender temporalmente una app que los exceda. Atlassian los publica en Forge platform quotas and limits.
  • Límite de Google Chat. Google acepta alrededor de 1 mensaje por segundo por espacio, compartido entre todos los webhooks de ese espacio. La app reintenta (hasta 4 intentos en unos 20 segundos), pero en ediciones masivas de muchas incidencias algunos mensajes pueden perderse. Para proyectos con mucho movimiento usa filtros, un espacio aparte o el resumen diario.
  • Comentarios editados. Editar un comentario no avisa, así que quien sea @mencionado por primera vez en un comentario editado no recibe aviso.
  • Nombres de estado. Los nombres de estado, resolución y prioridad vienen del historial de cambios de Jira y pueden salir en el idioma predeterminado del sitio de Jira, no en el de cada usuario.
  • En un solo sentido. Los avisos van de Jira a Google Chat. No se puede responder a Jira ni crear incidencias desde Google Chat.
  • Formato fijo. Los mensajes se ajustan con estilo, hilos e idioma, no con plantillas.
  • Longitudes. Los extractos de comentarios llegan a 600 caracteres (200 en vista compacta) y los resúmenes a 180.
  • Tamaño del resumen diario. Los conteos por estado cubren como máximo las 50 incidencias actualizadas más recientemente; si hay más, el resumen muestra “50+”.
  • Comentarios restringidos. Los comentarios restringidos a un grupo o rol normalmente nunca llegan a la app, así que no generan avisos.
  • Licencia inactiva. Los cambios hechos con la licencia inactiva no se envían después.
  • Comprobación personal. Si quitas el acceso de la app en la configuración de tu cuenta de Atlassian, los avisos personales se detienen hasta que vuelvas a guardar tu página personal.

17. Solución de problemas

“Esa no es una URL de webhook de Google Chat”

El enlace debe empezar con https://chat.googleapis.com/v1/spaces/ y contener key= y token=. Cópialo de nuevo con Más (⋮) → Copiar enlace en Google Chat.

La prueba falla con “Google Chat HTTP …”

  • 404: se borró el webhook o el espacio. Crea un webhook nuevo y pégalo.
  • 403: Google rechazó el mensaje, normalmente porque se desactivaron los webhooks en tu organización o se quitó el webhook.
  • 400: el enlace está dañado. Cópialo de nuevo.
  • 429: demasiados mensajes a ese espacio en este momento. Espera un minuto y vuelve a intentar.

La prueba funciona pero no llegan los cambios

  • Revisa que el espacio esté Activo, que el proyecto de la incidencia esté elegido (o la lista vacía) y que la incidencia cumpla el JQL después del cambio.
  • Revisa que el evento esté marcado y, para los cambios de estado, la lista Solo cambios de estado hacia.
  • Los comentarios restringidos nunca llegan a los espacios, y los espacios con JQL no reciben borrados.
  • Revisa que la licencia de la app esté activa (si no, la página de configuración lo indica).
  • Espera hasta 3 minutos: Atlassian puede entregar el evento tarde.

No llegan los avisos personales

  • Vuelve a guardar la página personal y acepta el permiso si Jira lo pide.
  • Ignorar mis propios cambios oculta lo que cambiaste tú.
  • Solo recibes cambios de incidencias (y comentarios) que puedes ver en Jira.
  • Los comentarios restringidos a un grupo o rol normalmente nunca llegan a la app, así que no generan avisos.

No llega el resumen diario

Revisa la hora, la zona horaria y los días. El resumen se envía durante la hora elegida o hasta 2 horas después.

¿Sigue sin funcionar? Ve a Soporte.