Personas: Administradores del sistema de Jira
Planes: Todos los planes de Miro (para la integración de Jira Server/Data Center a través de OAuth 1.0)
Plataformas: Navegador, aplicación de escritorio (para procedimientos de configuración)
Para asegurar que tus tarjetas de Jira en un tablero de Miro se mantengan actualizadas, es necesario que Miro reciba mensajes de Jira cada vez que ocurran cambios de datos. Estos eventos de Jira se transmiten a Miro mediante un webhook.
Esta guía ofrece dos formas de crear webhooks para Jira Server y Jira Data Center usando OAuth 1.0 y OAuth2.0.
Crear un webhook automáticamente
Al configurar la integración de tarjetas de Jira, si te estás conectando a Jira Server o Jira Data Center, puedes dejar activada la opción Crear un webhook automáticamente. Este es el método recomendado.
✏️ La creación automática de webhook requiere que estés conectado a Jira como Administrador del Sistema de Jira.
Configuración de tarjetas de Jira, Paso 2: "Crear un webhook automáticamente" está habilitado
Después de que el webhook se crea 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 con OAuth2.0, la conexión del lado de Miro se establece a nivel de la compañía. Se crea un webhook para todos los equipos de Miro.
✏️ Para conexiones con OAuth 1.0 a nivel de equipo de Miro, se crea un webhook por equipo. A nivel de la 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.
Obtener la URL del webhook de Miro
- En las configuraciones de tarjetas de Jira en Miro (Paso 2, cuando te conectas al servidor/centro de datos de Jira), desmarca la opción para Crear un webhook automáticamente.
- Copia y pega la URL de Jira de tu organización y haz clic en Conectar y guardar configuraciones.
Configuraciones 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 solicite.
- 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 Jira, por favor copia la URL del Webhook proporcionada por Miro y envíala a tu administrador del sistema Jira para que pueda crear el webhook en Jira usando las instrucciones a continuación.
Crear el webhook en Jira
A continuación se presentan los pasos para crear un WebHook en Jira utilizando 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 ir a la página de Webhooks en Jira, ve a Administración de Jira > Sistema > Avanzado > Webhooks (la ruta exacta puede variar ligeramente según la versión de Jira). Alternativamente, a menudo puedes usar un enlace directo añadiendo
/plugins/servlet/webhooksa la URL de tu instancia de Jira (por ejemplo,https://TuNombreDeInstanciaDeJira/plugins/servlet/webhooks). - Haz clic en Crear un Webhook en la esquina superior derecha de la página de Webhooks.
- Introduce un Nombre descriptivo para el Webhook (por ejemplo, "Webhook de Integración con Miro").
- Establece el estado del Webhook como Activado.
- Pega la URL del WebHook copiada de la configuración de Miro en el campo URL.
Configuración de webhooks del sistema en Jira - En la sección de Eventos, bajo Asunto, selecciona los eventos actualizado y eliminado.
- Haz clic en Crear para guardar el webhook.
Configuración de eventos del WebHook en Jira - Después de que el webhook se cree en Jira, regresa al Paso 2 en la configuración de las tarjetas de Jira en Miro, asegúrate de que tu 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.
Webhooks a nivel de organización
NOTA: Si los webhooks a nivel de equipo estaban restringidos con filtros JQL (por ejemplo, a proyectos específicos), el webhook a nivel organizacional necesita reflejar todos esos filtros JQL o no tener ningún filtro. Revisa tus requisitos de JQL antes de migrar a configuraciones a nivel organizacional.
En la Configuración de Administración de la Organización después de establecer la conexión, encontrarás la URL del Webhook en instancias Conectadas. Copia el webhook manual y pégalo en tu entorno de Jira.