How to Use Jira Server Notifications

Through Zoom’s Jira Server Notifications integration, you will be able to keep track of your Jira account’s updates and changes from a chat application while receiving Zoom Chat notifications and messages.

There are several conditions that need to be met before Jira Server Notifications will work

  • An account owner or an administrator has the following privileges:
  • An account that is either free or paid by Zoom
  • An account that is an administrator for Jira

How to install and configure Jira Server Notifications

Install from the Zoom App Marketplace

  1. As an administrator, you should log into your Zoom account.
  2. After signing into your Zoom account, you will see the Marketplace for Zoom apps.
    Note:
  3.  Chatbots can only be installed by admins.
  4. Enter Jira Server in the search box located at the top right corner of your screen to find the app.
  5. Search for Jira Server Notifications in your search result list and click on it if you find it.
    Note:
  6. Make sure that the app is pre-approved if it is not already so.
  7. Click the Add button.
  8. Once you have confirmed what permissions the app requires, click Allow.

Note: Your Zoom desktop client will automatically be installed when your admin has installed the Jira Server Notifications chatbot. If your admin has installed the chatbot, you can use it right away.

It is important that an account administrator on your Jira Server account completes the steps below.

Configure the integration from Jira Server

Authenticate the Jira Server Notifications app

When you install the app from the Zoom App Marketplace, you will be redirected to the Zoom Page after you have installed it.

In the Jira Server chat app, you should be able to open the Zoom desktop client.

Configure the Jira Server subscription

Note:

There are several steps that you will have to complete in order to receive Jira Server notifications in each channel that you want. Furthermore, only Jira admin or someone with the appropriate permissions will be able to implement the Jira webhook for this integration. If this issue still persists, contact your Jira admin so we can resolve the issue.

  1. Make sure you are logged into your Zoom chat.
  2. Then type /jiras connect in a desired group chat.
    This can also be done with the 1:1 Jira Server app by typing connect.
  3. This will force the app to respond after which you will need to click Add Configuration.
    The Jira Server configuration window will open after clicking Add Configuration.
  4. To configure the adapter and get the project key, please complete Step 1 if you are a Jira Administrator. (The project prefix is where you get the project key). For how to configure, click How to configure SuperWebhook ?.
    Note: The first step can be ignored if you are not an administrator of Jira. Select the adapter you would like to use by checking the box, then choosing the adapter.
  5. If you add a name to the notification, you will be able to easily see the Jira Server subscription from which the notification originated.
  6. If you want to focus on a specific project key, you can do so; otherwise, the notification will not be filtered.
  7. If you are not a Jira Server administrator, please ensure that your adapter folder is checked, and then select your adapter.
    Please refer to How to configure SuperWebhook for how to use the adapter URL.
  8. Please complete the rest of the configuration and choose the notifications that you would like to receive.
  9. Click on the Save button.
    Now you will start receiving notifications related to your configuration on Zoom chat.

How to interact with the Jira Server Chatbot

When the Jira Server subscription is triggered, you will soon begin receiving chat notifications in your inbox. You will be able to receive these messages in the Zoom channel assigned to the subscription.

There is also the option to interact with the chatbot in a 1:1 conversation. For a full list of possible commands that you can enter by typing and sending /help (in the 1:1 channel) or /jiras help (in any other chat channel).

How to remove the Jira Server Chatbot

  1. As the account administrator, you need to log into the Zoom App Marketplace.
  2. From the menu on the top right, select Manage to open the Management page.
  3. Click the Added Apps link in the navigation menu.
  4. Next, click the Remove icon next to Jira Server Notifications.
  5. When the dialog box appears, click Remove.

Please submit a ticket if you need further assistance or technical support.

Data security

  • There are a number of information that Zoom can access through this app:
    • Zoom users can view all channels to which they have subscribed.
    • Zoom users can also view details about themselves.
  • Using this app, you will be able to access the following Jira information:
    • Nothing – no access is required.
  • You will need to grant the following permissions to the Zoom chat app:
    • You will be able to send chat messages to IM channels or Zoom groups from the Zoom chat app.
  • Jira and this Zoom chat app communicate over an encrypted channel:
    • TLS 1.2 is the protocol of choice
  • The following information is stored in an encrypted database by the Zoom chat app:
    • Credentials for Zoom OAuth (at the level of the user).
    • Information on Jira issues: Project Name, Project Key, Status, Issue Type, Priority, AccountID, DisplayName.
  • Information on Jira issues: Project Name, Project Key, Status, Issue Type, Priority, AccountID, DisplayName.
  • This Jira bot automatically deletes information from Jira cases and issues such as: Project name, project key, status, issue type, priority, account ID and display name when uninstalled from the marketplace.
    • Information about Jira issues: Project Name, Project Key, Status, Issue Type, Priority, AccountId, DisplayName.
    • Information about Zoom authorization: Access token.
    • The following information is required to configure the bot: Jira configuration, Project key, Priority, and Webhook URL.