Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

While Capacity Insights uses work signals directly from Jira, connecting it to other apps provides the work signals that happen outside of Jira, which has historically been the work that is hardest to track.

The following apps can be integrated at the organization level:

  • Bitbucket

  • GitHub

  • GitLab

  • Google Calendar

  • Microsoft Office 365 Calendar

  • GitHub

  • GitLab

If you want to get information from the time your engineers spend in IDEs, they must install the IDE integrations themselves. Tempo supports JetBrains and Visual Studio Code.

Before You Begin

  • If you’re integrating with Google Calendar, you must create a Google service account and generate private keys for the account.

  • If you’re integrating with GitLab, you must use an account that has the owner permission for the projects you want to track.

  • For all other integrations, you must use administrator account credentials.

Install

...

Integration Apps

  1. As a Tempo administrator, select Apps in the Tempo sidebar.

  2. Click Install on one of the following app tiles:

    • Google Calendar

    • Microsoft Office 365 Calendar

    • GitHub

    • GitLab

  3. Navigate to the Organization tab.
    If you’ve selected GitHub, you are prompted to go to GitHub to install the app instead.

  4. Use the on-screen instructions to install the app. Generally, you must authenticate an admin user and grant the Tempo app permission to read information from the other software.On the Getting Started page, select Integrate Calendar & Developer Tools.

    gs-integration-apps.pngImage Added
  5. Click Install on your preferred developer tool or calendar and follow the on-screen directions.

    gs-integrations.pngImage Added

    For detailed installation instructions, see the following topics:

After you’ve integrated an app for your organization, navigate to Manage Staff in Tempo Settings, select Capacity Insights usersthe people you’d like to use automated effort tracking, and then use the Actions menu to connect them with the app. For specific instructions, expand the product you’re integrating with.

Expand
titleGoogle Calendar

The Google Calendar integration requires a private key for a Google Service account that can read your users' calendars, profiles, and email.

Create a Google Service Account and Generate Private Keys

  1. Create a new Google Cloud project or use an existing one, and then enable the following APIs:

    • Google Workspace Admin SDK API

    • Google Calendar API

  2. Add a Google service account to the project.

  3. Download the service account private key.
    Note when your key expires, and set a reminder to generate a new set of keys to upload.

  4. Delegate domain-wide authority to the service account with the following OAuth scopes:

    Code Block
    https://www.googleapis.com/auth/calendar.readonly,
    https://www.googleapis.com/auth/userinfo.profile,
    https://www.googleapis.com/auth/userinfo.email

Use this key to install the Google Calendar app for your Organization.

gcal-org-privatekey.jpgImage Removed
Expand
titleMicrosoft Office 365 Calendar

You must provide consent to grant permissions and also grant permissions to Tempo Timesheets.

  1. Click Sign in with Office 365, and then select your Office 365 administrator account.

    o365-org-install.pngImage Removed
  2. You are prompted to provide consent on behalf of your organization.

    o365-consent.jpgImage Removed
  3. Choose your Office 365 administrator account.

  4. You are prompted to grant permissions to the Tempo Timesheets app.

    o365-org-permissions.jpgImage Removed
Expand
titleGitHub
  1. On the GitHub integration tile, click Install.
    You are prompted to continue to GitHub to configure the connection. You may need to authenticate your account.

  2. The Tempo Time Tracking GitHub App page opens. Click Install.

  3. Choose which repositories you want to track time in.

    • Select All repositories if you want time tracking for all your repositories, including any future repositories.

    • Select Only select repositories if you want to limit time tracking to specific repositories. You can then choose which repositories that the app can read.

  4. To allow the app to read information for the integration, click Install.

    github-install.jpgImage Removed

Next Step

Connect your users to the integrated appsdetailed instructions, see Connecting Users to Integrated Apps.

...

Next Step

Preparing Jira for Capacity Insights