Setup Guide: ActivTrak's Google Calendar Integration

ActivTrak’s Google Calendar integration enables a more comprehensive picture of employees’ workdays, filling in the “blank spaces” in users’ digital activity with meeting data from their calendars.

Many employees — especially those who work in an office or who are frequently in the field — do not spend their entire workday in front of a computer. Much of their time is spent in in-person or in phone meetings that can’t be detected by the ActivTrak Agent. During periods of digital inactivity, the Google Calendar integration provides an additional data source, enabling ActivTrak to fill in the gaps with time spent in Offline Meetings.

Setting up the Google Calendar integration involves configuring your Google instance to establish a super admin, whitelisting the OAuth2 application used by ActivTrak for Google-related integrations and enabling ActivTrak APIs. Once the setup process is complete, the integration can be configured within the ActivTrak app.

Follow this guide for step-by-step instructions:

Requirements

 

Setup Instructions

1. Configure Your Google Instance

  • Whitelist the Tray.io App. Before authenticating any of your Google accounts, whitelist the Tray.io OAuth2 application which is used by ActivTrak for Google-related integrations. To do this, log in to the Google Workspace Admin Console and enter the Tray.io OAuth2 Client ID.

  • Note: This step does not give ActivTrak access to your Google accounts and applications, it only allows authentications facilitated by Tray.io app.

  • Log in to the Google Workspace Admin Console.

Google Admin Console.png

The Google Workspace Admin Console

  • Navigate to Security > Access and data control > API controls.

gconsole1.png

 

  • Click on the Manage Third-Party App Access link within the App access control panel.

gconsole2.png

  • Click the Add App link to add an app, as shown below.

gconsole3.png

 

  • Enter the following Client ID and select 'Web' as the app type:
597325623219-f23k7dhk377f8bvamo2e6klu1i37tco7.apps.googleusercontent.com 
  • Successful configuration:

gconsole4.png

2. Establish a Super Admin

  • From the Google Workspace Admin console, create a new user with a Super Admin role. Alternatively, designate an existing user with a Super Admin role to enable ActivTrak’s Google Calendar integration.
  • To create a new Super Admin role, click Directory > Users, as shown in the screenshots below.

gconsole5.png

gconsole6.png

3. Enable the ActivTrak APIs for the Google Calendar Integration

gconsole7.png

  • Click on Enable APIs and Services, as shown below.

gconsole8.png

  • Enable the following APIs:
    • Admin SDK API
    • Google Calendar API

4. Configure the Google Calendar Integration in ActivTrak

  • Log in to the ActivTrak application. Navigate to API & Integrations > Integrate
  • Locate the Google Calendar Meeting Insights card, then click the green “Integrate” button within the card, as shown below.

Googlecal.png

  • Click New Authentication, then provide a label for your integration instance and enter your Google credentials.

GoogleCal-13.png

  • Click Next, then enter your calendar domain.

setdomaingooglecal.png

  • Click Finish.
    • Once finished, it may take up to 24 hours to complete the initial data retrieval. The integration card will temporarily display the message: “Your data is being processed. This may take up to 24 hours to complete.”
    • Once the process is complete, the card will display the message: “✓ Enabled.”
    • If you are still seeing the “Your data is being processed” message after 24 hours, please email support@activtrak.com for assistance.

View Offline Meeting Data in Insights Dashboards

 

After enabling the Google Calendar Integration, Admins will get access to a set of dashboards that display Offline Meeting data. Learn more here.

 

Update the Google Calendar Integration Configuration

 

To update your Google Calendar integration configuration (i.e. to use a different Google credential), the integration will need to be deleted and re-enabled to accept the update. 

To delete the Google Calendar integration, click on the three-dot settings icon in the top right corner and select Delete, as shown below. After deleting, please follow the previous steps in this guide to reconfigure the integration.

gconsole9.png

Learn more:

Was this article helpful?

0 out of 0 found this helpful

Comments

No comments