Integrate Cloud Voice with Google Workspace

Linking Cloud Voice to Google Workspace lets your organization use Google Single Sign-On (Google SSO) and pull user accounts directly from your Google directory. Completing the connection is a three-part process: you collect a pair of redirect URIs (Uniform Resource Identifiers, the web addresses Google returns a user to after sign-in) from Cloud Voice, build the matching project and credentials in Google Workspace, and then paste those credentials back into Cloud Voice to finish the handshake.

Requirements

Before you begin, confirm both platforms meet the following:

Platform	Requirement
Google Workspace	Business or Enterprise edition.
Cloud Voice	Firmware 84.19.0.22 or later, on the Enterprise Plan or Ultimate Plan.

Step 1. Collect the redirect URIs from Cloud Voice

Google Workspace needs two redirect URIs from Cloud Voice before you can register the application, so gather them first.

1. Open the Google Workspace integration page:

   1. Sign in to the Cloud Voice web portal and go to Integrations > Collaboration.
   2. Find Google SSO in the list and click Integrate on its row.

   

2. In the App Registration section, copy and save both redirect URIs.

   

   • Redirect URI: Where the browser lands once integration authentication succeeds.
   • Client SSO Redirect URI: The address that lets users sign in to the Cloud Voice App with their Google credentials.

Step 2. Build the project and credentials in Google Workspace

Sign in with a Google Workspace super admin account to create a dedicated Cloud project and enable the APIs (Application Programming Interfaces) the integration depends on.

Caution

You must be signed in as a Google Workspace super admin for both this step and Step 3. A regular admin account cannot grant the organization-wide access to user data that the integration needs, so the authorization in Step 3 will fail.

1. Create a Cloud project for your organization:

   1. Sign in to the Google Cloud console, search for Create a Project, and open the matching result.

      

   2. Fill in the project details and click Create.

      

      • Project name: A label that helps you recognize the project later.
      • Organization: The organization the project belongs to.
      • Location: The place within your organization’s resource hierarchy where the project is created.

2. Turn on the Admin SDK API so the integration can reach user data across your organization:

   1. Search for Admin SDK API and open it from the results.

      

   2. Click ENABLE.

      

3. Set up the OAuth (Open Authorization) consent screen. Its branding details appear whenever someone authorizes the application you create in the next step:

   1. Search for Branding and open it from the results.

      

   2. Click Get Started.

      

   3. Work through the wizard to complete the consent screen settings.

      

4. Create a web application to generate the credentials that let Cloud Voice authenticate against your directory:

   1. Click Create OAuth client.

      

   2. In the Application type drop-down, choose Web application.

      

   3. In the Name field, enter a label for the application.

      

   4. Under Authorized redirect URIs, add both redirect URIs you copied from Cloud Voice in Step 1.

      Caution

      Enter each redirect URI exactly as it appears in Cloud Voice, including the https:// prefix and any trailing path. Google matches the value character for character, so any difference makes sign-in fail with a “redirect URI mismatch” error.

      

   5. Click Create. Google displays the new credentials in a pop-up window.

   6. Copy and save the client ID and client secret: you enter both in Cloud Voice in the next step.

      Caution

      Treat the client secret like a password. Anyone who obtains it can impersonate your integration and reach your organization’s directory data, so store it somewhere secure and never share it.

      

      Note

      If the client secret isn’t shown, click Download JSON to retrieve the credentials.

      

Step 3. Finish the connection in Cloud Voice

Return to Cloud Voice and enter the credentials to complete the integration.

1. Open the Google Workspace integration page again:

   1. Sign in to the Cloud Voice web portal and go to Integrations > Collaboration.
   2. Click Integrate on the Google SSO row.

2. In the Certificates & Secrets section, paste the client ID and client secret from Google Workspace.

   

3. Click Save. Cloud Voice sends you to the Google sign-in page.

4. Sign in with your Google Workspace super admin account and authorize the web application to access your organization’s user data.

   

5. Back in the Cloud Voice portal, click OK to close the dialog.

   

Result

The integration now shows a status of Connected, confirming that Cloud Voice is linked to your Google Workspace.

What to do next

Synchronize users from Google Workspace to Cloud Voice so their Google accounts map to extensions they can use for calls.