Personas: Administradores de sistema de Jira
Planes: Todos los planes de Miro (para la integración con Jira Server/Data Center mediante OAuth 1.0)
Plataformas: Navegador, aplicación de escritorio (para los procedimientos de configuración)
Para asegurar que tus tarjetas de Jira en un tablero de Miro se mantengan actualizadas, Miro debe recibir mensajes de Jira cada vez que ocurran cambios de datos. Estos eventos de Jira se transmiten a Miro a través de un webhook.
Esta guía proporciona dos maneras de crear webhooks para Jira Server y Jira Data Center usando OAuth 1.0 y OAuth2.0.
Crear un webhook automáticamente
Al configurar tu integración de tarjetas de Jira, si te estás conectando al Jira Server o al Jira Data Center, puedes dejar la opción Crear un webhook automáticamente activada. Este es el método recomendado.
✏️ La creación automática del webhook requiere que inicies sesión en Jira como Administrador de Sistema de Jira.
Configuración de tarjetas de Jira, Paso 2: "Crear un webhook automáticamente" está habilitada
Después de que el webhook se haya creado automáticamente, es una buena práctica ir a tu página de WebHooks de Jira y editar el webhook para darle un nombre único. Esto es especialmente importante si planeas conectar varios equipos de Miro a tu instancia de Jira.
✏️ Para conexiones OAuth2.0, la conexión del lado de Miro se establece a nivel de empresa. Se crea un webhook para todos los equipos de Miro.
✏️ Para conexiones OAuth 1.0 a nivel de equipo de Miro, se crea un webhook por equipo. A nivel de empresa de Miro, se crea un webhook para todos los equipos.
Crear un webhook manualmente
Si prefieres o necesitas crear el webhook manualmente, sigue estos pasos.
Obtén la URL del webhook desde Miro
- En la configuración de tarjetas de Jira en Miro (Paso 2, al conectar al Jira Server/Data Center), desmarca la opción de Crear un webhook automáticamente.
- Copia y pega la URL de Jira de tu organización y haz clic en Conectar y guardar configuración.
Configuración de tarjetas de Jira, Paso 2: "Crear un webhook automáticamente" está deshabilitado - Permite que la integración se conecte en Jira cuando se te indique.
- Después de estos pasos, Miro te proporcionará la URL del WebHook:
URL del WebHook proporcionada por Miro
✏️ Si no eres un Administrador del Sistema de Jira, copia la URL del WebHook proporcionada por Miro y mándasela a tu Administrador del Sistema de Jira para que pueda crear el webhook en Jira utilizando las instrucciones que están a continuación.
Crear el webhook en Jira
A continuación se presentan los pasos para crear un webhook en Jira usando la URL obtenida de Miro. También puedes consultar la documentación oficial de Atlassian para Jira Server y para Jira Cloud (aunque este artículo se centra en Server/Data Center).
- Para navegar a la página de WebHooks en Jira, ve a Administración de Jira > Sistema > Avanzado > WebHooks (la ruta exacta puede variar ligeramente dependiendo de tu versión de Jira). Alternativamente, a menudo puedes usar un enlace directo agregando
/plugins/servlet/webhooksa la URL de tu instancia de Jira (por ejemplo,https://NombreDeTuInstanciaDeJira/plugins/servlet/webhooks). - Haz clic en Crear un WebHook en la esquina superior derecha de la página de WebHooks.
- Ingresa un Nombre descriptivo para el WebHook (por ejemplo, "Webhook de Integración con Miro").
- Establece el estado del WebHook en Habilitado.
- Pega el URL del webhook que copiaste de la configuración de Miro en el campo URL.
Configuración del sistema de webhooks en Jira - En la sección Eventos, bajo Problema, selecciona los eventos actualizado y eliminado.
- Haz clic en Crear para guardar el webhook.
Configuración de eventos de WebHook en Jira - Después de que se haya creado el webhook en Jira, vuelve al Paso 2 en la configuración de tarjetas de Jira en Miro, asegúrate de que la URL de Jira esté correctamente completada y haz clic en Conectar.
Ahora el webhook está creado y configurado. Las tarjetas de Jira en tus tableros de Miro se actualizarán automáticamente cuando se realicen cambios en Jira.