Documentation
  • Overview
  • Atlassian Cloud
    • Intercom for Jira Cloud
      • Get started
      • Guides
        • Jira administrators
          • Setting up
          • Managing app features
          • Managing notifications
            • Configuring notifications on issue updates
            • Configuring notifications for specific issue transitions
          • Managing visible Intercom data fields
          • Managing the Intercom app configuration
          • Configuring the app user
          • Revoking Intercom connection
          • Reconnecting broken Intercom connection
        • Jira users
          • Managing Intercom conversation links
          • Inspecting linked Intercom conversations
          • Commenting linked Intercom conversations
          • Searching and reporting
      • Concepts
        • App workflow
      • Forge migration
      • Announcements
      • FAQ
    • Travis CI integration for Jira
      • Getting Started
      • FAQ
  • Atlassian self-hosted
    • Intercom for Jira Data Center/Server
      • Get started
      • Guides
        • Jira administrators
          • Setting up
          • Managing Jira app features
          • Managing Intercom app features
          • Managing notifications
            • Configuring notifications on issue updates
            • Configuring notifications for specific issue transitions
          • Managing visible Intercom data fields
          • Revoking Intercom connection
          • Migrating to Intercom for Jira Cloud
        • Jira users
          • Linking Intercom conversations
          • Inspecting linked Intercom conversations
          • Commenting linked Intercom conversations
          • Searching and reporting
        • Intercom teammates
          • Adding the app to Inbox
          • Creating new Jira issues
          • Linking existing Jira issues
          • Managing linked Jira issues
      • Security Statement
      • FAQ
  • Intercom
    • Jira Cloud for Intercom
      • Get started
      • Guides
        • Intercom administrator
          • Setting up
          • Managing fields on the create issue form
          • Inspecting app information
          • Managing the Intercom app configuration
          • Changing the Intercom app user
          • Restricting app access
          • Uninstalling the app
        • Intercom teammates
          • Adding the app to Inbox
          • Creating new Jira issues
          • Linking existing Jira issues
          • Managing linked Jira issues
      • Concepts
        • Jira connection
      • FAQ
      • Privacy & Terms
  • Trust
    • Our privacy program
  • Legal
    • Privacy Policy
    • Service Level Agreement
    • End User License Agreement
    • Data Processing Agreement
    • Subprocessors
Powered by GitBook
On this page
  • Jira site
  • App user
  1. Intercom
  2. Jira Cloud for Intercom
  3. Concepts

Jira connection

PreviousConceptsNextFAQ

Last updated 2 years ago

When the Intercom app is installed it needs to be connected to Jira. This connection consists of two components:

  • the Jira site that you would like to connect to your Intercom workspace, and

  • the Jira user used by the Intercom app to read and write information to and from the Jira site - we refer to this as the Intercom app user or simply the app user.

This page describes these two elements of the Jira connection.

Jira site

Each installation of the Intercom app is connected to a single Jira site. The Jira site is selected during the app installation process and can only be changed by and .

App user

Any operation in the Intercom app that involves interaction with Jira (e.g. create an issue or retrieve available Jira projects) will be executed by the app user. The app user is the Jira user that was logged in to Jira and the connection to Jira was authorized.

While not strictly necessary, we do recommend setting up a dedicated Jira user for the Intercom app. You may call this user Intercom app or anything else you like. Benefits of setting up a dedicated user for the Intercom app include:

  • Issues created via the Intercom app have a generic user (the app user) as the issue reporter.

  • You can fine-tune and control access to Jira resources by configuring permissions of the app user (see for more details).

You can find the currently configured app user in your app by following the guide on . If you would like to change the Intercom app user follow the steps on .

uninstalling
when the Intercom app was installed
Restricting app access
inspecting app information
Changing the Intercom app user
re-installing the app