Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »

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:

  • Google Calendar

  • Microsoft Office 365 Calendar

  • GitHub

  • GitLab

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 the 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

  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.

After you’ve integrated an app for your organization, navigate to Manage Staff, select Capacity Insights users, and then connect them with the app.

For specific instructions, expand the product you’re integrating with.

 Google 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:

    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.jpg
 Microsoft 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.png

  2. You are prompted to provide consent on behalf of your organization.

    o365-consent.jpg

  3. Choose your Office 365 administrator account.

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

    o365-org-permissions.jpg
 GitHub

  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.jpg

Next Step

Connect your users to the integrated apps

  • No labels