Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info

CloudCX Connector Hub provides integration with Gmail via the API for Google. The configuration is done server-side, in an easy and straightforward way. Let's follow the instructions step by step to complete the integration with Gmail.

Note

If users in your system intend to utilize the Gmail channel or Gmail SMTP server, configuring this application setting is crucial.
Failure to do so may result in the user receiving a warning message from Google when attempting to connect the Gmail.

Table of Contents

Create A Project

To integrate with Gmail, you have to create a project in the Google Cloud portal. You can find more details about creating a project https://cloud.google.com/resource-manager/docs/creating-managing-projects?_gl=1*1etkyrs*_ga*Nzc1OTUzMzMxLjE3MjI0MTA4ODY.*_ga_WH2QY8WWF5*MTcyNDY2MjUyNi4yLjAuMTcyNDY2MjUyNi42MC4wLjA. .

Create A Project

  1. Go to the Google Cloud portal.

  2. Click on “Select a project”, and click on “NEW PROJECT” to create a new project.

1-20240826-092430.PNG
  1. Enter a Project name for your project, click on “CREATE” to create it.

2-20240826-092654.PNG
  1. After creating the project, click on “SELECT PROJECT” to configure.

3-20240826-093000.PNG

Create An App

  1. Go to APIs & Services > Enabled APls & services, click on “ENABLE APIS AND SERICES”.

5-20240826-100625.PNG
  1. Find the ”Gmail API“ card, Click on “ENABLE” to enable this API.

7-20240826-100954.PNG
  1. Click on OAuth consent screen, select External User Type and click on “CREATE” to create an app for the project.

8-20240826-101906.PNG
  1. In the OAuth consent screen step, enter the App name and User support email for this app.

9-20240826-102047.PNG
  1. Enter your domain your_domain to the Authorized domains, your email address to the Developer contact information, then click on “SAVE AND CONTINUE”.

10-20240826-102732.PNG
  1. In the Scopes step, click on “ADD OR REMOVE SCOPES”, select the scope “…/auth/userinfo.email”and click on “UPDATE”, then click on “SAVE AND CONTINUE”.

11-20240826-103540.PNG
  1. In the Test users step, click on “SAVE AND CONTINUE”.

12-20240826-103946.PNG
  1. In the Summary step, click on “BACK TO DASHBOARD”.

13-20240829-061743.PNG
  1. Click on “PUBLISH APP” to push the app to production.

14-20240826-104526.PNG

Configure the App

  1. In the Credentials, click on “+CREATE CREDENTIALS” to select “OAuth client ID”.

15-20240826-105020.PNG
  1. Select Web application from Application type, add the Authorized Redirect URL https://your_cx_domain/api/v1.0/gmail/integration/callback to the Authorized Redirect URIs, then click on “CREATE”.

16-20240826-105352.PNG

Once you create OAuth client ID, you will have to obtain the Client ID and Client Secret. These values will be required while setting up in the Connector Hub.

17-20240826-105946.PNG

Configure Gmail Integration in CloudCX

Log in to your system administrator portal https://your_cx_domain:9006, go to Advance > Connector Hub Setting > Gmail to configure.

18-20240826-110402.pngImage Removedimage-20241101-085043.pngImage Added

That's all the Gmail integration, now, you can connect your Gmail account to the Inbox > Channels > Email in your tenant https://cloudfon.atlassian.net/wiki/spaces/CX/pages/49283141/3.1.1+Email#Gmail or your SMTP server 9.2.2 Custom SMTP Server

Warning Message

This warning message indicates that the Gmail application, configured on the System Connect Hub, is incorrect or invalid.

img_v3_02e5_f729759e-2ea8-47a6-b490-fe5a124fa94g-20240903-094039.jpg