Agente Jira

• •Bot Token de Telegram
• •Clave de API de OpenAI

{
  "id": "kPEqMYdlMwW08JG1",
  "meta": {
    "instanceId": "b78775038dd0551b144b274015d3475f3d849cef508e40745901d6f4436e7d88",
    "templateCredsSetupCompleted": true
  },
  "name": "JiraAgent",
  "tags": [],
  "nodes": [
    {
      "id": "87eb83d5-fad5-45d1-bc23-3adcff7c8842",
      "name": "OpenAI Chat Model",
      "type": "@n8n/n8n-nodes-langchain.lmChatOpenAi",
      "position": [
        -240,
        192
      ],
      "parameters": {
        "model": "gpt-4o",
        "options": {}
      },
      "typeVersion": 1
    },
    {
      "id": "467060d3-80da-44c3-b52a-a1fb9d78fcd4",
      "name": "Intentar de nuevo",
      "type": "n8n-nodes-base.set",
      "position": [
        672,
        48
      ],
      "parameters": {
        "options": {},
        "assignments": {
          "assignments": [
            {
              "id": "7ab380a2-a8d3-421c-ab4e-748ea8fb7904",
              "name": "response",
              "type": "string",
              "value": "Unable to perform task. Please try again."
            }
          ]
        }
      },
      "typeVersion": 3.4
    },
    {
      "id": "b223b489-de88-412d-92dc-5ce5b5fa9093",
      "name": "Eliminar una incidencia en Jira Software",
      "type": "n8n-nodes-base.jiraTool",
      "position": [
        176,
        352
      ],
      "parameters": {
        "issueKey": "={{ /*n8n-auto-generated-fromAI-override*/ $fromAI('Issue_Key', ``, 'string') }}",
        "operation": "delete"
      },
      "typeVersion": 1
    },
    {
      "id": "9de0b6bf-bc56-4973-b8fd-35643034463d",
      "name": "Actualizar una incidencia en Jira Software",
      "type": "n8n-nodes-base.jiraTool",
      "position": [
        448,
        320
      ],
      "parameters": {
        "issueKey": "={{ /*n8n-auto-generated-fromAI-override*/ $fromAI('Issue_Key', ``, 'string') }}",
        "operation": "update",
        "updateFields": {}
      },
      "typeVersion": 1
    },
    {
      "id": "282dd679-5d62-4b00-b9ab-5686da85fd9e",
      "name": "Jira Agent",
      "type": "@n8n/n8n-nodes-langchain.agent",
      "onError": "continueErrorOutput",
      "position": [
        16,
        -80
      ],
      "parameters": {
        "text": "={{ $json.text }}{{ $json.data }}",
        "options": {
          "systemMessage": "=You are a Jira assistant. Your responsibilities include creating, retrieving, updating, and managing Jira issues such as epics, stories, tasks, and bugs. You can also transition issues to the \"Done\" state.\n\nJira Management Tools\n\nUse \"Create Issue\" to create new tasks, stories, epics, or bugs. Specify the issue type and required fields (e.g., summary, project, and description).\n\nUse \"Get Issue\" to retrieve details about a specific issue. Requires the issue key (e.g., SCRUM-123) or the issue name.\n\nUse \"Update Issue\" to change fields like summary, description, priority, or assignee. Requires the issue key.\n\nUse \"Transition Issue\" to move an issue to another status (e.g., move to \"Done\"). Use \"Get Issue\" first to retrieve the list of available transitions.\n\nUse \"Search Issues\" to find issues using JQL (Jira Query Language). Useful for filtering by assignee, project, status, etc.\n\nFinal Notes\nHere is the current date/time: {{ $now }}\nIf the issue type isn’t specified, default to Story.\nIf transitioning to \"Done\", ensure the issue is in a status that allows that transition."
        },
        "promptType": "define"
      },
      "typeVersion": 1.6
    },
    {
      "id": "c17f65ec-96ba-48a1-abfa-47d6a11aa301",
      "name": "Obtener múltiples incidencias en Jira Software1",
      "type": "n8n-nodes-base.jiraTool",
      "position": [
        16,
        352
      ],
      "parameters": {
        "options": {},
        "operation": "getAll"
      },
      "typeVersion": 1
    },
    {
      "id": "a47f63fb-6a84-4f04-bae8-c100a9c43494",
      "name": "Crear una incidencia en Jira Software",
      "type": "n8n-nodes-base.jiraTool",
      "position": [
        304,
        352
      ],
      "parameters": {
        "project": {
          "__rl": true,
          "mode": "list",
          "value": "10000",
          "cachedResultName": "HumbleTurtle"
        },
        "summary": "={{ /*n8n-auto-generated-fromAI-override*/ $fromAI('Summary', ``, 'string') }}",
        "issueType": {
          "__rl": true,
          "mode": "list",
          "value": "10003",
          "cachedResultName": "Story"
        },
        "additionalFields": {}
      },
      "typeVersion": 1
    },
    {
      "id": "963f8359-9548-4b17-b155-53b39855ae92",
      "name": "Obtener el estado de una incidencia en Jira Software",
      "type": "n8n-nodes-base.jiraTool",
      "position": [
        592,
        240
      ],
      "parameters": {
        "issueKey": "={{ /*n8n-auto-generated-fromAI-override*/ $fromAI('Issue_Key', ``, 'string') }}",
        "operation": "transitions",
        "additionalFields": {}
      },
      "typeVersion": 1
    },
    {
      "id": "73c165c7-3014-41f1-8ed4-186d6efcd9a2",
      "name": "Nota adhesiva",
      "type": "n8n-nodes-base.stickyNote",
      "position": [
        32,
        -512
      ],
      "parameters": {
        "color": 6,
        "width": 248,
        "height": 388,
        "content": "## Jira Agent\nA smart assistant that manages Jira directly from messages from Telegram. Messages are interpreted using Open AI's GPT-4o model.\n\n- Create issues (Story by default): tasks, bugs, epics\n- Get issue details using key or name\n- Update issues: summary, description, priority, assignee\n- Transition issues (e.g., to \"Done\") — only if valid\n- Search issues using JQL for advanced filtering"
      },
      "typeVersion": 1
    },
    {
      "id": "42805ff0-5bc1-446b-8510-55f63fc42059",
      "name": "Nota adhesiva1",
      "type": "n8n-nodes-base.stickyNote",
      "position": [
        112,
        528
      ],
      "parameters": {
        "color": 6,
        "content": "## JIRA actions\n- Get all issues\n- Create new issues\n- Delete issues\n- Update issues\n- Get status of issues"
      },
      "typeVersion": 1
    },
    {
      "id": "0d5fbde7-c305-46ec-ab26-a017743713b5",
      "name": "Telegram Trigger",
      "type": "n8n-nodes-base.telegramTrigger",
      "position": [
        -1024,
        -112
      ],
      "webhookId": "7d8f7ff2-aafe-4356-be63-02628a58816a",
      "parameters": {
        "updates": [
          "message"
        ],
        "additionalFields": {}
      },
      "typeVersion": 1.1
    },
    {
      "id": "2502ad6c-98be-457c-ab58-8022d4a05c74",
      "name": "Establecer 'Texto'",
      "type": "n8n-nodes-base.set",
      "position": [
        -864,
        -112
      ],
      "parameters": {
        "options": {},
        "assignments": {
          "assignments": [
            {
              "id": "fe7ecc99-e1e8-4a5e-bdd6-6fce9757b234",
              "name": "text",
              "type": "string",
              "value": "={{ $json.message.text }}"
            },
            {
              "id": "d5e3a384-033d-44d3-9c74-af9cecf90de1",
              "name": "chat_id",
              "type": "string",
              "value": "={{$json[\"message\"]?.chat?.id}}"
            }
          ]
        }
      },
      "typeVersion": 3.4
    },
    {
      "id": "337ac77d-3e8d-4bac-813b-0b5da3706d45",
      "name": "Extraer tarea",
      "type": "n8n-nodes-base.function",
      "position": [
        -704,
        -112
      ],
      "parameters": {
        "functionCode": "const input = $json[\"text\"]?.toLowerCase().trim() || \"\";\nconst chatId = $json[\"chat_id\"]; // you must ensure chat_id is passed in\n\nif ((input.startsWith(\"create story\"))) {\n  const parts = input.split(\" \");\n  const task = parts.slice(2).join(\" \").trim();\n  return [{\n    json: {\n      task,\n      type: parts[1],\n      chat_id: chatId,\n      should_respond: true,\n      form_prompt: `Let's create a new ${parts[1]}.\\n\\nPlease answer the following:\\n\\nTitle:\\nSummary:\\nDue date (YYYY-MM-DD):\\nDuration (in hours):`,\n      original_message: $json[\"text\"] || \"\"\n    }\n  }];\n}\n\nreturn [{\n  json: {\n    chat_id: chatId,\n    original_message: $json[\"text\"] || \"\",\n    should_respond: false\n  }\n}];\n"
      },
      "typeVersion": 1
    },
    {
      "id": "965604d0-75c4-4e37-8b4e-7eb226eb587a",
      "name": "Enviar un mensaje de texto1",
      "type": "n8n-nodes-base.telegram",
      "position": [
        -352,
        -256
      ],
      "webhookId": "4e5f8113-5694-4872-a69e-cca3d70c843e",
      "parameters": {
        "chatId": "={{ $json.chat_id }}",
        "message": "={{ $json.form_prompt }}",
        "options": {},
        "operation": "sendAndWait",
        "formFields": {
          "values": [
            {
              "fieldLabel": "Title",
              "placeholder": "eg. create health dashboard",
              "requiredField": true
            },
            {
              "fieldLabel": "Summary",
              "placeholder": "eg. should contain the vpv percentage"
            },
            {
              "fieldType": "dropdown",
              "fieldLabel": "Due date",
              "fieldOptions": {
                "values": [
                  {
                    "option": "today"
                  },
                  {
                    "option": "tomorrow"
                  },
                  {
                    "option": "this week"
                  },
                  {
                    "option": "within 2 weeks"
                  },
                  {
                    "option": "this month"
                  },
                  {
                    "option": "this quarter"
                  }
                ]
              },
              "requiredField": true
            },
            {
              "fieldType": "number",
              "fieldLabel": "Duration (in hours)",
              "placeholder": "1",
              "requiredField": true
            }
          ]
        },
        "responseType": "customForm"
      },
      "typeVersion": 1.2
    },
    {
      "id": "f0c799f8-751d-4d98-98c4-76ff67a0091b",
      "name": "If1",
      "type": "n8n-nodes-base.if",
      "position": [
        -544,
        -112
      ],
      "parameters": {
        "options": {},
        "conditions": {
          "options": {
            "version": 2,
            "leftValue": "",
            "caseSensitive": true,
            "typeValidation": "strict"
          },
          "combinator": "and",
          "conditions": [
            {
              "id": "ca74ddb7-495e-4a29-97cc-8d568e16f728",
              "operator": {
                "type": "boolean",
                "operation": "true",
                "singleValue": true
              },
              "leftValue": "={{ $json.should_respond }}",
              "rightValue": "True"
            }
          ]
        }
      },
      "typeVersion": 2.2
    },
    {
      "id": "7547894f-50d0-4ade-b816-b9a3699c3af7",
      "name": "Establecer 'Texto'1",
      "type": "n8n-nodes-base.set",
      "position": [
        -224,
        -80
      ],
      "parameters": {
        "options": {},
        "assignments": {
          "assignments": [
            {
              "id": "fe7ecc99-e1e8-4a5e-bdd6-6fce9757b234",
              "name": "text",
              "type": "string",
              "value": "={{ $json.original_message }}"
            },
            {
              "id": "d5e3a384-033d-44d3-9c74-af9cecf90de1",
              "name": "chat_id",
              "type": "string",
              "value": "={{ $json.chat_id }}"
            },
            {
              "id": "ba588e4a-bbf8-42a7-95a3-600f4bc12aa0",
              "name": "original_message",
              "type": "string",
              "value": "={{ $json.original_message }}"
            },
            {
              "id": "4298249a-f15a-4acf-ac49-72a884247373",
              "name": "data",
              "type": "string",
              "value": "={{ $json.data }}"
            }
          ]
        }
      },
      "typeVersion": 3.4
    },
    {
      "id": "e6f05603-d69d-4241-b56c-7dc881e6a20e",
      "name": "Nota adhesiva2",
      "type": "n8n-nodes-base.stickyNote",
      "position": [
        -1200,
        -1872
      ],
      "parameters": {
        "color": 5,
        "width": 2468,
        "height": 396,
        "content": "# Manage Jira Issues with Natural Language via Telegram and GPT-4o'\n### Overview\nThe Jira Agent is an AI-powered assistant that allows users to interact with Jira directly through messaging platform Telegram. It leverages OpenAI's GPT-4o model to interpret natural language commands and perform various Jira-related actions. On Telegram, it enables users to create Jira stories by triggering a guided form when prompted with \"create story.\" Additionally, it provides more extensive functionality, including creating, updating, searching, and transitioning Jira issues through natural language commands.\n\n### Requirements (*see instructions below for configuration steps*)\nTo use the Jira Agent effectively, users need access to:\n- A Telegram account, Telegram setup involves deploying the bot and starting a chat; story creation is triggered with a simple text command.\n- A connected Jira workspace\n- Permissions to create and modify Jira issue\n- Access to GPT-4o API-key\n\n\n### Setup Time\n<15 minutes"
      },
      "typeVersion": 1
    },
    {
      "id": "8ae99243-df7a-4279-b3c0-8af0f2c48da9",
      "name": "Respuesta",
      "type": "n8n-nodes-base.telegram",
      "position": [
        672,
        -160
      ],
      "webhookId": "ed66661a-5906-45ac-abec-65076da1c8d4",
      "parameters": {
        "text": "={{ $json.output }}",
        "chatId": "={{ $('Telegram Trigger').item.json.message.chat.id }}",
        "additionalFields": {
          "appendAttribution": false
        }
      },
      "typeVersion": 1.2
    },
    {
      "id": "f1639c04-f250-4517-b769-13a93ca257f6",
      "name": "Nota adhesiva3",
      "type": "n8n-nodes-base.stickyNote",
      "position": [
        -1200,
        80
      ],
      "parameters": {
        "color": 6,
        "width": 384,
        "height": 288,
        "content": "## Telegram Messages\n### Normal interaction \nusing messages as \"Please give all my issues\".\n\n### Standardized process of creating stories: \n1. Message: \"create story\"\n2. Open the Form that telegrams responds back to you\n3. Fill in the essential story information in the form\n4. The story automatically gets created in your backlog. "
      },
      "typeVersion": 1
    },
    {
      "id": "a8e099ed-c4aa-4e60-9b74-50012df4a686",
      "name": "Nota adhesiva4",
      "type": "n8n-nodes-base.stickyNote",
      "position": [
        -1200,
        -1456
      ],
      "parameters": {
        "color": 3,
        "width": 816,
        "height": 848,
        "content": "## Configuring the Telegram bot\n### Step 1: Create a New Telegram Bot\n1. Open Telegram and search for @BotFather.\n2. Start a chat and type: /newbot\n3. Follow the prompts:\n    * Give your bot a name (this can be anything).\n    * Choose a username ending in bot (e.g., my_n8n_bot).\n4. BotFather will reply with a Token like this: Use this token to access the HTTP API:\n123456789:ABCDefghIJKlmnoPQRstuVWXYZ1234567890\n5. Save this token — you’ll need it in n8n. \n\n### Step 2: Allow the Bot to Receive Messages\n1. Your bot won’t work until a user (you) sends it a message to “activate” it.\n2. In Telegram, search for your new bot using the username you created (e.g., @my_n8n_bot).\n3. Click Start or send any message (e.g., Hi) to the bot.\n4. This step is required so that Telegram recognizes that the bot is \"in use.\"\n\n### Step 3: Set Up the Telegram Credentials in n8n\n1. Open your n8n instance.\n2. Go to Settings → Credentials or directly to the Telegram Trigger node and click “Create New” under Telegram API.\n3. Fill in the following:\n4. Name: Choose a name like My Telegram Bot.\n5. Bot Token: Paste the token you got from BotFather.\n6. Click Save.\n\n### Step 4: Create the Telegram Trigger Node\n1. In your n8n workflow, add a Telegram Trigger node.\n2. Configure it:\n    - Resource: Message\n    - Operation: Update\n    - Event: Message\n    - Credentials: Select the Telegram credentials you just created.\n\n### Step 5: Activate the Webhook (Important!)\n1. Telegram bots use webhooks, which require an active URL.\n2. To activate the webhook:\n    - Ensure your n8n instance is accessible via HTTPS with a valid public URL.\n    - If testing locally, use ngrok or similar.\n- Activate the workflow by switching the toggle to Active.\n- n8n will automatically register the webhook URL with Telegram.\n\n### Step 6: Test the Bot\n1. In Telegram, send a message to your bot.\n2. You should see the message appear in n8n in the execution logs (or in the connected flow).\n"
      },
      "typeVersion": 1
    },
    {
      "id": "63704731-cba3-4123-9552-a9c6126dba80",
      "name": "Nota adhesiva6",
      "type": "n8n-nodes-base.stickyNote",
      "position": [
        -368,
        -1456
      ],
      "parameters": {
        "color": 3,
        "width": 816,
        "height": 848,
        "content": "## Configuring Jira\n### Step 1: Generate Your Jira API Token (Jira Cloud only)\n1. Go to https://id.atlassian.com/manage/api-tokens\n2. Click Create API token\n3. Give your token a label (e.g., n8n integration)\n4. Click Create, then copy the token shown\n5. Store the token securely — you'll need it in n8n\n\n### Step 2: Create Jira Credentials in n8n\n1. Open your n8n instance\n2. Go to Settings → Credentials or directly open the Jira node and click \"Create New\" under credentials\n3. Choose the appropriate type:\n    - Jira Software (Cloud) → for Atlassian-hosted Jira\n    - Jira Software Server → for self-hosted Jira instances\n\n### Step 3: Add and Configure the Jira Node in Your Workflow\n1. In your n8n workflow (after the Telegram Trigger node), add a Jira node\n2. Choose the Jira Resource and Operation you need:\n    - For creating an issue:\n    Resource: Issue\n    Operation: Create\n    - For updating an issue:\n    Resource: Issue\n    Operation: Update\n3. Select your Jira credentials (created in Step 2)\n\n"
      },
      "typeVersion": 1
    },
    {
      "id": "b1d42508-5d94-4cec-9674-009412b6506e",
      "name": "Nota adhesiva7",
      "type": "n8n-nodes-base.stickyNote",
      "position": [
        464,
        -1456
      ],
      "parameters": {
        "color": 3,
        "width": 816,
        "height": 848,
        "content": "## Setting up OpenAI API access\n### Step 1: Get Your OpenAI API Key\n1. Go to https://platform.openai.com/account/api-keys\n2. Click “Create new secret key”\n3. Give it a name (e.g., n8n-access)\n4. Copy the API key shown (it will look like sk-...)\n5. Save this key securely — you won’t be able to see it again from OpenAI\n\n### Step 2: Add OpenAI Credentials in n8n\n1. Open your n8n instance\n2. Go to Settings → Credentials\n3. Click “New Credential” and select OpenAI\n4. In the credential setup form, enter the following:\n    * Name: (Any friendly name, e.g., My OpenAI API Key)\n    * API Key: Paste the API key you copied in Step 1\n5. Click Save\n\n### Step 3: Add and Configure the Jira Node in Your Workflow\n1. In your n8n workflow (after the Telegram Trigger node), add a Jira node\n2. Choose the Jira Resource and Operation you need:\n    * For creating an issue:\n    Resource: Issue\n    Operation: Create\n    * For updating an issue:\n    Resource: Issue\n    Operation: Update\n3. Select your Jira credentials (created in Step 2)\n\n### Step 4: Review Node Configuration\n1. In the Operation field, confirm what the node is doing:\n    - Chat, Completion, Moderation, etc.\n2. Confirm the Model selected (e.g., gpt-3.5-turbo, gpt-4)\n3. Review the Prompt or Messages section:\n    - Make sure required input is present\n    - If the prompt uses expressions, ensure they reference a valid previous node"
      },
      "typeVersion": 1
    },
    {
      "id": "18fb581d-f779-4b58-b7c1-d441c8cdd5fa",
      "name": "Nota adhesiva5",
      "type": "n8n-nodes-base.stickyNote",
      "position": [
        -1200,
        -576
      ],
      "parameters": {
        "color": 4,
        "width": 2480,
        "height": 1296,
        "content": "\n# Workflow"
      },
      "typeVersion": 1
    }
  ],
  "active": false,
  "pinData": {},
  "settings": {
    "executionOrder": "v1"
  },
  "versionId": "28435f91-fe15-4f0d-aae2-a5afb508c8d4",
  "connections": {
    "f0c799f8-751d-4d98-98c4-76ff67a0091b": {
      "main": [
        [
          {
            "node": "965604d0-75c4-4e37-8b4e-7eb226eb587a",
            "type": "main",
            "index": 0
          }
        ],
        [
          {
            "node": "7547894f-50d0-4ade-b816-b9a3699c3af7",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "282dd679-5d62-4b00-b9ab-5686da85fd9e": {
      "main": [
        [
          {
            "node": "8ae99243-df7a-4279-b3c0-8af0f2c48da9",
            "type": "main",
            "index": 0
          }
        ],
        [
          {
            "node": "467060d3-80da-44c3-b52a-a1fb9d78fcd4",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "2502ad6c-98be-457c-ab58-8022d4a05c74": {
      "main": [
        [
          {
            "node": "337ac77d-3e8d-4bac-813b-0b5da3706d45",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "7547894f-50d0-4ade-b816-b9a3699c3af7": {
      "main": [
        [
          {
            "node": "282dd679-5d62-4b00-b9ab-5686da85fd9e",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "337ac77d-3e8d-4bac-813b-0b5da3706d45": {
      "main": [
        [
          {
            "node": "f0c799f8-751d-4d98-98c4-76ff67a0091b",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "0d5fbde7-c305-46ec-ab26-a017743713b5": {
      "main": [
        [
          {
            "node": "2502ad6c-98be-457c-ab58-8022d4a05c74",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "87eb83d5-fad5-45d1-bc23-3adcff7c8842": {
      "ai_languageModel": [
        [
          {
            "node": "282dd679-5d62-4b00-b9ab-5686da85fd9e",
            "type": "ai_languageModel",
            "index": 0
          }
        ]
      ]
    },
    "965604d0-75c4-4e37-8b4e-7eb226eb587a": {
      "main": [
        [
          {
            "node": "7547894f-50d0-4ade-b816-b9a3699c3af7",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "a47f63fb-6a84-4f04-bae8-c100a9c43494": {
      "ai_tool": [
        [
          {
            "node": "282dd679-5d62-4b00-b9ab-5686da85fd9e",
            "type": "ai_tool",
            "index": 0
          }
        ]
      ]
    },
    "b223b489-de88-412d-92dc-5ce5b5fa9093": {
      "ai_tool": [
        [
          {
            "node": "282dd679-5d62-4b00-b9ab-5686da85fd9e",
            "type": "ai_tool",
            "index": 0
          }
        ]
      ]
    },
    "9de0b6bf-bc56-4973-b8fd-35643034463d": {
      "ai_tool": [
        [
          {
            "node": "282dd679-5d62-4b00-b9ab-5686da85fd9e",
            "type": "ai_tool",
            "index": 0
          }
        ]
      ]
    },
    "c17f65ec-96ba-48a1-abfa-47d6a11aa301": {
      "ai_tool": [
        [
          {
            "node": "282dd679-5d62-4b00-b9ab-5686da85fd9e",
            "type": "ai_tool",
            "index": 0
          }
        ]
      ]
    },
    "963f8359-9548-4b17-b155-53b39855ae92": {
      "ai_tool": [
        [
          {
            "node": "282dd679-5d62-4b00-b9ab-5686da85fd9e",
            "type": "ai_tool",
            "index": 0
          }
        ]
      ]
    }
  }
}