Jira-Agent

• •Telegram Bot Token
• •OpenAI API Key

{
  "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": "Erneut versuchen",
      "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": "Issue in Jira Software löschen",
      "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": "Issue in Jira Software aktualisieren",
      "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": "Mehrere Issues in Jira Software1 abrufen",
      "type": "n8n-nodes-base.jiraTool",
      "position": [
        16,
        352
      ],
      "parameters": {
        "options": {},
        "operation": "getAll"
      },
      "typeVersion": 1
    },
    {
      "id": "a47f63fb-6a84-4f04-bae8-c100a9c43494",
      "name": "Issue in Jira Software erstellen",
      "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": "Status eines Issues in Jira Software abrufen",
      "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": "Haftnotiz",
      "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": "Haftnotiz1",
      "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": "'Text' setzen",
      "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": "Aufgabe extrahieren",
      "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": "Textnachricht senden1",
      "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": "'Text' setzen1",
      "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": "Haftnotiz2",
      "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": "Antwort",
      "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": "Haftnotiz3",
      "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": "Haftnotiz4",
      "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": "Haftnotiz6",
      "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": "Haftnotiz7",
      "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": "Haftnotiz5",
      "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
          }
        ]
      ]
    }
  }
}