Ruby web service to link JIRA tickets to Intercom conversations
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
lib
.gitignore
.ruby-version
Gemfile
Gemfile.lock
Procfile
README.md
Rakefile
app.json
app.rb
config.ru

README.md

JIRA / Intercom Webhook

A Ruby-based web service to connect JIRA tickets and Intercom conversations

Deploy

How it works

  1. Deploy this web service (Heroku is an easy platform)
  2. Add the newly deployed web service as a webhook in your JIRA instance (docs)
  3. Include any Intercom conversation URLs in your JIRA issue descriptions and a private note will be added on the Intercom side

This app works by:

  • Listening for jira:issue_created and jira:issue_updated events
  • Detecting Intercom links in the issue's description and in a comment body
  • Looking up the linked Intercom conversation and checking if the issue link exists
  • If not, adding a private note with a link to the JIRA issue
  • If so, and a comment was created, adding a private note with the new comment

Configuration

When creating the Heroku app:

  • Set the following environment variables:
# API key for your Intercom account
INTERCOM_API_KEY

# notes added by the webhook will be attributed to this user in Intercom
INTERCOM_ADMIN_ID

# hostname for your JIRA instance e.g. companyxyz.atlassian.net
JIRA_HOSTNAME
  • And the following environment variables will be set automatically to random strings of characters:
# username used for HTTP Basic Auth
APP_USERNAME

# password used for HTTP Basic Auth
APP_PASSWORD

After creating Heroku app