Saltearse al contenido
Nappai Documentation

Jira Webhook

Bienvenido al componente Jira Webhook dentro de Nappai. Imagina que este componente funciona como un “vigilante inteligente” o un receptor de mensajes que está conectado directamente a tu proyecto en Jira.

Su misión principal es escuchar lo que sucede en Jira en tiempo real. Cada vez que alguien crea una incidencia, actualiza un comentario o cierra un sprint, Jira envía una “nota” a este componente. En lugar de recibir un montón de información confusa y técnica, Nappai lee esa nota, la clasifica y te avisa solo sobre las cosas que realmente te interesan, preparándolas para que puedas automatizar acciones o tomar decisiones.

¿Cómo funciona?

El proceso es sencillo y automático:

  1. Escucha: El componente se queda “atento” a las señales que le envía tu cuenta de Jira Cloud.
  2. Filtro: Si Jira envía muchas señales, este componente verifica cuáles de ellas has configurado para ser importantes. Por ejemplo, puedes decidir escuchar solo cuando se crea una tarea (“Issue Created”) y hacer caso omiso de los comentarios (“Comment Updated”).
  3. Traducción: Una vez que detecta un evento importante, traduce la información técnica de Jira a un formato claro y estructurado. Extrae detalles clave como:
    • ¿Quién hizo el cambio?
    • ¿Qué cambió exactamente (título, estado, prioridad)?
    • ¿Cuándo ocurrió?
  4. Entrega: Finalmente, te entrega estos datos organizados para que los uses en el siguiente paso de tu automatización (por ejemplo, para guardarlos en una base de datos o para que un Chatbot los analice).

Conexión y Credenciales

Este componente requiere configurarse previamente una credencial en el panel de Nappai para poder interactuar con el servicio externo de Jira:

  1. Dirígete a la sección de Credenciales en tu panel de Nappai.
  2. Crea una nueva credencial del tipo especificado para este componente y guarda los campos requeridos (claves de API, tokens, etc.).
  • Necesitarás la Jira Base URL (la dirección web de tu empresa en Atlassian).
  • Tu Jira Email.
  • Tu Jira API Token (un código de seguridad que generas en la web de Atlassian).
  1. En tu flujo de trabajo, selecciona la credencial guardada en el campo de entrada Credential de este nodo.

Entradas

Los siguientes campos están disponibles para configurar este componente. Cada campo puede estar visible en diferentes operaciones:

Campos de Entrada

  • Events: Te permite elegir qué tipo de cambios en Jira quieres escuchar (por ejemplo, “Issue Created” para nuevas tareas o “Comment Updated” para nuevos comentarios). Si no seleccionas nada, escuchará todo.
  • Credential: Aquí seleccionas la conexión de seguridad (Usuario y Token) que configuraste previamente para hablar con Jira.
  • Data: Recibe los datos crudos que llegan de Jira automáticamente; no necesitas tocar este campo manualmente.

Salidas

Este componente produce un resultado único llamado Data que contiene toda la información estructurada del evento que ocurrió en Jira.

Ejemplo de Respuesta JSON

Cuando el componente detecta un evento válido, devuelve información similar a la siguiente estructura. Puedes usar los campos que ves aquí en los siguientes pasos de tu automatización: json { “text”: “[jira:issue_created] PROJ-123: Bug de login”, “data”: { “category”: “issue”, “operation”: “created”, “user”: “usuario@empresa.com”, “issue”: { “key”: “PROJ-123”, “summary”: “Bug de login”, “status”: “Open”, “priority”: “High”, “assignee”: “Juan Perez”, “reporter”: “Maria Lopez”, “issuetype”: “Bug”, “created”: “2023-10-27T10:00:00.000+0000”, “updated”: “2023-10-27T10:00:00.000+0000” } } }

Nota: Si el evento no es del tipo que seleccionaste en “Events”, el sistema te devolverá un aviso indicando que fue ignorado, para no saturar tu flujo de trabajo con datos irrelevantes.

Conectividad

Este componente es una puerta de entrada a tus automatizaciones. Lógicamente, se conecta hacia adelante con otros componentes que necesitan procesar esos datos. Por ejemplo:

  • Con componentes de Base de Datos: Para guardar los cambios ocurridos en Jira en un registro histórico.
  • Con Asistentes de IA (LLMs): Para pedirle a la IA que analice el comentario nuevo o que sugiera una acción basada en el cambio de estado de una tarea.
  • Con herramientas de Notificación: Para enviar un mensaje automático a Slack o Email cuando ocurra el evento.

Ejemplo de Uso

Imagina que quieres automatizar la gestión de incidencias críticas.

  1. Arrastras el componente Jira Webhook a tu tablero.
  2. En el campo Events, seleccionas únicamente “Issue Created” (Nueva Incidencia).
  3. Conectas la salida Data a un componente de Chatbot/IA.
  4. En el prompt de la IA, le pides: “Si la prioridad es ‘High’, sugiere un experto en el equipo de desarrollo”.
  5. Cuando alguien crea una incidencia crítica en Jira, el webhook capta el dato, la IA lee la prioridad y responde con la sugerencia, la cual puedes luego guardar o enviar.

Consejos y Mejores Prácticas

  • Selecciona solo lo necesario: No es necesario escuchar todos los eventos (como “Sprint Closed” o “Version Released”) si solo te interesa el contenido de las tareas. Filtrar por eventos específicos mantiene tu automatización más rápida y limpia.
  • Revisa los filtros: Si notas que tu automatización se ejecuta demasiado o por error, verifica que el campo Events esté bien configurado para ignorar las acciones que no te interesan.
  • Datos estructurados: Aprovecha que el componente te entrega los datos “limpios” (en un diccionario ordenado) para facilitar su uso en cálculos o bases de datos, en lugar de tener que buscar manualmente en un texto largo.

Consideraciones de Seguridad

  • Seguridad de Conexión: Asegúrate de mantener tu Jira API Token en secreto dentro de la sección de Credenciales de Nappai. No compartas este token públicamente.
  • Validación de Datos: El componente está diseñado para ser robusto; si recibe datos corruptos o no válidos de Jira, los ignorará silenciosamente para evitar errores en todo el flujo de trabajo.