¿Qué es la integración con Jira?
La integración con Jira permite que los agentes creen, vinculen y desvinculen issues de Jira directamente desde una conversación en CloudChat. Esto elimina la necesidad de cambiar entre herramientas y garantiza la trazabilidad entre atención y tickets de producto/ingeniería.
Requisitos previos
-
Cuenta en Jira Cloud (Atlassian)
-
Un usuario en Jira con permiso para crear issues en los proyectos deseados
-
Un token API de Jira (generado en https://id.atlassian.net/manage-profile/security/api-tokens)
¿Cómo configurar la integración?
-
Accede a Configuración > Integraciones en el menú lateral de CloudChat.
-
Haz clic en Jira y luego en Conectar.
-
Completa los campos:
-
URL del sitio Jira — por ejemplo:
https://tuempresa.atlassian.net -
Correo electrónico — el correo del usuario de Jira que se usará para las llamadas a la API
-
Token API — el token generado en el paso anterior
-
-
Haz clic en Guardar.
La integración estará disponible para todos los agentes de la cuenta.
¿Cómo crear un issue en Jira desde una conversación?
-
Abre una conversación en CloudChat.
-
En el encabezado de la conversación, haz clic en el ícono de Jira.
-
Haz clic en Crear issue.
-
Completa los campos obligatorios (marcados con *):
-
Título — resumen del issue
-
Proyecto — el proyecto de Jira donde se creará el issue
-
Tipo de issue — solo aparece después de seleccionar el proyecto (ej: Bug, Task, Story)
-
-
Opcionalmente, completa:
-
Descripción — detalles adicionales
-
Prioridad — nivel de urgencia
-
Responsable — a quién se asignará el issue
-
-
Haz clic en Crear.
El issue se creará en Jira con un enlace a la conversación en la descripción.
¿Cómo vincular un issue ya existente?
-
En el panel de Jira dentro de la conversación, haz clic en Vincular issue existente.
-
Busca por el título o la clave del issue (ej:
PROJ-123). -
Haz clic en el issue deseado para vincularlo.
Se añadirá un comentario automáticamente en el issue de Jira informando que fue vinculado a la conversación.
¿Cómo desvincular un issue?
-
En el panel de Jira dentro de la conversación, localiza el issue vinculado.
-
Haz clic en el ícono de papelera al lado del issue.
Se añadirá un comentario en Jira informando que el vínculo con la conversación fue removido.
¿Un issue puede estar vinculado a más de una conversación?
Sí. El mismo issue de Jira puede estar vinculado a múltiples conversaciones en CloudChat. Cada vínculo genera un comentario en Jira con el enlace a la conversación correspondiente.
¿Qué información aparece en la tarjeta del issue?
La tarjeta muestra:
-
Clave del issue (ej: PROJ-123)
-
Título
-
Estado actual en Jira (ej: To Do, In Progress, Done)
La información se actualiza automáticamente cada vez que abres el panel.
¿En qué idioma se añaden los comentarios en Jira?
Los comentarios se añaden en el idioma configurado en la cuenta de CloudChat.
¿Qué versiones de Jira son compatibles?
La integración funciona exclusivamente con Jira Cloud. Jira Server y Jira Data Center no son soportados.