Gestión de proyectos
Jira en tu producto y en tus agentes de IA, con una API
El toolkit de Jira cubre issues, transiciones, comentarios, proyectos, tipos de issue y campos de creación: buscar con JQL, crear y editar issues, moverlas por su flujo de trabajo, comentar y consultar los ids y usuarios asignables que piden otras llamadas. El cliente conecta con las credenciales de su sitio, y tu producto o agente de IA llama a cada operación por un único endpoint de Connect.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/jira_create_issue/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"fields": {}
}
}Cómo funciona
Del cliente conectado a la primera llamada a Jira.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Jira. Recibes el id de la conexión.
- 2
Tu producto llama a la tool
Un POST a /api/tools/{tool}/execute con el id de la conexión y los argumentos. Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app.
- 3
Connect se encarga del resto
Guarda la credencial cifrada, renueva tokens en conexiones OAuth que admiten renovación y registra las ejecuciones en un historial de auditoría disponible por API.
Casos de uso
Qué hace tu producto con Jira.
Tickets desde el feedback
Crea una issue en Jira a partir de un reporte de bug o de una solicitud de soporte en tu producto, con los campos que muestra Listar campos de creación para el proyecto.
Estado sincronizado con tu app
Busca issues por JQL, lee su estado y ejecuta una transición cuando algo termina de tu lado, como mover una issue a Done.
Agente de IA para el seguimiento
Deja que un agente encuentre usuarios asignables, asigne trabajo, comente y liste las transiciones disponibles de una issue antes de moverla.
Tools
13 tools de Jira
- Buscar issuesGETBusca issues con JQL. La consulta debe estar acotada, por ejemplo project = KEY. Solo vuelve el id de la issue, salvo que fields liste qué incluir. Pasa el nextPageToken de la respuesta para leer la página siguiente.
- Obtener issueGETDevuelve una issue por id o clave, con todos los campos navegables, salvo que fields liste qué incluir.
- Crear issuePOSTCrea una issue. fields necesita al menos project, issuetype y summary, y cualquier otro campo debe existir en la pantalla de creación del proyecto, como muestra Listar campos de creación. En esta versión de la API, el campo description recibe un objeto Atlassian Document Format, no texto plano.
- Actualizar issuePUTEdita los campos de una issue: fields define valores, y update aplica operaciones como agregar o quitar un label. Un campo va en fields o en update, nunca en ambos. El estado no cambia aquí: usa Hacer transición de la issue. La respuesta es vacía, status 204, salvo que returnIssue sea true.
- Eliminar issueDELETEElimina una issue. Una issue con subtareas solo se elimina con deleteSubtasks en true, lo que también elimina las subtareas. Requiere el permiso Delete issues en el proyecto. La respuesta es vacía, status 204.
- Listar transicionesGETLista las transiciones que el usuario puede hacer ahora en una issue, cada una con el id que recibe Hacer transición de la issue, su name y el estado al que lleva en to.
- Hacer transición de la issuePOSTMueve una issue a otro estado ejecutando una de sus transiciones. Cuando la transición tiene una pantalla, sus campos obligatorios, como resolution, van en fields o update. La respuesta es vacía, status 204.
- Listar comentariosGETLista los comentarios de una issue, con el cuerpo en Atlassian Document Format. Pagina con startAt y maxResults hasta que startAt más la cantidad devuelta alcance total.
- Crear comentarioPOSTAgrega un comentario a una issue, visible para todos los que pueden ver la issue. Jira notifica a los observadores según el esquema de notificaciones del proyecto. Devuelve el nuevo comentario.
- Listar proyectosGETLista los proyectos que el usuario puede ver, con la key y el id que reciben las herramientas de issues y el JQL. Pagina con startAt y maxResults hasta que isLast sea true.
Usuario y contraseña
Tu cliente ingresa las credenciales de la app en una pantalla de Connect, o tu sistema las envía con POST /api/customer-toolkits, sin pantalla.
Al conectar, tu cliente también indica {site}: la dirección de su cuenta en la API de la app.
Preguntas sobre el toolkit de Jira
¿Necesito implementar la API de Jira?
No. Connect ya trae 13 tools de Jira descritas y listas. Tu cliente conecta la cuenta y tu sistema llama a cada tool por el mismo endpoint, con el mismo formato de solicitud.
¿Cómo conecta mi cliente su cuenta de Jira?
Con el modo que acepta el toolkit: Usuario y contraseña. Connect guarda la credencial cifrada y nunca la devuelve a tu sistema.
¿Funciona con agentes de IA?
Sí. El input de cada tool está descrito en JSON Schema, que tu agente usa directamente como definición de tool. El agente elige la tool y los argumentos, y tu sistema hace la llamada a Connect.
¿Mi cliente necesita una cuenta en Reportei?
No. Tu cliente conecta la cuenta en una pantalla de Connect, o tu sistema envía la credencial por la API, y sigue usando solo tu producto.
Toolkits de la misma categoría
Ver los 100 toolkitsMira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
