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
  • Finding configured app user for a project
  • Changing the app user
  1. Atlassian Cloud
  2. Intercom for Jira Cloud
  3. Guides
  4. Jira administrators

Configuring the app user

PreviousManaging the Intercom app configurationNextRevoking Intercom connection

Last updated 1 year ago

Any operation that causes the app to interact with Intercom API (e.g. adding a comment that is being sent to Intercom or transitioning an issue that adds a notification note to Intercom) will run as what we call the app user. The app user is the Intercom teammate who has/was logged in to Intercom . This guide will explain how to change the app user to another Intercom teammate.

Creating a dedicated Intercom teammate for the app

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

  • Notification notes posted to conversations are posted as a generic user (the app user).

  • You can fine-tune and control access of the app independently of your regular Intercom teammates.

If you are on a new Intercom plan, we highly recommend configuring the app user using . Light seats are free and included in your Intercom plan, so you won't be charged for any extra seats. You may call the Intercom teammate Jira integration or anything else you like. Please make sure that the "Can install, configure and delete apps".

Finding configured app user for a project

You can find the currently configured app user for any Jira project by opening the Jira project's settings and clicking on Apps -> Intercom integration (1) in the left-hand menu. If the Jira project is connected to Intercom, the app user is displayed under App user (2).

Changing the app user

Open Intercom in your browser, click on your avatar in the bottom right corner, then click Logout (1).

Back in Jira, open the project settings and click on Apps -> Intercom integration (1) in the left-hand menu. Then, click on the more actions (•••) menu -> Revoke connection (2) to revoke the connection to Intercom. Existing conversation links will remain in working order if you connect back to the same Intercom workspace.

If you would like to add a dedicated teammate for the app, have a look at the .

Follow the . When you are asked to log in to Intercom, log in with the generic app user or whichever you want to authorize the connection with.

Intercom documentation on how to add a new teammate
an Intercom Light seat
Light seat teammate has at least the permission
steps on how to connect a Jira project to Intercom
when the Jira project was first connected to Intercom