Nextiva Contact Center - Gmail OAuth2 Configuration

OAuth (Open Authorization) is an open standard for token-based authentication and authorization which is used to provide single sign-on (SSO). OAuth allows an end user's account information to be used by third-party services without exposing the user's password.

NCC relies on the OAuth2 protocol to obtain a token linked to a specific Gmail email account and use the token for the emailing functionalities in NCC.

NCC Steps

1. In your NCC account select the Email Account object.
   
   
2. Create a new email account or modify an existing account.
   
   
3. In the Information tab, set the “Type” to Gmail Client ID.
   
   
4. In the Email Configuration tab, enter the “Gmail Client Id” and “Gmail Client Secret” obtained from a Google Cloud Platform OAuth 2.0 Client ID credential.
   
   
5. If creating a new email account, click Save, otherwise the information will update automatically.

Google API steps

To configure the necessary credentials please refer to the following documentation: https://developers.google.com/workspace/guides/create-credentials#oauth-client-id; On the documentation select Web Application as the Application type for specific instructions about how to create an OAuth client ID and follow those steps

1. Enter a name for the OAuth Client ID, we recommend using some variation of NCC or Nextiva Contact Center.
   
   
2. Ignore the Authorized JavaScript origins field, NCC does not use this.
   
   
3. In the Authorized redirect URIs field enter https://nextiva.thrio.io/provider/login/oauth2/code/google
   
   
   
   
4. Click Create.

NOTE:

• Your Google project needs to have the Gmail API enabled for this integration to work, see https://cloud.google.com/endpoints/docs/openapi/enable-api for more information.
  
  
• The OAuth 2.0 Client ID type credential works alongside an OAuth consent screen, to configure one please refer to the following documentation: https://developers.google.com/workspace/guides/configure-oauth-consent
  
  
• In your Google project, the authorized domain should be thrio.io
  
  
  
  
• The email address configured in the NCC UI must exist within the domain of the Google project.
  
  
• After saving the email account with the changes above, it's important to click on the Gmail Icon in the upper-right corner of the screen, this will open a pop-up window where users will be prompted to select an account to log in with. The chosen account must be the same as the one configured in the NCC UI. After authenticating, the user will be prompted to give consent to the Modify Scope for the Gmail API (More information here: https://developers.google.com/identity/protocols/oauth2/scopes#gmail)