Saltearse al contenido
Nappai Documentation

Jira Webhook

Jira Webhook es un componente de inicio: pone en marcha el flujo cuando ocurre en tu Jira Cloud alguno de los eventos que elijas, por ejemplo que se crea o se modifica una incidencia, que alguien comenta o que empieza un sprint. NappAI registra el aviso en tu Jira con tu credencial, así que no tienes que configurar nada dentro de Jira.

Cuándo usarlo

  • Cada incidencia nueva debe avisar por mensaje al canal del equipo.
  • Cuando una incidencia cambia de estado quieres avisar al cliente que la reportó.
  • Quieres que un agente de IA lea cada comentario nuevo y proponga una respuesta.
  • Al empezar o cerrar un sprint quieres generar un resumen automático.

Configuración

Necesitas una credencial Jira API con la dirección de tu Jira Cloud, el correo de tu cuenta de Atlassian y un token de API. Consulta Credenciales.

CampoQué hace
Credential (obligatorio)La credencial Jira API de tu Jira. Se usa para registrar el aviso en Jira.
EventsLos eventos que ponen en marcha el flujo. Puedes elegir varios. Si no eliges ninguno, o eliges All Events (*), sirven todos.
DataSirve para probar el componente: pega aquí un ejemplo de aviso de Jira y ejecuta el flujo para ver el resultado.

Los eventos disponibles son:

  • Incidencias: Issue Created, Issue Updated, Issue Deleted.
  • Comentarios: Comment Created, Comment Updated, Comment Deleted.
  • Propiedades de incidencia: Issue Property Set, Issue Property Deleted.
  • Sprints: Sprint Created, Sprint Updated, Sprint Started, Sprint Closed, Sprint Deleted.
  • Versiones: Version Created, Version Updated, Version Released, Version Unreleased, Version Moved, Version Merged, Version Deleted.

Registrar el aviso en Jira

  1. Despliega una versión del flujo. El registro necesita una versión desplegada. Ver Versiones y publicación.
  2. En el componente, debajo de sus campos, pulsa Consumir. Se abre la ventana Acceso a API en la pestaña Jira Webhook.
  3. Pulsa Registrar Webhook. NappAI crea el aviso en tu Jira con los eventos elegidos y sustituye cualquier aviso anterior de este mismo flujo.
  4. La pestaña compara los Eventos del flujo con los Eventos de Jira y muestra Sincronizado cuando coinciden. Si cambias los eventos del componente, aparece Desincronizado y la lista de eventos por añadir o por eliminar: vuelve a registrar el aviso.
  5. Para dejar de recibir avisos, pulsa Eliminar Webhook.

Resultado

La salida Data devuelve el evento ordenado:

  • El evento (webhook_event), su categoría (event_category, por ejemplo issue, comment o sprint) y lo que ha pasado (operation, por ejemplo created).
  • La fecha (timestamp) y la persona que lo provocó (user).
  • Si el evento es de una incidencia, sus datos en issue: clave, título, descripción, estado, prioridad, persona asignada, informador, tipo, fechas y proyecto.
  • Si algo ha cambiado, la lista de cambios en changelog, con el campo, el valor anterior y el nuevo.
  • Si el evento es de un comentario, sus datos en comment: texto, autor y fechas.

Si llega un evento que no está entre los elegidos en Events, el flujo se detiene en este componente y no continúa.

Conecta Data a un agente, a un componente de mensajería o a Jira Issue Handler para responder en la propia incidencia.

Ejemplo

Un equipo de producto quiere enterarse en su chat de cada incidencia nueva.

  1. Añade Jira Webhook con la credencial de tu Jira y elige Issue Created en Events.
  2. Conecta Data a un agente que redacte un aviso breve con la clave, el título y la prioridad, y este a un componente de mensajería.
  3. Despliega el flujo, pulsa Consumir en el componente y después Registrar Webhook.

Buenas prácticas

  • Elige solo los eventos que vayas a usar. Issue Updated ocurre con mucha frecuencia y ejecutaría el flujo en cada cambio.
  • Si modificas los eventos después de registrar el aviso, vuelve a registrarlo para que Jira envíe los nuevos.

Componentes relacionados