Google Workspace Integration
Cloud Voice can connect to Google Workspace (formerly G Suite) so that your company directory does double duty as your phone system directory. Once linked, user accounts flow one way from Google Workspace into Cloud Voice, extensions can be provisioned automatically, and your team can sign in to the Cloud Voice App with the Google credentials they already use.
Here, “the PBX” (private branch exchange) means the Cloud Voice phone system itself.
Requirements
Section titled “Requirements”Before you set up the integration, confirm that both sides 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 |
What the integration does
Section titled “What the integration does”Linking the two platforms unlocks three capabilities:
- User synchronization: Accounts sync in one direction, from Google Workspace to Cloud Voice. When you update a user’s details in Google Workspace, the change carries over automatically, so you manage the directory in one place instead of maintaining it twice. This reduces manual setup and keeps the two systems in step.
- Automatic extension provisioning: As users sync across, Cloud Voice can create an extension for each one and assign it, giving them immediate access to the platform’s unified communications tools.
- Single sign-on (SSO): Synced users log in to the Cloud Voice App with their Google credentials, so there is no separate phone-system password to distribute or remember.
How the connection works
Section titled “How the connection works”Cloud Voice authenticates to Google using the OAuth (Open Authorization) 2.0 protocol. This lets the PBX read the user data in your organization through Google’s API (application programming interface) with delegated, revocable access instead of stored account passwords.
Setting up and managing the integration
Section titled “Setting up and managing the integration”Initial setup
Section titled “Initial setup”Getting connected takes only a few steps, split between the Google side and the Cloud Voice side.
- On the Google side, create the resources and credentials the integration relies on:
- Create a Google Cloud project to keep the integration in its own isolated environment.
- Enable the Admin SDK (Software Development Kit) API so the project can reach your organization’s user data through the API.
- Configure the OAuth consent screen with the branding shown to users during authorization.
- Register a web application and generate the access credentials that let Cloud Voice read your organization’s user data.
- On the Cloud Voice side, enter the access credentials you generated.
For the full walkthrough, see Integrate Cloud Voice with Google Workspace.
After you connect
Section titled “After you connect”With the link in place, a little more configuration turns synced Google accounts into working users on the phone system:
- Synchronize users from Google Workspace to Cloud Voice and assign them extensions.
- Allow users to log in to the Cloud Voice App with Google SSO.
Ongoing management
Section titled “Ongoing management”Once the integration is running, use these topics to keep it tuned to your needs:
- Schedule automatic user synchronization: set the time each daily sync runs.
- Manually perform user synchronization: run a sync right away to apply a new rule or push recent Google Workspace changes without waiting for the schedule.
- Update the client secret for the integration: replace the secret Cloud Voice uses to authenticate, for example after rotating it in Google.
- Pause Google Workspace synchronization: temporarily hold syncing so Google Workspace updates do not overwrite synced user data.
- Disable the Google Workspace integration: switch the integration off for troubleshooting without losing your existing configuration.
- Disconnect the Google Workspace integration: fully remove the current connection.