Document toolboxDocument toolbox

This article is for Timesheets for Cloud. Visit Data Center

Tempo Bitbucket Integration

Owned by Su-Lyn Rosenberry
Last updated: May 28, 2024
3 min read

Integrating Bitbucket and Timesheets by Tempo populates the Activities Feed in My Work with potential worklogs based on actions performed with Bitbucket. This allows team members to log the time they spend working on code quickly without needing to track their time manually.

The app reads data from the following events, captured through Bitbucket’s webhooks:

  • Repository push

  • Pull request events, such as:

    • created

    • updated

    • changes request

    • comments

The data is used to associate the work with a Jira issue and to estimate how much time is spent working on coding tasks for the issue.

A Bitbucket admin must connect the Tempo Bitbucket Integration app to Bitbucket. When you connect Bitbucket for your organization, you allow the app access to all projects for which you are the owner. If work occurs outside those projects, that work isn't pulled into the Activity Feed.

We recommend including the Jira issue key in your commit messages or branch names to ensure the app associates the work with the correct issue.

Before You Begin

  • You must log in to Tempo as a Tempo Administrator.

  • Your account must be the owner of any repository you want to track.

  • By default, all Tempo user accounts are automatically connected to their Bitbucket accounts after the integration app is installed successfully.

Install the Tempo Bitbucket Integration App for your Organization

  1. In Jira, navigate to the Tempo app.

  2. Select Apps in the Tempo sidebar.

  3. On the Bitbucket integration tile, click Install.

  4. Navigate to the Organization tab, and then click Connect Bitbucket organization.

    bb-org-install.png

  5. If prompted, log in with your Bitbucket administrator credentials.

  6. If prompted, Grant access to your Bitbucket account. This allows the app to view the actions performed in all of your projects and connect the actions to Tempo users.

    bb-integration.png

When installed, the Tempo time tracking webhook is listed on your Webhooks page for each repository you can access. Your Tempo users are connected automatically to their Bitbucket accounts, and their Activity Feed in My Work is populated with potential worklogs related to their Bitbucket actions.

View Webhook Requests

To verify which events the app listens for or view detailed information about the requests, visit the Webhooks page for your repositories.

  1. In Bitbucket, navigate to your Repository settings and then Webhooks.

  2. Under Workspace hooks, view requests from the Tempo time tracking webhook.

  3. Click Enable to view detailed request history for any future requests. Consult the Atlassian Bitbucket documentation for more information.

Disconnect the app

If you no longer want your organization to track work done in Bitbucket, disconnect the Bitbucket app from the Tempo Apps page.

  1. In Jira, navigate to the Tempo app.

  2. Select Apps in the Tempo sidebar.

  3. Click the Bitbucket integration tile.

  4. Navigate to the Organization tab, and then Disconnect your organization.

When the app is disconnected from your organization, users are automatically disconnected from Bitbucket, the Activities Feed no longer includes work performed in Bitbucket, and the Bitbucket icon is removed from the Integrations column in Manage Staff.

Â