ConfigurarIntegraciones

Jira

Conecta tus agentes de ElevenLabs con Jira Cloud

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

FuncionalidadCompatibilidad
Modo de retención cero (ZRM)No compatible
Archivos adjuntos en herramientasNo 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.

1

Genera un token de API

Ve a la gestión de tokens de API de Atlassian y haz clic en Create API token. Copia el token: no podrás volver a verlo.

2

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.

3

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

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 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.

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

1

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.

2

Recopilar detalles

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

3

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.

4

Confirmar con quien llama

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

Ejemplo de prompt de sistema

# 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

HerramientaDescripción
jira_create_issueCrea una incidencia con proyecto, resumen, tipo de incidencia y campos opcionales como la prioridad.
jira_get_issueObtiene los detalles de una incidencia específica mediante su clave.
jira_search_issuesBusca incidencias por etiqueta, proyecto, estado, prioridad, tipo, persona asignada, texto o intervalo de fechas.
jira_update_issueActualiza campos de una incidencia existente: prioridad, persona asignada, etiquetas o descripción.
jira_add_commentAñade un comentario de texto sin formato a una incidencia.
jira_get_transitionsEnumera las transiciones de flujo de trabajo disponibles para una incidencia.
jira_transition_issueMueve una incidencia a un nuevo estado de flujo de trabajo mediante un ID de transición de jira_get_transitions.
jira_link_issuesVincula dos incidencias (por ejemplo, “Blocks”, “Duplicate”, “Relates”).
jira_list_projectsEnumera los proyectos disponibles y sus claves.
jira_get_issue_typesEnumera los tipos de incidencia disponibles (por ejemplo, Bug, Task, Story).
jira_get_prioritiesEnumera los niveles de prioridad disponibles.

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