Crear comentario en Jira, con una API
Agrega 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.
- Identificador
- jira_create_comment
La llamada
POST https://connect.reportei.com/api/tools/jira_create_comment/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"issueIdOrKey": "<issueIdOrKey>",
"body": {}
}
}Tu sistema envía el id de la conexión de tu cliente y los argumentos de la tool. Los headers son los mismos de toda la API de Connect: el token de tu producto y el token de tu cliente.
Parámetros
Las descripciones de los parámetros siguen la documentación oficial de la app, en inglés.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| issueIdOrKey | string | Sí | Issue id or key, for example KEY-123, from Search issues. |
| body | object | Sí | The comment in Atlassian Document Format, for example {"type": "doc", "version": 1, "content": [{"type": "paragraph", "content": [{"type": "text", "text": "Approved"}]}]}. |
Conexiones posibles
Tu cliente conecta su cuenta de Jira una sola vez, con uno de los modos de abajo. La misma conexión sirve para todas las tools del toolkit.
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.
La respuesta
Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app. Los errores HTTP devueltos por la app usan el objeto {error, api_error}; la autenticación o validación pueden fallar antes de la ejecución. El header X-Toolkit-Execution-Id identifica la ejecución registrada, disponible en GET /api/tools/executions/{uuid}.
Lista para agentes de IA
El input de esta tool es un JSON Schema, disponible en GET /api/tools/jira_create_comment. Se convierte en la definición de tool de tu agente sin conversión.
Otras 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.
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.
