How to setup Google application

This article is only valid for customers using a standalone LiveAgent license (version 5.25.x.x or above) installed on their own server, customers with cloud-based accounts don't need to set up their own Google application.

Due to security reasons, it's now required to authorize access to your Gmail or Google workspace mail account using Google OAuth 2.0. To be able to work with Google OAuth 2.0 the LiveAgent software needs to connect to Google services using a Google application.

To set up your own Google application in order to connect it with your standalone LiveAgent installation follow the following steps.

 

1. First go to https://console.cloud.google.com/ and log in with your Google account. If you are accessing this page for the first time you'll be asked for consent with the terms of service. If you agree, click on AGREE AND CONTINUE.

2. Once you are redirected to the Google cloud platform you will need to start by creating a project.

3. Name the project so you know what it is used for. If your Google account is part of a Google Workspace (formerly known as G-suite) the project is automatically created under the organization you are a member of. You will be able to choose a folder or parent organization where the project will be placed.

If your personal google account is not part of an organization you won't see the Organization field at all. The location field will say "No organization". See screenshot below.

4. After you create your project you'll be redirected to the project dashboard. In the menu on the left side open APIs & Services -> Library.

5. Locate the Gmail API section and click on it. You can use the filter on the right edge of the screen or the search field at the top of the page to help you locate the Gmail API section.

6. Click the ENABLE button to enable this API in your project.

7. Once it's enabled go back to your project Dashboard and open the OAuth consent screen that you can find in the same APIs & Services section.

8. You are presented with two options on the OAuth consent screen:

  • Internal
  • External

If you are part of an organization and you want to connect email accounts belonging to your organization only you can choose Internal. If you are not part of an organization or you want to connect also personal email addresses then you'll have to choose External.

9. Enter details of your OAuth consent screen

10. Enter the scopes your app can use by clicking the Add or remove scopes button and find the https://mail.google.com/ scope. Click the checkbox next to it then hit the Update button.

11. On the next screen you are asked to add your Test users, so essentially the users / email addresses which you are going to be able to connect with LiveAgent.

12. Once you have your users added the OAuth consent screen is set up and you need to create your OAuth Client ID under the Credentials screen.

13. As the Application type you need to select Website application, provide some name to the credentials so you know what they are used for and you must add an Authorized redirect URI pointing to https://your.domain /scripts/oauth_connector/callback.php. Make sure you replace "your.domain" part in the example URL with your actual LiveAgent installation URL.

14. Once you have the credentials created you are presented with your client ID and client secret which you need to enter in your LiveAgent admin under Configuration->App-based integrations->Google oauth app.