Join our fully-remote, global team! Build an open-source product that makes  every meeting worthwhile →

GitHub
Sign In
Get Started

Integrations

Contents

Jira
GitHub
Slack
Mattermost

 

How to set up a Parabol-Jira integration

Parabol Jira integration step 1

Select the team you wish to integrate and select 'Settings & Integrations'

Parabol Jira Integration Step 2

From the 'Integrations' tab, select to 'Connect' Atlassian

Parabol Jira Integration Step 3

The Parabol application will open. Select the site you wish to authorize and hit 'Accept'

When you have integrated Parabol and Jira, you will no longer see the 'Connect' button next to Atlassian but the Logo, indicating that the integration is successfulParabol Jira Integration Step 4

 

How to send tasks to Jira from Parabol

From the team page, you will now see the option to integrate your cards via this button on the lower righthand side of each card

Parabol Jira Integration Step 5

Cards that have been successfully ported to Jira will show these arrows in the bottom righthand side.

Parabol Jira Integration Step 6

Cards will then show as issues in Jira. From this point onwards they will be read-only within Parabol, so you can maintain version control in Jira. 

Parabol Jira Integration Step 7

 

How to select Jira stories for estimation

When you have started a Sprint Poker meeting, Parabol will prompt you to import stories from Jira or from within Parabol. 

If you have not yet set up the Jira integration you will see this image:

Parabol-Sprint-Poker-Jira-Integration-Authorization

 

Note that Parabol integrates with Jira Cloud, but not Jira Server. If you'd like to see a Jira Server integration, please let us know. 

To connect your account, simply click "Import stories from Jira" to begin the authentication process. 

Once your Jira account is connected you will have the option to select the stories you wish to import for estimation. You can search for these using basic search or JQL.

This process can be done asynchronously before you begin the meeting with your team.

Parabol-Sprint-Poker-Jira-Integration-Scope

Selected issues will populate on the left hand navigation, creating your meeting agenda. 

 

How to synchronize estimates back to Jira 

During the Sprint Poker meeting your team will estimate effort for the stories you have imported. The facilitator can set the final estimate and choose where to send this in Jira. 

Parabol-Jira-Integration-Sprint-Poker-Estimate

You can set Jira to update any field you choose. Press update to synchronize the changes back to Jira. 

When you open Jira, your estimate will have automatically updated within the appropriate story. 

Parabol-Sprint-Poker-Jira-Estimate-In-Atlassian

 

How to set up a Parabol-GitHub integration

 

Parabol’s GitHub integration lets teams send new tasks directly from Parabol to GitHub. 

To set up this integration head to your team and click on the ‘Settings & Integrations’ button. 

Settings and integrations button in Parabol

Next, click ‘Connect’ to initiate the integration between Parabol and GitHub.

Parabol Slack integration panel

You will now be redirected to an authorization page. 

GITHUB PARABOL AUTHORIZATION

Accept the permissions and your integration should now be connected.

 

How to send tasks to GitHub from Parabol

On individual task cards click the arrow button. A drop-down menu will give the option to port your task to GitHub.

GitHub integration in Parabol

Cards that have been successfully ported to GitHub will have the GitHub Octocat watermark.

 

How to select GitHub Issues for estimation

When you have started a Sprint Poker meeting, Parabol will prompt you to import stories from a variety of sources, including GitHub.

If you have not yet set up the GitHub integration you will see this image:

estimation-github-integration

To connect your account, simply click "Import stories from GitHub" to begin the authentication process. 

Once your GitHub account is connected, you will have the option to select the issues you wish to import for estimation. You can use any GitHub search syntax for this. 

This process can be done asynchronously before you begin the meeting with your team.

estimation-github-issue-searchSelected issues will populate on the left hand navigation, creating your meeting agenda. 

 

How to synchronize estimates back to GitHub 

During the Sprint Poker meeting your team will estimate effort for the stories you have imported. The facilitator can set the final estimate and choose where to send to GitHub as a label or comment. 

Sync estimates back to GitHub

Estimates added to GitHub as comments have a standard look: 

estimation-GitHub-comment-1

Estimates added as labels can be customized: 

estimation-label-options

The wildcard {} character will be replaced by the estimate selected. Facilitators can chose to pre-pend or append this value with helpful text. If a label with this styling exists in GitHub, it will be used. If needed, a new label will be created, using the color of the corresponding card in the deck.

 

How to set up a Parabol-Slack integration

Parabol’s Slack integration allows the meeting facilitator to notify the whole team that a meeting has started by sending a notification in Slack. 

Parabol sends two notifications to Slack:

  1. When a meeting has started 
  2. When a meeting has ended

slack-retrospective-meeting-deadline

Both notifications include a link into the meeting so participants can contribute or review what has already been discussed. 

To set up a Slack integration head to your team and click on the ‘Settings & Integrations’ button. 

Settings and integrations button in Parabol

Next, click ‘Connect’ to initiate the integration between Parabol and Slack.

Parabol Slack integration panel

You will now be redirected to an authorization page.

Authorization of Parabol access to Slack

On this page you can select which thread you would like meeting notifications to be sent to. 

Set your channel for Parabol-Slack integration

Your Slack integration should now be up and running. Next time you start a meeting the team will be notified directly in Slack. 

You can alter your preferences in the same ‘Settings & Integrations’ section of your team. Here you can pause notifications or select which ones you want to be sent to Slack.

Parabol-Slack integration configuration

 

 

How to set up a Parabol-Mattermost integration

Parabol’s Mattermost integration allows the meeting facilitator to send the team and stakeholders meeting reminders and summaries via Mattermost. 


Screenshot 2022-01-07 at 16.40.00

Notifications include a link to the meeting so participants can contribute or review what has already been discussed. 

To set up the Mattermost integration head to the Mattermost channel you want to add the Parabol integration to.

Next, click on Channels and “Integrations,” 

Screenshot 2022-01-11 at 16.32.40

And go to “Incoming Webhooks”.

Screenshot 2022-01-11 at 16.32.48

Then click on the “Add Incoming Webhook” button. 

Screenshot 2022-01-11 at 16.32.55

Give it a name and select the appropriate channel.

Screenshot 2022-01-11 at 16.36.57

Click Save, and you will have a link generated.

Screenshot 2022-01-11 at 16.47.52

Now, go into Parabol, and select the team that you want to add the integration to, and click on 'Settings & Integrations'.

Screenshot 2022-01-11 at 16.51.42

Go to the Mattermost row and click “Connect.”

Screenshot 2022-01-11 at 16.51.53

On the Mattermost Webhook field, paste the link you generated on Mattermost, and click the “Update” button.

Screenshot 2022-01-11 at 16.54.09

 

When you go back to your Mattermost channel, it will show you that the integration was added successfully.

Screenshot 2022-01-11 at 16.58.36

 

Your Mattermost integration is now up and running. Next time you start a meeting the team will be notified directly in Mattermost. 

Enjoy!

Image