Skip to main content

Atlassian

Integrate Atlassian with yellow.ai and manage all your Atlassian activities from our platform. This integration empowers your bot to provide users with access to their Atlassian account and perform Atlassian actions directly within the Yellow.ai bot.

Steps to integrate with Yellow.ai

The following are the steps to be followed to integrate your Atlassian account with Yellow.ai.

Create an app on Atlassian

  1. Go to https://developer.atlassian.com/console/myapps/ and click Create > Oauth 2.0 integration.

  1. Go to Console > My apps > yourAppName > Permission > Jira API > Add > Configure.

  1. Add and configure the app’s API scopes for JIRA.

Common permissions

ScopeDescription
read:jira-workRead access to Jira project and issue information, and search for specific issues.
read:jira-userRead access to Jira user information that is available to you.
write:jira-workCreate and edit access to Jira issues, including creating and editing them, posting comments on behalf of the user, adding worklogs, and deleting issues.
read:servicedesk-requestRead access to customer requests data, including approvals, attachments, comments, and request participants.
write:servicedesk-requestCreate and edit access to customer requests, including creating and editing them, adding comments and attachments.
  1. Go to yellow.ai > Integrations, click the URL hyperlink, and copy it.

  1. Paste this in the Callback URL field.

  1. Go to Settings and copy the Client ID and Secret.

Connect Atlassian with Yellow.ai

  1. Go to cloud.yellow.ai and click Integrations.

  1. To access Atlassian, either search for it from the left navigation bar, select the Tools and Utilities category > Atlassian.

  1. Under Add account, enter Client ID, Client secret and add the list of scopes in Scope separated by space, including offline_access.

    For example,

 "scope": "offline_access read:jira-work read:jira-user write:jira-work read:servicedesk-request write:servicedesk-request"
  1. Click Connect.

Recieve Atlassian events in your bot

  1. Go to Studio > Event > Custom events and create a custom event named atlassian-auth-success. Click here for the steps to create custom event.

  2. You can set this event as a start trigger for a flow. This flow will get triggered after a user is successfully authorized. Build the flow to execute the desired action immediately after the user's authorization.

Manage Atlassian from Yellow.ai

The following are the usecases currently supported in this integration.

Set up the Atlassian login URL on Yellow.ai

  1. Go to Studio and create a flow based on your usecase.

  2. Include the integration node at the point in the flow where you want to authorize the user or when the bot needs to request user authorization. To accomplish this, navigate to Integrations and select Atlassian.

    drawing
  3. Store the reponse of this node in a variable.

drawing
  1. To display the URL to the user, pass this variable in a message node in this syntax {{variables.variable.arrayname.fieldname}}.

Sample success response:

{
"success": true,
"message": "Login URL Generated Successfully.",
"data": {
"AtlassianLoginUrl": "https://auth.atlassian.com/authorize?audience=api.atlassian.com&client_id=AjkmqleiLUM0D1BWH3jbdAplNPIepYHb&response_type=code&response_mode=query&scope=read%3Ame%20read%3Ajira-work%20manage%3Ajira-project%20read%3Ajira-user%20write%3Ajira-work%20manage%3Ajira-configuration%20read%3Aservicedesk-request%20write%3Aservicedesk-request%20offline_access&redirect_uri=https://app.yellow.ai/integrations/genericIntegration/oauth/atlassian/x1670616051234&state=eyJib3QiOiJ4MTY3MDQxNDg1NzY2NSIsInNvdXJjZSI6InllbGxvd21lc3NlbmdlciIsInNlbmRlciI6IjM1MTI0MzAyNzEyNzU5MDcyMjQxNjQ4OTA5MSJ9&prompt=consent"
}
}

Refresh access token on Yellow.ai

  1. Go to Studio and create a flow based on your usecase.

  2. Include the integration node at the point in the flow where you want to refresh the access token. To accomplish this, navigate to Integrations and select Atlassian.

    drawing
  3. Fill the Refresh token field.

    drawing
Field nameSample valueData typeDescription
Refresh Tokenasddskeku2iwewbhwjsnmelsdjckmd22eokedsStringAccess and refresh token obtained from Atlassian event after successful login.

Sample success response:

{
"access_token": "eyJraWQiOiJmZTM2ZThkMTA2N2RjYTgyNTg5MmEiLCJhbGciOiJSUzI1NiJ9.-sHvMv4K70aHwVkpbE8sLXovfoo2gIZZ2mgsTKzeVQ_YcKX0EMPTnuViXMoDwm1RfwHb",
"expires_in": 3600,
"token_type": "Bearer",
"refresh_token": "eyJraWQiOiI1MWE2YjE2TQ5ZDFiYTdhM2VmZjciLCJhbGciOiJSUzI1NiJ9.eyJqdGkiOiI5NQ4YTctODNiMi02E4ODlmNDgiLCJzdWIiOiI2MjgzNTUwNGNjMWQxNTAwNmZ",
"scope": " offline_access read:jira-user"
}