Skip to main content

Atlassian agents

Enables users to search for tickets/projects/boards, emails/users, and confluence documents from Atlassian.

Create an OAuth application in Atlassian Developer

  1. Refer to Atlassian's documentation to create a new OAuth 2.0 client in Atlassian Developer:

    • Under Callback URL, add {ORG_ORIGIN}/agent/atlassian/response (replace {ORG_ORIGIN} with the correct origin for the org, e.g. https://{ORG_NAME}.is.here.io).
  2. Once created, hit Settings and copy the Client ID and Secret (create a new one if required) values for the OAuth 2.0 client, as they will be used in later steps.

  3. Go to the Permissions section and hit Edit Scopes, add the following scopes under each section:

    • Jira API

      • read:jira-work
      • read:jira-user
      • write:jira-work
      • Hit Granular Scopes and add:
        • read:project:jira
    • Confluence API

      • search:confluence
      • read:confluence-content.all
      • read:confluence-space.summary
    • User identity API

      • offline_access
      • read:me
      • read:account

Add the agent in Admin Console

If this agent is enabled for your Enterprise Browser Instance (it can be enabled upon request), follow these steps:

  1. In the Admin Console, navigate to the Content page. Click Create and then Agent.

  2. Select Atlassian.

  3. Add a Description or keep the default one provided. Then add the Client ID and Client Secret provided by Atlassian Developer Settings in the previous section.

  4. Click the Grant Access button. Choose which users or groups need access to the agent.

  5. Click the Create Agent button. The agent is added to the Content page, but not yet activated.

  6. To activate the agent, click the Action ⋮ menu on the agent and select Activate.