DoIT Shared Tools - JIRA - Microsoft Teams Integration

This document explains how to get JIRA issues recorded in a Mircosoft Teams Channel.

Instructions

For Users

  1. In Teams, select or create a Channel for the JIRA notices to show in.
  2. Click on the "..." icon and select Connectors.
  3. In the connectors channel search for "JIRA Server".
  4. Name it, and on the next screen copy and retain the WebHook URL.
  5. Contact the Shared Tools team at help@doit.wisc.edu and provide the WebHook along with the names of the projects you wish to have reported.
    • Note: The default is for the Webhook to fire on Issue Created/Updated.  That should announce most actions to the channel. For all possible options, see the tables below.
  6. The JIRA Admins will contact you once the steps below have been completed.

For JIRA Super Admin Team

  1. Go to JIRA and select "System" from the cog menu.
  2. Select WebHooks.
  3. Add a new one, and select a good name that identifies it well (Shared Tools-MSTeams)
  4. In Events, add a JQL query to limit the hook to the projects requested (example Project=ST, or limits from an Advanced search)
  5. Save it (don't select "exclude body")

List of Webhook Firing Options

WorklogCreated, updated, deleted
CommentCreated, updated, deleted
IssueCreated, updated, deleted, worklog changed

Project Related Events

ProjectCreated, updated, deleted
VersionReleased, unreleased, created, moved, updated, merged, deleted

User Related Events

UserCreated, updated, deleted

JIRA Configuration Related Events

Voting, watching, unassigned issues, subtasks, attachments, issue links, time tracking

JIRA Software Related Events

SprintCreated, updated, deleted, started, closed
BoardCreated, updated, deleted, configuration changed