Getting started

Install Onit for Jira

Please proceed to the Onit app page in Jira's marketplace and install it from there.

Install Onit for Slack

Once Onit is installed to your Jira, click the Apps button in the top menu and select Onit.

You will be redirected to the Onit app page. If you have not installed Onit for Slack in your Slack workspace yet, the Add to Slack button will be shown. Click it.

You will be forwarded to grant permission for the Onit app to access your Slack workspace.

Read carefully all the permissions required by Onit for Slack and click Allow. After Onit is successfully installed to your Slack workspace, you will be able to configure your stand-up meetings.

Eventual Errors

If you have been redirected to this section after attempting to install Onit for Slack, your installation have failed. If this is not your case, please ignore this section.

Onit for Slack may fail to install due to three main reasons:

1. Onit was not granted permission to be installed on your Slack workspace. In this case, you may try clicking the Add to Slack button in the Onit app page in Jira. If you are not authorized to install apps on your Slack workspace, make sure your Slack Administrator is aware of the installation request.

2. The Add to Slack button was outdated. If your Onit app page in Jira was open for a long time, it is possible that the Add to Slack button lost synchronization with our servers. In this case, refresh the app page in Jira and try it again.

3. There was a communication error between Onit and Slack. If none of the previous options worked, it is possible that either Slack's or our servers lost communication. Please retry at a later moment.

Configure a Stand-up

You have successfully installed Onit to your Slack workspace. Now to configure a stand-up, go to the Onit app page in Jira.

Click Create your first Stand-up. The following form will be displayed:

To add a new stand-up you will need to provide:

• The stand-up name.

• A JQL filter: used to select the Jira issues that will be displayed to each attendee during their update. You may use the JQL Editor to help you write one.

• When it will happen: the time, in a specific timezone, to start and finish a stand-up and which weekdays it should happen. At the start time, Onit will start a private conversation in Slack with each attendee and collect the update. At the end time, Onit will summarize all the updates and share in the specified Slack channel and Reports section in Jira. Each attendee will still be able to edit their updates via Slack after the end time, and the changes will be reflected in the summary.

• A Slack channel: used to post the stand-up summaries.

After you create the stand-up, menu items for Attendees and Questions will apper on the left sidebar.

You can add Jira users as attendees. Onit links Slack users to Jira users through their email address, and will let you know if a Jira user's email cannot be matched to a user in your Slack workspace. You will be given the option to provide a different email for those cases.

A stand-up has a default set of questions that will be asked to each attendee. You can add, edit and re-order them in the Questions page

Navigate back to the Standup list to see your newly configured stand-up

The Actions column gives you options to edit the stand-up or remove it.

Once you are done with the configuration, you're all set. Onit will nudge each team member at the scheduled start time and collect their updates.