{"_id":"590a04f9ed80861900cbc7c3","user":"55b2d5626862a10d00887af9","version":{"_id":"590a04f2ed80861900cbc737","project":"55b2d5baa74a380d00e290c4","__v":4,"createdAt":"2017-05-03T16:27:30.085Z","releaseDate":"2017-05-03T16:27:30.085Z","categories":["590a04f3ed80861900cbc738","590a04f3ed80861900cbc739","590a04f3ed80861900cbc73a","590a04f3ed80861900cbc73b","590a04f3ed80861900cbc73c","590a04f3ed80861900cbc73d","590a04f3ed80861900cbc73e","590a04f3ed80861900cbc73f","590a04f3ed80861900cbc740","590a04f3ed80861900cbc741","590a04f3ed80861900cbc742","590a04f3ed80861900cbc743","590a04f3ed80861900cbc744","590a04f3ed80861900cbc745","590a04f3ed80861900cbc746","590a04f3ed80861900cbc747","590a04f3ed80861900cbc748","590a04f3ed80861900cbc749","590a04f3ed80861900cbc74a","590a04f3ed80861900cbc74b","590a04f3ed80861900cbc74c","590a04f3ed80861900cbc74d","59124949de13f61900336a7a","5914b04e7c2c552d008b7104","5914b47242c6a22300b9dc20"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"7.0.0","version":"7"},"__v":0,"project":"55b2d5baa74a380d00e290c4","category":{"_id":"590a04f3ed80861900cbc748","version":"590a04f2ed80861900cbc737","project":"55b2d5baa74a380d00e290c4","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-09-30T19:22:34.349Z","from_sync":false,"order":18,"slug":"integrations-and-notifications","title":"Integrations and Notifications"},"parentDoc":null,"updates":["563b7724dfa1282b000dd2aa"],"next":{"pages":[],"description":""},"createdAt":"2015-09-30T22:40:10.116Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":6,"body":"JIRA is a powerful issues and project tracker used by a lot of agile teams. Buddybuild can be configured to automatically open a JIRA issue for each piece of feedback and crash report you receive on your app.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"You can read more about it here: [OAuth security for application links](https://confluence.atlassian.com/display/APPLINKS/OAuth+security+for+application+links)\",\n  \"title\": \"How to grant permissions for the API?\"\n}\n[/block]\nStart by launching the buddybuild dashboard and clicking on **App Settings**.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/d6639ab-Builds_-_Settings.png\",\n        \"Builds - Settings.png\",\n        1500,\n        483,\n        \"#ecf1f2\"\n      ]\n    }\n  ]\n}\n[/block]\nIn the left navigation, select **Integrations**, then **JIRA Issues**.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/75c6789-Settings_-_JIRA_Issues_-_menu.png\",\n        \"Settings - JIRA Issues - menu.png\",\n        1500,\n        800,\n        \"#2983d5\"\n      ]\n    }\n  ]\n}\n[/block]\nEnter your **JIRA base URL** in the specified field. Take note of your **Consumer key**, **Public key** and **Consumer callback URL,** as you'll need it for the next step.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/63ed25a-Settings_-_Jira_Issues_-_1.png\",\n        \"Settings - Jira Issues - 1.png\",\n        1500,\n        800,\n        \"#e8eeee\"\n      ]\n    }\n  ]\n}\n[/block]\n\n## Edit your JIRA Application Configuration\nOpen JIRA in a new tab. Click on the **Settings** icon and select **Applications.** \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/bc908d0-Settings_-_Jira_Issues_-_2.png\",\n        \"Settings - Jira Issues - 2.png\",\n        1500,\n        800,\n        \"#30629a\"\n      ]\n    }\n  ]\n}\n[/block]\n##Create a New Application Link\n\nIn the left navigation, click on **Application links**. Next, copy the dashboard URL below into the Application URL field and click on **Create New Link**.\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"What if I have multiple JIRA integrations with buddybuild?\",\n  \"body\": \"You can append your app id to the url, e.g.:\\n\\nhttps://dashboard.buddybuild.com/57acc935dfda60010066a000\"\n}\n[/block]\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"https://dashboard.buddybuild.com\",\n      \"language\": \"xml\"\n    }\n  ]\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/a3c036e-Settings_-_Jira_Issues_-_3.png\",\n        \"Settings - Jira Issues - 3.png\",\n        1500,\n        800,\n        \"#e8e8e9\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\n##Click Continue\n\nIgnore the warning and click Continue.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/386c10e-Settings_-_Jira_Issues_-_4.png\",\n        \"Settings - Jira Issues - 4.png\",\n        1500,\n        800,\n        \"#828384\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\n##Enter App Name and Continue\n\nUse **buddybuild** as the Application Name. A new Application Link will be created.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/2ed253a-Settings_-_Jira_Issues_-_5.png\",\n        \"Settings - Jira Issues - 5.png\",\n        1500,\n        688,\n        \"#818282\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\n\n##Edit the Application Link\n\nEdit the newly created application link.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/5494300-Settings_-_Jira_Issues_-_6.png\",\n        \"Settings - Jira Issues - 6.png\",\n        1500,\n        674,\n        \"#234c7c\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\n##Configure the Incoming Authentication\nNavigate to the Incoming Authentication Section.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/409d972-Settings_-_Jira_Issues_-_7.png\",\n        \"Settings - Jira Issues - 7.png\",\n        1500,\n        491,\n        \"#818283\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\n##Paste in your Keys and CallbackURL\n\nBuddybuild will generate your Public Key, your Consumer Key and the Consumer callback URL. Navigate to buddybuild, copy the above items from the JIRA Issues settings page and paste them into your JIRA Application.\n\nUse **buddybuild** as the consumer name.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/82abb36-Settings_-_Jira_Issues_-_8.png\",\n        \"Settings - Jira Issues - 8.png\",\n        1500,\n        513,\n        \"#848484\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\n## Navigate back to buddybuild and hit Connect\n\nNow that you have JIRA configured, head back over to buddybuild and click on **Connect JIRA account.** \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/5bdf30a-Settings_-_Jira_Issues_-_9.png\",\n        \"Settings - Jira Issues - 9.png\",\n        1500,\n        865,\n        \"#364d5e\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\n##Authorize buddybuild to connect to your JIRA\n\nClick on the **Allow** button.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/3a53ca6-Settings_-_Jira_Issues_-_10.png\",\n        \"Settings - Jira Issues - 10.png\",\n        1500,\n        800,\n        \"#f7f7f7\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\n## Select your JIRA Project and Issue Type\n\nNext, configure JIRA for Feedback and Crash Reports.  You can automatically create issues, and set the default **project**, **type** and **assignee** for new issues.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/7ae4850-Settings_-_Jira_Issues_-_11.png\",\n        \"Settings - Jira Issues - 11.png\",\n        1500,\n        865,\n        \"#e4ebed\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\nThat's it! Buddybuild is now connected to your JIRA. We will automatically create an issue for every piece of feedback you receive.","excerpt":"","slug":"jira","type":"basic","title":"JIRA"}
JIRA is a powerful issues and project tracker used by a lot of agile teams. Buddybuild can be configured to automatically open a JIRA issue for each piece of feedback and crash report you receive on your app. [block:callout] { "type": "info", "body": "You can read more about it here: [OAuth security for application links](https://confluence.atlassian.com/display/APPLINKS/OAuth+security+for+application+links)", "title": "How to grant permissions for the API?" } [/block] Start by launching the buddybuild dashboard and clicking on **App Settings**. [block:image] { "images": [ { "image": [ "https://files.readme.io/d6639ab-Builds_-_Settings.png", "Builds - Settings.png", 1500, 483, "#ecf1f2" ] } ] } [/block] In the left navigation, select **Integrations**, then **JIRA Issues**. [block:image] { "images": [ { "image": [ "https://files.readme.io/75c6789-Settings_-_JIRA_Issues_-_menu.png", "Settings - JIRA Issues - menu.png", 1500, 800, "#2983d5" ] } ] } [/block] Enter your **JIRA base URL** in the specified field. Take note of your **Consumer key**, **Public key** and **Consumer callback URL,** as you'll need it for the next step. [block:image] { "images": [ { "image": [ "https://files.readme.io/63ed25a-Settings_-_Jira_Issues_-_1.png", "Settings - Jira Issues - 1.png", 1500, 800, "#e8eeee" ] } ] } [/block] ## Edit your JIRA Application Configuration Open JIRA in a new tab. Click on the **Settings** icon and select **Applications.** [block:image] { "images": [ { "image": [ "https://files.readme.io/bc908d0-Settings_-_Jira_Issues_-_2.png", "Settings - Jira Issues - 2.png", 1500, 800, "#30629a" ] } ] } [/block] ##Create a New Application Link In the left navigation, click on **Application links**. Next, copy the dashboard URL below into the Application URL field and click on **Create New Link**. [block:callout] { "type": "warning", "title": "What if I have multiple JIRA integrations with buddybuild?", "body": "You can append your app id to the url, e.g.:\n\nhttps://dashboard.buddybuild.com/57acc935dfda60010066a000" } [/block] [block:code] { "codes": [ { "code": "https://dashboard.buddybuild.com", "language": "xml" } ] } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/a3c036e-Settings_-_Jira_Issues_-_3.png", "Settings - Jira Issues - 3.png", 1500, 800, "#e8e8e9" ], "sizing": "full" } ] } [/block] ##Click Continue Ignore the warning and click Continue. [block:image] { "images": [ { "image": [ "https://files.readme.io/386c10e-Settings_-_Jira_Issues_-_4.png", "Settings - Jira Issues - 4.png", 1500, 800, "#828384" ], "sizing": "full" } ] } [/block] ##Enter App Name and Continue Use **buddybuild** as the Application Name. A new Application Link will be created. [block:image] { "images": [ { "image": [ "https://files.readme.io/2ed253a-Settings_-_Jira_Issues_-_5.png", "Settings - Jira Issues - 5.png", 1500, 688, "#818282" ], "sizing": "full" } ] } [/block] ##Edit the Application Link Edit the newly created application link. [block:image] { "images": [ { "image": [ "https://files.readme.io/5494300-Settings_-_Jira_Issues_-_6.png", "Settings - Jira Issues - 6.png", 1500, 674, "#234c7c" ], "sizing": "full" } ] } [/block] ##Configure the Incoming Authentication Navigate to the Incoming Authentication Section. [block:image] { "images": [ { "image": [ "https://files.readme.io/409d972-Settings_-_Jira_Issues_-_7.png", "Settings - Jira Issues - 7.png", 1500, 491, "#818283" ], "sizing": "full" } ] } [/block] ##Paste in your Keys and CallbackURL Buddybuild will generate your Public Key, your Consumer Key and the Consumer callback URL. Navigate to buddybuild, copy the above items from the JIRA Issues settings page and paste them into your JIRA Application. Use **buddybuild** as the consumer name. [block:image] { "images": [ { "image": [ "https://files.readme.io/82abb36-Settings_-_Jira_Issues_-_8.png", "Settings - Jira Issues - 8.png", 1500, 513, "#848484" ], "sizing": "full" } ] } [/block] ## Navigate back to buddybuild and hit Connect Now that you have JIRA configured, head back over to buddybuild and click on **Connect JIRA account.** [block:image] { "images": [ { "image": [ "https://files.readme.io/5bdf30a-Settings_-_Jira_Issues_-_9.png", "Settings - Jira Issues - 9.png", 1500, 865, "#364d5e" ], "sizing": "full" } ] } [/block] ##Authorize buddybuild to connect to your JIRA Click on the **Allow** button. [block:image] { "images": [ { "image": [ "https://files.readme.io/3a53ca6-Settings_-_Jira_Issues_-_10.png", "Settings - Jira Issues - 10.png", 1500, 800, "#f7f7f7" ], "sizing": "full" } ] } [/block] ## Select your JIRA Project and Issue Type Next, configure JIRA for Feedback and Crash Reports. You can automatically create issues, and set the default **project**, **type** and **assignee** for new issues. [block:image] { "images": [ { "image": [ "https://files.readme.io/7ae4850-Settings_-_Jira_Issues_-_11.png", "Settings - Jira Issues - 11.png", 1500, 865, "#e4ebed" ], "sizing": "full" } ] } [/block] That's it! Buddybuild is now connected to your JIRA. We will automatically create an issue for every piece of feedback you receive.