Documentation

Setup

Install

Create a Branch

View Branch Details

View Commits Details

View Pull Requests Details

Bitbucket Setup

Step 1:

Before installing the app, go to your Bitbucket account and navigate to Settings.

Step 2:

Then, access the OAuth menu.

Step 3:

Click on the “Add Consumer” button.

Step 4:

Fill out the form with the following information:

Name: Bitbucket App for Freshservice
Callback URL: https://oauth.freshdev.io/auth/callback
Select this is a private consumer

Step 5:

Select Permissions as in the image below.

Step 6:

Click on the “Save” button.

App Install

Step 1:

Navigate to Admin > Apps and click on the “Get More Apps” button.

Step 2:

Look for the “Bitbucket App for Freshservice” in the Marketplace and install the integration to your Freshservice instance by clicking on the “Buy App” button.

Step 3:

The Install settings page will open. You need to fill out the Client Key and Client Secret and click on the “Save” button.

Create a Branch

Step 1:

Navigate to a ticket and open the Bitbucket app in the sidebar.

If there’s no Branch created for this ticket. (Otherwise, go here!)

Step 2:

If there’s no Branch created for this ticket, then the app will display a Search bar to select repository to create a branch and a Create button.

Step 3:

Search for the desired Bitbucket repository from which you’ll create a new branch and Select it by clicking on it on the results dropdown.

Step 4:

Click on the “Create Branch” button.

Step 5:

You’ll be sent to Bitbucket to finish the Branch creation. Make sure to select “Other” in the type of Branch field.

Step 6:

Click on the “Create” button to finish creating the new Branch.

If there’s already a Branch created for this ticket.

Step 2:

If there’s already a branch linked to this ticket, then the app will display branch, commits and pull requests information.

Step 3:

Click on the “Add branch” button in the bottom of the app.

Step 4:

Search for the desired Bitbucket repository from which you’ll create a new branch and Select it by clicking on it on the results dropdown.

Step 5:

Click on the “Create Branch” button.

Step 6:

You’ll be sent to Bitbucket to finish the Branch creation. Make sure to select “Other” in the type of Branch field.

Step 7:

Click on the “Create” button to finish creating the new Branch.

View Branch Details Inside a Ticket

Step 1:

Navigate to a ticket and open the Bitbucket app in the sidebar.

Step 2:

If there’s already a branch created for this ticket, then the app will display branch, commits and pull requests summary information.

Step 3:

Click on the “Branches” button.

Step 4:

A modal will open up displaying information about branches linked to this ticket. Here you’ll be able to see:

To which repository it belongs to
Branch title
If there’s a commit related, it will display it’s code
If there’s a pull request for this branch, it will display it’s status
Last modified date
The ability to Create a Pull request for a branch

Step 5:

You can click on the repository name or branch title to easily access Bitbucket directly. Also, you can start creating a Pull Request for a selected branch by clicking on the button.

View Commit Details

Step 1:

Navigate to a ticket and open the Bitbucket app in the sidebar.

Step 2:

If there’s already a branch created for this ticket, then the app will display branch, commits and pull requests summary information.

Step 3:

Click on the “Commits” button.

Step 4:

A modal will open up displaying information about branches linked to this ticket. Here you’ll be able to see:

The Author of the Commit
Commit Title
The Commit’s Message
Last modified date
The number of files there are for the Commit

Step 5:

You can click on the Commit title to easily access it on Bitbucket. Also, you can consult the files of the Commit.

View Pull Requests Details

Step 1:

Navigate to a ticket and open the Bitbucket app in the sidebar.

Step 2:

If there’s already a branch created for this ticket, then the app will display branch, commits and pull requests summary information.

Step 3:

Click on the “Pull Requests” button.

Step 4:

A modal will open up displaying information about Pull requests from branches linked to this ticket. Here you’ll be able to see:

The Pull Request ID
The Title of the Pull Request
The Status of the Pull Request
The Author of the Pull Request
The Reviewer of the Pull Request
Last modified date

Step 5:

You can easily access the Pull Request by clicking on the ID and Title of the pull request, to send you to Bitbucket directly.