Skip to main content
Vocalis joins Google Meet calls as a participant using a Google Workspace service account. This guide walks through creating the service account, enabling domain-wide delegation, and connecting it to Vocalis.

​
Prerequisites

  • A Google Workspace account with admin access
  • A Google Cloud project (or permission to create one)

​
Step 1: Create a Google Cloud project

1

Go to Google Cloud Console

Navigate to console.cloud.google.com.
2

Create a new project

Click the project dropdown at the top → New Project. Name it something recognizable like “Vocalis Integration”.
3

Select the project

Make sure the new project is selected in the project dropdown.

​
Step 2: Enable required APIs

Enable the following APIs in your Google Cloud project:
1

Go to APIs & Services

Navigate to APIs & Services → Library.
2

Enable these APIs

Search for and enable each of the following:
  • Google Calendar API
  • Google Meet REST API (if available)
  • Gmail API (for sending calendar invites)

​
Step 3: Create a service account

1

Go to Service Accounts

Navigate to IAM & Admin → Service Accounts.
2

Create service account

Click Create Service Account.
  • Name: vocalis-meet-agent
  • Description: “Service account for Vocalis AI to join Google Meet calls”
3

Skip optional steps

You can skip the “Grant this service account access to project” and “Grant users access” steps.
4

Create a key

Click on the newly created service account → Keys tab → Add Key → Create new key → JSON.Download the JSON key file. You’ll upload this to Vocalis.
Keep the JSON key file secure. It grants access to your Google Workspace on behalf of the service account. Do not commit it to version control.

​
Step 4: Enable domain-wide delegation

1

Enable delegation on the service account

In the Google Cloud Console, go to IAM & Admin → Service Accounts.Click on the vocalis-meet-agent service account → Details tab.Check Enable Google Workspace Domain-wide Delegation. Note the Client ID — you’ll need it in the next step.
2

Authorize scopes in Google Workspace Admin

Go to admin.google.com → Security → Access and data control → API controls → Manage Domain Wide Delegation.Click Add new and enter:
  • Client ID: The client ID from the service account
  • OAuth scopes (comma-separated):
https://www.googleapis.com/auth/calendar,
https://www.googleapis.com/auth/calendar.events,
https://www.googleapis.com/auth/gmail.send
3

Save

Click Authorize.

​
Step 5: Connect to Vocalis

1

Open Vocalis settings

Log in to vocalis.witting.ai and go to Settings → Integrations.
2

Upload the service account key

In the Google Workspace section, upload the JSON key file you downloaded.
3

Enter the delegated user email

Enter the email address of a Google Workspace user the service account should impersonate when creating calendar events and joining meetings (e.g., vocalis@yourcompany.com).
4

Save and test

Click Save. Use the Test Connection button to verify the integration works.

​
Troubleshooting

IssueSolution
”Access denied” when testingVerify domain-wide delegation scopes match exactly. Check that the Client ID is correct.
Calendar events not appearingEnsure the Google Calendar API is enabled in your Cloud project.
Actor can’t join the MeetCheck that the delegated user email has a Google Workspace license with Meet access.

​
Next steps

Twilio Setup

Add phone call support.

Quick Start

Schedule your first interview.