How to Setup

Today we are going to help you setup your Google Calendar integration. Before you proceed, we would recommend checking out the Overview section to understand why you would want to integrate Boomerang with your Google Calendar and the roles/permissions required by Boomerang to do so.

A Service Account is a special type of Google account intended for server-to-server integrations. It allows applications to access Google Workspace data without user intervention, especially useful for automated data analysis and integrations.

Domain-Wide Delegation allows a Service Account to impersonate users in your Google Workspace domain. With this, the service can access data on behalf of any user in your organisation, given the appropriate permissions.

Our application uses read-only scopes to view directories, users and calendar events to draw insights and linkages to enable better client profiling.

This setup ensures that our platform can access calendar events, users, and groups data across your domain, while maintaining compliance with Google Workspace's security policies.

1→ Go to the Google Admin Console.

2→ Navigate to Security > API Controls

3→ Click on Manage Domain-wide delegation (direct link here)

4→ Click Add new.

5→ Enter the Boomerang Discover Client ID mentioned below :

6→ Add the following OAuth Scopes (comma-delimited):

https://www.googleapis.com/auth/calendar.readonly,https://www.googleapis.com/auth/admin.directory.user.readonly,https://www.googleapis.com/auth/admin.directory.group.readonly,https://www.googleapis.com/auth/admin.directory.group.member.readonly

7→ Click Authorise.

8→ Newly added service account should be listed under API Clients

1→ Go to Boomerang website discovery page

2→ Login into your account and you should be able to see the Discovery integration page. Click on connect below “Google Calendar”

3→ Add the workspace admin email address

4→ Click on “Connect” once you’ve entered a valid email address

5→ You should be able to see a “Connection setup successful” message

6→ Discovery settings defaults should be visible. Modify to suit your use-case

7→ Select the list of Individuals and Groups within your workspace that you want to track (refresh if list is not populated yet)

8→ Once finished, complete the setup by clicking on “Proceed” to start pulling events related to those individuals and groups.

By following the steps outlined in this guide, you can enable a secure and effective calendar integration. This integration will help you gain insights from your team's calendar data, identify hidden customers, and enhance your customer engagement strategy.

For further assistance, please contact our support team (mail : support@getboomerang.ai).