In order to create a custom Google Contacts integration, you will firstly need to sign in to your Google Cloud Console (https://console.cloud.google.com) or create a new account if not yet created.
Once you logged into your Google Cloud Console, navigate to "API & Services" > "OAuth consent screen" > "Branding".
Here, you firstly need to specify your OAuth consent screen branding, which is where users will be navigated to once they enable your custom integration in the admin portal or softphone app.
After that, specify your top-level domain in the Authorised domains field, which will then need to be verified by adding CNAME records to your domain's DNS provided in your Google Cloud Console.
Important:
Your custom Ringotel admin portal domain must match with the authorized domain or be its sub domain.
2. Once you complete the branding section and verify your authorised domains, navigate to the "Data Access" section and add the following scopes to your application:
Non-sensitive scopes:
./auth/userinfo.profile
Sensitive scopes:
./auth/contacts
./auth/contacts.other.readonly
./auth/directory.readonly
Note:
Because we are requesting sensitive scopes, the app needs to be sent for verification to Google Cloud’s review team. For this, you will need to specify how the selected scopes will be used (justification) and provide a demo video showing Google Contacts integration set up via the Ringotel admin portal and the softphone app. This video can serve you as a reference: https://youtu.be/1OQJoAzos0Q
3. Lastly, navigate to the "Clients" menu to create a new OAuth 2.0 Client ID.
Click on + Create client and in the Application type select "Web application".
Then, provide a client ID name and in the Authorized redirect URIs specify your custom Ringotel admin portal URL with the following path "/services/<Ringotel Account ID>/Google". For example:
Tip:
You can find your Ringotel Account ID in your Ringotel admin portal > Menu > Account.
Click Create button to create a new client ID. Once created, you should see a pop-up with your Client ID and Client secret details:
Note these details and send them over to the Ringotel team so we can add your custom Google Contacts integration to your integrations list.