Contents:
Webhook configuration
StoriesOnBoard & Jira integration overview
Integrating your story map with a Jira project allows teams to plan more effectively, utilizing the visual power of story mapping to achieve transparency and shared understanding among stakeholders. Bring the team around to the story map to see the big picture and take advantage of real-time and bidirectional sync with Jira to keep everyone up to date at all time. The integration makes it possible to plan releases on the story map and push cards to Jira for execution and keep your backlog in sync.With the powerful integration between StoriesOnBoard and Jira you can build and manage amazing products from the very beginning. This allows to do product discovery with user centric approach to build great products that users love.
Who can setup the Jira integration
You must have Admin role on the story map on StoriesOnBoard to be able to setup the integration with Jira. On the Jira side you must hold Admin rights as well.
How to set up Jira Cloud integration
Click on your user menu
Select the "Jira integration settings" option
Select your Jira site if you have more than one and authenticate
Configure a webhook
Option 1 - Manual webhook configuration
Option 2 - Automatic webhook configuration
Once the webhook is successfully configured you can create your story map and link it to your selected Jira project.
The webhook will enable the real-time and bidirectional integration between your story map and teh Jira project to keep everyone updated.
💡 Tip - Learn more about Setting up Jira integration for your story map
Step-by-step guide to set up Jira Cloud integration
Navigate to your settings then select "Jira integration settings".
Proceed with the "Jira Cloud" option.
Authenticate your account. If you have more than one Jira site, select the one you want to connect to StoriesOnBoard and click on "Accept".
In the next step, you have two options for setting up a webhook:
Option 1 - Manual webhook configuration
Option 2 - Automatic webhook configuration
🤖 Automatic webhook configuration for Jira
If you want to proceed with the automatic webhook configuration, select the "Please set it up for me" option.
Once the webhook is configured, you can move forward to create your story map and connect it to your selected Jira project by following these steps on the story map:
If you wish to setup your webhook manually, keep follow our guide below.
Manual webhook configuration for Jira
To setup the webhook manually, open Jira's Webhook management here.
You will need to create a webhook and follow the instructions on your screen as below:
Once you opened the webhook management in Jira, proceed with the "Create a Webhook" option.
Copy the [ Name ] and [ URL ] from StoriesOnBoard into the relevant webhook fields in Jira.
Then scroll down to find the "Issue related events" section and enable the following fields:
created
updated
deleted
Then scroll further down to find the "Project related events" section and enable the following fields:
created
updated
deleted
To complete the webhook configuration select "Create" at the bottom of the screen.
Now you are ready to move forward to create your story map and connect it to your selected Jira project by following these steps on the story map:
Learn more about: