> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Jira

## Descripción general

Conecta tus agentes de IA de ElevenLabs con Jira Cloud para gestionar incidencias, seguir proyectos y automatizar flujos de trabajo de soporte. Esta integración permite a tus agentes crear y actualizar incidencias, moverlas por los flujos de trabajo, vincular tickets relacionados para escalarlos y buscar en todos los proyectos.

## Funcionalidades

| Funcionalidad                     | Compatibilidad                                           |
| --------------------------------- | -------------------------------------------------------- |
| Modo de retención cero (ZRM)      | No compatible                                            |
| Archivos adjuntos en herramientas | No compatible: las herramientas solo funcionan con texto |

## Configuración

Esta integración utiliza un **token de API de Jira** con autenticación básica. Necesitas el correo electrónico de tu cuenta de Atlassian, un token de API y el subdominio de Jira Cloud.

#### Genera un token de API

Ve a la [gestión de tokens de API de Atlassian](https://id.atlassian.com/manage-profile/security/api-tokens) y haz clic en **Create API token**. Copia el token: no podrás volver a verlo.

#### Busca tu subdominio de Jira

Tu subdominio es la primera parte de la URL de Jira Cloud. Por ejemplo, si tu Jira está en `mycompany.atlassian.net`, tu subdominio es `mycompany`.

#### Conéctalo en ElevenLabs

En la configuración de la integración de ElevenLabs, introduce:

* **Email**: el correo electrónico de tu cuenta de Atlassian
* **API Token**: el token que generaste en el paso 1
* **Jira Subdomain**: tu subdominio del paso 2

> **Note**
>
> Los tokens de API caducan después de un año de forma predeterminada. Si tu agente deja de poder acceder a Jira,
> genera un token nuevo y actualiza la conexión.

## Identificar a quienes llaman

La herramienta `jira_search_issues` requiere un parámetro `labels` para limitar las búsquedas a los tickets de un usuario específico. Esto supone que tu flujo de trabajo de Jira aplica una etiqueta a cada incidencia que identifica a quien llama; por ejemplo, convertir un correo como `jane.smith@example.com` en una etiqueta como `jane-smith-at-example-com`.

Para automatizarlo, configura el campo `labels` como una [variable dinámica](/docs/es/eleven-agents/customization/personalization/dynamic-variables) que reciba el identificador de quien llama desde tu aplicación. Así, el agente no tendrá que pedir el correo electrónico en cada llamada.

> **Note**
>
> Las etiquetas de Jira no pueden contener espacios. Una convención habitual es sustituir `@` por `-at-` y `.` por
> `-` (por ejemplo, `jane-smith-at-example-com`). La herramienta `jira_search_issues` busca coincidencias exactas con la etiqueta,
> por lo que el valor proporcionado debe coincidir con la etiqueta de la incidencia.

## Cómo funciona

#### Creación de tickets de soporte

#### Identificación de quien llama

El agente identifica a quien llama mediante su dirección de correo electrónico u otro identificador configurado en el
campo labels.

#### Recopilar detalles

El agente recopila información sobre la incidencia de quien llama: qué ha ocurrido, la gravedad
y cualquier contexto relevante.

#### Crear la incidencia

El agente crea una incidencia de Jira en el proyecto adecuado con el tipo de incidencia,
la prioridad y la descripción correctos.

#### Confirmar con quien llama

El agente lee el número del ticket creado para que quien llama tenga una referencia para el seguimiento.

#### Resolución de mesa de servicio

#### Buscar el ticket

El agente recupera una incidencia de Jira mediante su clave (por ejemplo, PROJ-123) y lee el
estado, la prioridad y el resumen actuales.

#### Añadir notas de resolución

El agente añade un comentario a la incidencia con detalles de la conversación, como los pasos
realizados o la información recopilada.

#### Cerrar el ticket

El agente mueve la incidencia a un estado resuelto o cerrado mediante las transiciones de flujo de trabajo
disponibles.

## Ejemplo de prompt de sistema

#### Ver ejemplo de prompt de sistema

```text
# Personality

You are a helpful IT support agent responsible for managing support tickets in Jira. Be friendly, professional, and efficient.

# Environment

You operate in a support setting via voice or chat, where you help users report issues, check ticket status, and manage existing requests.

# Tone

Begin by asking how you can help. If the caller has an existing issue, ask whether they have the ticket number. If they are reporting a new issue, collect details about the problem.

Ask one question at a time and wait for the response before proceeding.

# Goal

For new issues:
- Collect a clear description of the problem
- Determine severity and urgency
- Create the ticket in the appropriate project with the right issue type and priority
- Read back the ticket number

For existing issues:
- If the caller provides a ticket number, look it up by key
- If the caller wants to check on their issues, search using the labels field
- Provide status updates
- Add comments or update priority when requested
- Always confirm before making changes

# Guardrails

- Do not discuss topics outside of IT support.
- Never expose raw Jira API responses, internal IDs, or technical field names to the caller.
- Always confirm with the caller before creating, updating, or transitioning issues.
```

## Herramientas disponibles

| Herramienta             | Descripción                                                                                                        |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------ |
| `jira_create_issue`     | Crea una incidencia con proyecto, resumen, tipo de incidencia y campos opcionales como la prioridad.               |
| `jira_get_issue`        | Obtiene los detalles de una incidencia específica mediante su clave.                                               |
| `jira_search_issues`    | Busca incidencias por etiqueta, proyecto, estado, prioridad, tipo, persona asignada, texto o intervalo de fechas.  |
| `jira_update_issue`     | Actualiza campos de una incidencia existente: prioridad, persona asignada, etiquetas o descripción.                |
| `jira_add_comment`      | Añade un comentario de texto sin formato a una incidencia.                                                         |
| `jira_get_transitions`  | Enumera las transiciones de flujo de trabajo disponibles para una incidencia.                                      |
| `jira_transition_issue` | Mueve una incidencia a un nuevo estado de flujo de trabajo mediante un ID de transición de `jira_get_transitions`. |
| `jira_link_issues`      | Vincula dos incidencias (por ejemplo, "Blocks", "Duplicate", "Relates").                                           |
| `jira_list_projects`    | Enumera los proyectos disponibles y sus claves.                                                                    |
| `jira_get_issue_types`  | Enumera los tipos de incidencia disponibles (por ejemplo, Bug, Task, Story).                                       |
| `jira_get_priorities`   | Enumera los niveles de prioridad disponibles.                                                                      |

> **Note**
>
> Las descripciones y los comentarios de incidencias solo admiten texto sin formato. La integración los convierte automáticamente al
> formato de documento Atlassian (ADF) de Jira. Markdown y HTML no son compatibles.

## Enlaces útiles

* [Documentación de la API REST de Jira Cloud](https://developer.atlassian.com/cloud/jira/platform/rest/v3/)
* [Gestionar tokens de API](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/)