Setup custom GMail OAuth

You can use Your own OAuth to connect your gmail account. Please follow the steps below.

1. Setup Google Cloud Project

• Sign in to the Google Cloud Console
• Create a new project by name "ChakraHQ Gmail Connect" and select the same
• Open the left nav bar from top-left icon and Select "APIs & Services"

• Click Enable APIs & Services

• Search for and select "Gmail API", Click Enable

• Go back & Click Enable APIs & Services again
• Search for and select "Cloud Pub/Sub API", Click Enable

• Search for and select "Google People API", Click Enable

2. Set up the OAuth consent screen

• Go back to home screen of "APIs & Services"
• Open the left nav bar from top-left icon and click "OAuth Consent Screen"

• Click "Get Started" from the overview screen

• Under Project configuration > App Information
• Enter App Name as "Your BusinessName Gmail Connect"
• Select/Add a User support email
• Click Next

• Under Audience
• Select Internal
• Click Next

• Under Contact Information
• add a contact email address(es)
• Click Next

• Under Finish
• Click and check the Google API Services data policy
• Check "I agree to the Google API Services data policy"
• Click CONTINUE
• Review all information and click "CREATE"

3. Create OAuth Client

• Select "Clients" from the left navigation bar

• Click "Create Client"

• Select "Web Application" under "Application Type"

• Name the app "ChakraHQ"
• Under "Authorised JavaScript origins"
• Click "Add URI
• Enter the url - "https://app.chakrahq.com" without quotes
• Under "Authorized redirect URIs"
• Click "Add URI"
• Enter the url - "http://api.chakrahq.com/auth/google-custom/callback" without quotes
• Click "CREATE"
• you should see the newly created client listed under "OAuth 2.0 Client IDs"
• Click the newly created client to show its details page

4. Configure Pub/Sub Topic

• Search for Pub/Sub in the top search bar and select the same

• Click "Create Topic" from the top bar

• Under Topic Id enter "gmail-listener" without quotes

• You will be redirected to the topic page
• Here click "Create Subscription" under Subscriptions
• Under Subscription ID, enter "gmail-webhook" without quotes

• Under Delivery Type, select "Push"
• Under Endpoint Url, enter "https://api.chakrahq.com/v1/ext/external-email-account/custom-gmail-events" without quotes

• Under Retry Policy, Select "Retry after exponential backoff delay"

• Click "Create"
• Now you need to provide permisssions to Gmail to this topic
• Click "Topics" from the left hand nav
• Click the "gmail-listener" topic to go its details page
• On the right sidebar, locate the "PERMISSIONS" tab
• Click "Add Principal"

• This will open a principal creation drawer
• Under "New Principals" enter the address - "gmail-api-push@system.gserviceaccount.com" without quotes
• Under role, search for "publisher" and select "Pub/Sub Publisher"

• Click "Save" to save these permissions

5. Configure Custom OAuth On ChakraHQ

• Go to app.chakrahq.com and login if not logged in.
• Ensure you have admin privileges
• Go to Admin > Email Inboxes
• Click "Connect Gmail" from the top right corner
• Toggle the switch named "Use Custom OAuth?"

• Now enter the required information
• "clientId"
• • You can obtain this information from the OAuth client page created in the earlier step
• "clientSecret"
• • You can obtain this information from the OAuth client page created in the earlier step
• "Project ID"
• • Go to Google Cloud Home
  • Select the project created in the earlier steps
  • You should see the project details as shown in the screenshot below
  • Copy the "Project ID" value
    
• On Chakra Gmail OAuth Configuration page
• Click "Save"
• Refresh the webpage
• Click "Connect GMail"
• Click the "Sign in with google" button now
• Complete the connection steps