Skip to main content

Google Workspace Mail & Calendar Integration Guide (Google Workspace ↔ TAC)

This integration allows TAC to synchronize Gmail and Google Calendar to display, within each contact, the complete history of activities, including exchanged emails and meeting or call invitations.

1. Access the Google Cloud Console

Log in to the Google Cloud Console

Select or create a new project dedicated to the TAC integration.


2. Enable the Required APIs

In the selected project:

  1. Go to APIs & Services → Library

  2. Enable the following APIs:

  • Gmail API

  • Google Calendar API

  • Admin SDK API (required for users and directory access)


3. Configure the OAuth Consent Screen

  1. Go to APIs & Services → OAuth consent screen

  2. Select Internal (recommended for companies).

  3. Fill in the main fields:

    App name: TAC – Mail & Calendar Integration

    User support email

    Developer contact information

  4. Save and continue without publishing (if the app is internal).


4. Create OAuth 2.0 Credentials

  1. Go to APIs & Services → Credentials

  2. Click: Create credentials → OAuth client ID

  3. Select:

    Application type: Web application

  4. Fill in the following fields:

  5. Save and take note of:

    • Client ID

    • Client Secret


5. Required Scopes and Permissions

The integration uses the following OAuth scopes to synchronize activity history.

Email (Gmail)

Calendar

User Directory (Admin SDK)

⚠️ The readonly scopes guarantee read-only access to emails and calendar events.


6. Configure Domain-Wide Delegation (Admin)

This step is required to allow TAC to access user data at the domain level.

  1. Log in to the Google Workspace Admin Console

  2. Navigate to:

    Security → API controls → Domain-wide delegation

  3. Click Add new

  4. Enter:

  5. Save the configuration.


7. Configure the Integration in the TAC Portal

  1. Log in to the TAC portal:

  2. Go to:

    Settings → Integrations

  3. Select Google Workspace

  4. Enter:

    • Client ID

    • Client Secret

  5. Enable:

    Import Emails
    Calendar Synchronization

  6. Click Save.


8. Integration Result

Once the integration is complete:

  • TAC synchronizes emails from Gmail associated with contacts

  • TAC synchronizes events from Google Calendar (meetings, calls, invitations)

  • Each contact will display a centralized activity history, useful for:

    • preparing before a call

    • tracking follow-ups and relationships

    • ensuring continuity even in distributed teams.


Did this answer your question?