> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Jira

> Asigna tickets de Jira a Devin y conviértelos en pull requests (PR)

<div id="setting-up-the-integration">
  ## Configurar la integración
</div>

1. En tu cuenta de Devin en app.devin.ai, ve a [Settings > Connections > Jira](https://app.devin.ai/settings/connections/jira) y haz clic en "Connect".
2. Se te redirigirá a Jira para revisar los permisos y conceder acceso a Devin.
3. Una vez conectada, configura tus **etiquetas de playbook** y, opcionalmente, configura las **activaciones de automatización** en la página de Settings.

<Tip>
  Después de conectarla, te recomendamos conectar una **cuenta de servicio** para que los comentarios de Devin aparezcan como enviados por el bot y no desde tu cuenta personal. Consulta [Conectar una cuenta de servicio](#connecting-a-service-account) más abajo.
</Tip>

<div id="how-to-trigger-devin-from-jira">
  ## Cómo activar Devin desde Jira
</div>

Hay cuatro maneras de iniciar una sesión de Devin desde un ticket de Jira:

<div id="assign-the-ticket-to-devin">
  ### Asigna el ticket a Devin
</div>

Asigna el ticket directamente a la cuenta de servicio de Devin en Jira. Devin usará el **playbook predeterminado** configurado en la [configuración de tu integración con Jira](https://app.devin.ai/settings/connections/jira) para empezar a trabajar en el ticket.

<div id="add-a-playbook-label">
  ### Agrega una etiqueta de playbook
</div>

Agrega una etiqueta de playbook (p. ej., `!plan`, `!implement`, `!triage`) al ticket. Devin iniciará una sesión con el playbook específico que corresponda a esa etiqueta. Estas etiquetas corresponden a las **etiquetas de playbook** configuradas en la configuración de tu integración. Debes crear estas etiquetas manualmente en tu proyecto de Jira; copia el nombre de la etiqueta desde la configuración de la integración.

<div id="add-the-devin-label">
  ### Agrega la etiqueta "devin"
</div>

Agrega la etiqueta `devin` a cualquier issue de Jira (es posible que primero tengas que crear esta etiqueta en tu proyecto de Jira). Devin usará el **playbook predeterminado** para empezar a trabajar en el ticket.

<Note>
  La integración usa coincidencia por límites de palabra (sin distinguir entre mayúsculas y minúsculas), por lo que cualquier etiqueta que contenga **devin** como palabra independiente la activará; por ejemplo, `devin`, `Devin`, `devin-workshop` o `devin-task`. Las etiquetas en las que "devin" forme parte de una palabra más larga, como `devinworkshop` o `devin_workshop`, no la activarán.
</Note>

<div id="mention-devin-in-a-comment">
  ### Menciona a Devin en un comentario
</div>

Menciona a `@Devin` en un comentario del ticket con instrucciones específicas. Devin iniciará una sesión y tomará tu comentario como instrucción para la tarea, sin aplicar un playbook. Si ya existe una sesión para el ticket, tu mensaje se reenviará a esa sesión.

<div id="configuring-the-integration">
  ## Configuración de la integración
</div>

<div id="session-mode">
  ### Modo de sesión
</div>

El interruptor del modo de sesión controla cómo Devin responde a las activaciones de Jira:

* **Creación directa de sesiones** (habilitada de forma predeterminada): Devin crea una sesión completa y trabaja en el ticket, publicando actualizaciones en Jira.
* **Solo definición del alcance** (deshabilitada): Devin solo analiza el ticket y publica un comentario de definición del alcance con un resumen, un plan de implementación y un nivel de confianza estimado. Después, puedes hacer clic en el enlace proporcionado para iniciar una sesión manualmente.

<div id="playbook-labels">
  ### Etiquetas de playbooks
</div>

Las etiquetas de playbooks te permiten controlar qué [playbooks](/es/product-guides/using-playbooks) de Devin están disponibles como etiquetas en Jira. Cuando agregas un playbook, su macro (p. ej., `!plan`) se convierte en una etiqueta que puedes asignar a incidencias de Jira para activar Devin con ese playbook. Las etiquetas deben crearse manualmente en tu proyecto de Jira; copia el nombre de la etiqueta desde la configuración de la integración.

* **Playbook predeterminado**: Un playbook se marca como predeterminado. Cuando una incidencia se activa sin una etiqueta de playbook específica (p. ej., solo con la etiqueta `devin` o al asignar la incidencia a Devin), Devin usa este playbook predeterminado.
* **Agregar playbooks**: Haz clic en "Agregar playbook" para agregar playbooks adicionales. Solo se pueden agregar playbooks que tengan una macro.
* **Eliminar playbooks**: Elimina un playbook para dejar de usar su etiqueta como activador.

<div id="automation-triggers">
  ### Activaciones de automatización
</div>

Las activaciones de automatización permiten que Devin empiece a trabajar automáticamente en tickets cuando coinciden con determinadas condiciones, sin necesidad de asignarlos ni etiquetarlos manualmente. Puedes configurar activaciones según lo siguiente:

* **Projects**: Solo se activan para tickets de proyectos específicos de Jira.
* **Labels**: Solo se activan cuando un ticket tiene etiquetas específicas.
* **Statuses**: Solo se activan cuando un ticket alcanza un estado específico (p. ej., "To Do", "In Progress").
* **Playbook**: Opcionalmente, especifica qué playbook debe usar Devin para la sesión que se active.

Las activaciones usan **detección de transiciones**, lo que significa que solo se activan cuando un ticket pasa de no coincidir a coincidir con las condiciones de la activación (p. ej., cuando se agrega una etiqueta o cambia un estado), y no para tickets que ya coinciden.

<div id="enterprise-jira-project-mapping">
  ### Enterprise: asignación de proyectos de Jira
</div>

En despliegues Enterprise con múltiples organizaciones de Devin, los administradores pueden asignar proyectos de Jira a organizaciones específicas de Devin. Esto garantiza que los tickets de cada proyecto de Jira se dirijan a la organización de Devin correcta. Esta asignación es necesaria para que la integración de Jira funcione en entornos Enterprise.

<div id="interacting-with-devin-in-jira">
  ## Interactuar con Devin en Jira
</div>

Una vez que Devin empieza a trabajar en un ticket, se comunica a través de Jira:

* **Enlaces de PR**: Cuando Devin crea una pull request, la URL de la PR se agrega automáticamente como enlace remoto en el issue de Jira y se publica en un comentario.
* **Enlace de la sesión**: Se proporciona un enlace directo a la sesión de Devin en la aplicación web para que puedas seguir el progreso en tiempo real.
* **Mensajes de seguimiento**: Menciona `@Devin` en un comentario para darle instrucciones adicionales a Devin o hacer preguntas.

<div id="connecting-a-service-account">
  ## Conectar una cuenta de servicio
</div>

Después de conectar Jira con tu cuenta de administrador, también puedes conectar una cuenta de servicio mediante credenciales de cliente de OAuth 2.0. Esto hace que los comentarios de Devin aparezcan con una identidad de bot dedicada en lugar de tu cuenta personal.

1. En la configuración de administración de tu organización de Atlassian, crea una cuenta de servicio de OAuth 2.0 con los siguientes **ámbitos Classic**:
   * `read:me`
   * `read:jira-user`
   * `read:jira-work`
   * `write:jira-work`
2. Asegúrate de que la cuenta de servicio tenga el rol de aplicación **User** para Jira. En [Atlassian Admin](https://admin.atlassian.com), ve a **Directory > Service accounts**, selecciona la cuenta de servicio, haz clic en **⋯ > Allow access** y establece el rol de Jira como **User**. También puedes hacerlo al crear la cuenta de servicio por primera vez. Sin este rol, la cuenta de servicio no podrá acceder a los recursos de Jira.
3. En [Settings > Connections > Jira](https://app.devin.ai/settings/connections/jira), haz clic en **Conectar cuenta de servicio** e introduce el ID de cliente y el secreto de cliente.