rmtsrc / jira2slack-webhook-bridge

Jira to Slack allows you to see realtime Jira updates in your Slack channel

Jira to Slack WebHook Bridge

Allows you to see realtime Jira updates in your Slack channel.

Bridges Jira with Slack by accepting a Jira WebHook request, converting and sending it to the Slack WebHook endpoint.

Setting up in Slack

Visit the Incoming WebHooks page for your team and click Add then select the channel you want the notifications to be sent to and copy the WebHook URL.

Configuration

Add a file in the src/config directory called default.json with the following data, swapping out:

• jiraUrl - base URL of your Jira installation
• PRO - the Jira project project key of the project you want notifications for (normally the first 3 characters of the Jira ticket key)
• slackWebHookUrl - your Slack WebHook URL
• channel - Slack channel you want notifications sent to
• username - (optional) Slack username to display
• icon_emoji - (optional) Slack emoji icon to use

{
  "jiraUrl": "https://jira.example.com",
  "projects": {
    "PRO": {
      "slackWebHookUrl": "https://hooks.slack.com/services/EXAMPLE/KEY",
      "payload": {
        "channel": "#my-example-channel",
        "username": "Jira",
        "icon_emoji": ":ticket:"
      }
    }
  }
}

Setting up in Jira

Assuming you are a Jira Administrator, click: Settings Gear > System > WebHooks > Create a WebHook

• Name: Jira to Slack WebHook Bridge
• Status: Enabled
• URL: http://jira2slack-webhook-bridge.localhost:3000/jira-webhook
• Events:
• created
• updated
• deleted

Starting

docker-compose up or npm start

Running tests

Tested with Node.js v5.6.0 and Jira v7.0.5.

npm install && npm test