Google Workspace¶
Let your users sign in to Vipilink with their Google Workspace account, in the web platform and in the agent.
You set up one OAuth client in the Google Cloud console and add its client ID and secret in Vipilink.
Before you start
- You're a super admin in Google Workspace and an admin in Vipilink.
- You know your Vipilink workspace address, for example
https://example.vipilink.com. In the steps below, replaceexamplewith your workspace name. - Every user who signs in with Google must already have a Vipilink account with the same email address. Signing in with Google doesn't create Vipilink users.
Step 1: Create a project in Google Cloud¶
We recommend a new project only for Vipilink. You can also use an existing project if its Audience is already Internal. Then skip to Step 3.
- Sign in to the Google Cloud console as a Google Workspace super admin.
-
Click the project picker at the top of the page. In Select a resource, click New project.
-
Fill in the form:
Field Value 1 Project name Vipilink2 Organization Your company's organization, for example example.com3 Parent resource Your company's organization -
Click Create (4). Google Cloud opens the new project.
Step 2: Set up the consent screen¶
-
Open the navigation menu, point to APIs & Services (1) and click OAuth consent screen (2).
-
Google Auth Platform opens. Click Get started.
-
Under App Information, enter the App name
Vipilink(1) and choose the User support email (2). Click Next (3).Users can see the User support email on Google's sign-in page, so choose an address for questions about sign-in, such as your IT support address, not a personal one.
-
Under Audience, choose Internal (1) and click Next (2). Only users in your organization can then sign in.
-
Under Contact Information, enter the Email addresses where Google sends notices about the project (1). Click Next (2).
-
Under Finish, select I agree to the Google API Services: User Data Policy. (1) and click Continue (2). Then click Create (3).
Step 3: Create the OAuth client¶
-
In Google Auth Platform, click Clients (1), then Create client (2).
-
Fill in the form:
Field Value 1 Application type Web application 2 Name Vipilink3 Authorized redirect URIs Click Add URI and enter https://example.vipilink.com/callbackLeave Authorized JavaScript origins empty.
-
Click Create (4).
Step 4: Copy the client ID and secret¶
The OAuth client created dialog shows the Client ID (1) and the Client secret (2). Click the copy icon next to each one and keep them for the next step.
The client secret is shown only once
After you close this dialog, Google doesn't show the client secret again. To keep a copy, click Download JSON before you click OK.
Step 5: Add Google Workspace in Vipilink¶
- In Vipilink, go to Settings → Identity Providers and click Add Provider.
-
Choose Google Workspace (1) and click Next (2).
-
Fill in the form:
Field What to enter 1 Google App Domain Your company's Google Workspace domain, for example example.com.2 Client ID The client ID from Google. 3 Client Secret The client secret from Google. Domain Aliases is optional: other email domains of your company that should sign in with Google Workspace, for example
example.co.uknext toexample.com. -
Click Finish (4). Google Workspace appears on the Identity Providers page with your domain under Domains.
Step 6: Test the sign-in¶
Open your workspace address in a private browser window. The sign-in page now has a Sign In With Google Workspace button. Click it and sign in with a Google Workspace account that has a Vipilink account.
If the user has no Vipilink account with the same email address, Vipilink shows: "No Vipilink account found for user@example.com. Contact your workspace administrator." To add users, see Users.
On Google's sign-in page, users can click Vipilink to see the Developer info: the app name and the User support email from Step 2.
Desktop and mobile¶
The Vipilink agent on desktop and mobile uses the same OAuth client. You don't need to set up anything else in Google.
In the mobile app, enter your workspace, tap Sign In With Google, then tap Continue to let the app use accounts.google.com, and sign in with Google.
SCIM provisioning¶
SCIM provisioning is available on the Enterprise plan. The setup guide for Google Workspace is coming soon. Contact support if you'd like help setting it up now.
Two-factor authentication and access¶
In the Google Workspace card's ... menu you can also:
- Manage 2FA: ask Google Workspace users for a code from an authenticator app. See Two-factor authentication.
- Manage Access: choose which Vipilink groups can sign in with Google Workspace. See Access groups.


















