What to know:
Adding the bot to your channel(s)
...
...
Jira Integration+ bots can be added to public or private channels.
Jira Integration+ bots can be added to public or private channels.
Use one of the following ways to add Jira Integration+ to your channel:
Mention
...
@Jira will add the bot as an app to the channel.
Invite them
...
using the Slack
...
/invite
...
command.
Add the bot with the
...
Add
...
App Slack channel feature.
Important: Once the bot is added, you will see the following confirmation message:
Accessing your bot's configuration
...
There are 3 convenient ways to access a
...
channel bot configuration.
Click the
...
Configure
...
button that is displayed when you first add a bot to a channel.
Type
...
jira configure
...
as a message into the channel you want to configure.
Type the
...
/jira-plus configure
...
message into the channel you want to configure.
Configuring your bot
The following configuration options are for channels, not personal notifications.
You are not required to configure your bot, but doing so will unleash its full power.
Configure Notifications
Click the
...
Configure
...
button to access your channel's notification options.
The following options are available for channel notification configuration:
...
Projects, Issue Types, and Priority
Start typing in each control. The bot will respond with suggestions based on the text you enter.
You can select multiple projects, issue types, and priorities. The bot will monitor Jira and generate notifications based on these channel settings.
Advanced Features
Click the "Advanced Settings" button to toggle to JQL
...
mode.
...
The following view allows
...
granular control with JQL syntax.
You can enter any valid JQL syntax into the first text box.
...
Ignore specific user updates
This control allows you to enter user values to ignore.
If the user set here adds an update in Jira, they will be
...
ignored, and no notification will be sent to this channel.
Issue Transitions
This control allows notifications based on issues transitioned between Jira status values.
Note: The following sections are based
...
on the base notification settings.
Click individual Jira actions under "Notify channel when..." that this channel's bot should react to.
...
Select Delivery Frequency
You can configure the channel's bot to respond to Jira actions individually
...
, immediately, or
...
at intervals. Interval settings allow
...
messages to be bundled and displayed together.
Set Output Location
You can control where the channel displays bot notifications. Either directly in the channel
...
or in a daily consolidated thread.
...
When the location is set to channel, any notification is displayed directly in the configured slack channel.
When set to thread mode, the bot creates a daily thread message and
...
updates the summary information
...
when notifications are triggered.
...
Save your settings, and your new notifications will start
...
in thread mode.
Note: In thread mode, the thread notification
...
won't
...
appear in everyone's Slack window, so your team
...
must look at the thread to see your updates. This is how Slack works with threads, so make sure to balance space with the importance of ensuring everyone sees the update.
Output Format
You can configure the bot-message format to be one of the following:
Note: "Standard" is the default channel message format.
Quick Create Settings
Click the "Configure" button from the main channel configuration screen to access quick create settings
...
Additional Settings - Enable User Override
If not all
...
Slack users have a corresponding Jira user, you can set the channel to create Jira tickets
...
for a specific designated user.
...
Click "Authorize with Jira" to authenticate your individual Jira account
...
and create tickets for every user in the channel.
...
Click "Allow" to authorize your Jira Integration+ bot to access your Jira instance.
Once saved, you can reset this configuration at any time.
Removing a bot from a channel
Use one of the following ways to remove the Jira Integration+ from your channel:
Use the "/remove" or "/kick" command.
