Crear incidencias de Jira desde flujos de trabajo
Abre una incidencia de Jira desde un flujo de trabajo — por una puntuación baja, un comentario o una acción — y deja que la acción de Polzy se cierre sola cuando la incidencia esté hecha. Conecta Jira Cloud una vez con un token de API.
En esta página
Cuando algo en tus comentarios necesita que un equipo actúe — una puntuación que baja, una queja sobre un producto, una acción con responsable — un flujo de trabajo puede abrir una incidencia de Jira para ello, con lo que Polzy sabe. Si el flujo también creó una acción de Polzy, la acción sigue a la incidencia y se cierra sola cuando la incidencia está hecha. Al final de esta guía tendrás Jira conectado y un flujo que abre incidencias en el proyecto que elijas.
Jira está incluido en el plan Business y se usa desde los flujos de trabajo. Solo un Administrador puede conectarlo y crear flujos de trabajo.
Antes de empezar
Necesitas:
- Un espacio de trabajo en el plan Business, con el rol de Administrador.
- Integraciones y Flujos de trabajo activados para el espacio de trabajo, en Configuración → General → Qué hace este espacio de trabajo.
- Jira Cloud — un sitio que abres en una dirección como
https://acme.atlassian.net. Jira Data Center y Jira Server no se pueden conectar. - La cuenta de Atlassian con la que se crearán las incidencias. Una cuenta dedicada, como
automation@acme.com, evita que las incidencias queden ligadas a una persona. Necesita permiso para ver y crear incidencias en los proyectos que vayas a usar — las pantallas más recientes de Jira llaman a los proyectos espacios (spaces) y a las incidencias work items. - Un token de API para esa cuenta (abajo).
Crear un token de API
- Con la sesión de Atlassian iniciada con la cuenta que usará Polzy, abre su página de tokens de API:
id.atlassian.com/manage-profile/security/api-tokens. - Elige Create API token — no Create API token with scopes. Polzy inicia sesión en la propia dirección de tu sitio de Jira, que un token con scopes no puede abrir.
- Llámalo Polzy, elige cuándo caduca — como mucho en un año — y elige Create.
- Copia el token. Atlassian no vuelve a mostrarlo.
Atlassian explica los tokens en Atlassian: Manage API tokens for your Atlassian account. Cuando el token caduca, Jira lo rechaza: crea uno nuevo y pégalo en Polzy antes de esa fecha.
Conectar Jira a Polzy
- En la barra lateral, en Automatizar, abre Integraciones y elige la pestaña Disponibles.
- Busca Jira y elige Conectar.
- En Sitio de Jira, escribe la dirección donde abres Jira, empezando por
https://. - En Correo de la cuenta, escribe la dirección de correo de la cuenta de Atlassian a la que pertenece el token.
- Pega el token en Token de API.
- Elige Probar conexión. Polzy responde Connected as y el nombre de la cuenta.
- Elige Conectar.
El token se guarda cifrado. Una vez conectado, la fila de Jira en Integraciones ofrece Configurar alcance para cambiar la cuenta o el token, y Gestionar para su página.
Abrir una incidencia desde un flujo de trabajo
- Abre Flujos de trabajo y el flujo, o crea uno nuevo — por ejemplo con el disparador Respuesta de encuesta o Umbral de puntuación.
- En Conectores, dentro de Pasos instalados, arrastra Crear incidencia en Jira · Jira al lienzo, detrás del paso al que debe seguir. Una fila con candado significa que Jira aún no está conectado o requiere atención: al elegirla se abre la página de Jira.
- En Proyecto, elige el proyecto. La lista muestra todos los proyectos que la cuenta puede ver, con su nombre y su clave.
- En Tipo de incidencia, elige el tipo. La lista muestra los tipos propios de ese proyecto, sin subtareas; de entrada está elegido Task.
- Escribe el Resumen: una línea, hasta 255 caracteres. Escribe
{{para insertar un valor de la ejecución, como el título de la encuesta o la puntuación total. - Si quieres, escribe una Descripción. Una línea en blanco empieza un párrafo nuevo.
- Si quieres, añade Etiquetas, separadas por comas. Las etiquetas de Jira no pueden tener espacios, así que un espacio se convierte en un guion.
El paso deja la clave de la incidencia, como CS-142, en {{connector.issueKey}} y su dirección en {{connector.url}}, para que un paso posterior — un mensaje de Slack, por ejemplo — pueda enlazarla. Una Ejecución de prueba recorre el flujo sin abrir la incidencia: el paso dice lo que haría. Solo una ejecución real la crea. Flujos de trabajo explica los disparadores y los pasos.
Cerrar la acción cuando la incidencia esté hecha
Cuando Crear incidencia en Jira se ejecuta después de Crear elemento de acción en la misma ejecución del flujo, la incidencia queda vinculada a esa acción:
- Seguido en. El panel de la acción muestra la clave de la incidencia, enlazada con Jira, y el último estado que informó Jira.
- Cerrada por Jira. Polzy consulta a Jira por la incidencia como mucho cada 10 minutos. Cuando llega a un estado de la categoría «hecho» de Jira — lo llame como lo llame tu equipo — la acción pasa a Hecho.
- Solo el estado. Los comentarios y demás cambios se quedan en Jira. Una acción cerrada antes en Polzy deja de consultarse.
Consulta Acciones para ver el tablero donde vive la acción.
Qué envía Polzy a Jira
Solo lo que dice el paso: el proyecto, el tipo de incidencia, el resumen, la descripción y las etiquetas, con los valores que insertes. Nada más sobre la respuesta o la persona sale de Polzy. Una respuesta anónima no tiene persona, así que valores como el correo de quien respondió quedan vacíos; lo que alguien escribió solo se envía después de su revisión de seguridad, y una respuesta retenida para revisión va como texto de sustitución. El tamaño mínimo de grupo no retiene las respuestas sueltas: piensa en quién puede leer el proyecto antes de poner las palabras de las personas en una incidencia.
Solución de problemas
- The Jira site must start with https://. Escribe la dirección completa, como
https://acme.atlassian.net. - The account email is required. Escribe la dirección de correo de la cuenta a la que pertenece el token.
- Jira refused the credentials (401). El correo y el token no coinciden, el token caducó o se revocó, o es un token con scopes. Crea un token nuevo como arriba, elige Configurar alcance en la fila de Jira en Integraciones, pégalo y elige Guardar. Una ejecución que se encuentre con esto pone Jira en Requiere atención.
- Jira refused the credentials (403). La cuenta no puede hacer eso en ese proyecto. Dale permiso para ver y crear incidencias allí.
- Jira answered 400: y un campo que is required. El tipo de incidencia exige un campo que el paso no rellena, como un componente. Hazlo opcional para ese tipo en Jira, o elige otro tipo.
- Jira answered 404. El proyecto se eliminó, o la cuenta ya no puede verlo.
- La lista Proyecto es un campo de texto. La cuenta no ve ningún proyecto, o no se pudo llegar a Jira. Revisa los accesos de la cuenta.
- This step names no project o The issue has no summary. Rellena el Proyecto y el Resumen del paso.
- Jira is needs_attention and cannot be used (en una ejecución). La conexión requiere atención. Vuelve a conectarla y ejecuta de nuevo.
- La acción no se cierra. El paso de Jira no se ejecutó después de Crear elemento de acción en la misma ejecución, el estado de la incidencia no está en la categoría «hecho» de Jira, o la conexión requiere atención — las consultas se detienen hasta que se resuelva.
Conviene saber
- Una conexión, todos los proyectos. Cada paso elige su proyecto entre los que ve la cuenta, así que una sola conexión sirve a todos los equipos.
- ¿Quién figura como informador? La cuenta a la que pertenece el token.
- ¿Puede un paso abrir dos veces la misma incidencia? No. Un paso que se vuelve a ejecutar tras un fallo reutiliza lo que creó la primera vez.
Enlaces útiles
Artículos relacionados
Los miembros con sesión iniciada pueden preguntar a Polzy o escribir al equipo desde Soporte. La rapidez de nuestra respuesta depende de tu plan.