Gmail Settings

Overview

The Gmail Settings allow you to connect a Gmail account to SupportCandy using Gmail APIs.
After the Gmail connection is configured, SupportCandy can use the Gmail account for Email Piping.
Gmail requires a Google Cloud Project, Gmail API access, and OAuth credentials before it can be connected to SupportCandy.

Where to Find

To select Gmail as the Email Piping connection, go to:
Support → Settings → Email Piping → General
Then select GMail as the connection.

SupportCandy settings email piping gmail
How It Works

SupportCandy uses Gmail APIs to connect to the selected Gmail account.
The setup requires you to:

  1. Select GMail as the Email Piping connection.
  2. Create a Google Cloud Project.
  3. Enable the Gmail API.
  4. Configure the OAuth consent screen.
  5. Create OAuth credentials.
  6. Connect the Gmail account to SupportCandy.
  7. Configure a real-time CRON job for reliable email checking.
Step-by-Step Guide
1. Set connection in general settings
  1. Go to Support → Settings → Email Piping → General.
  2. Select GMail as the Connection.
  3. Save the settings if required.
2. Create a Google Cloud Project

A Google Cloud Project is required to use Google Workspace APIs.

  1. Open the Google Cloud Project creation page.
  2. Create a new project.
  3. Enter a project name, such as SupportCandy.
  4. Create the project.
gmail-imap-1
3. Select the project

After creating the project, it may take a few minutes before it becomes available.

  1. Open the Google Cloud Console.
  2. Select the project you created.
  3. Continue with the Gmail API configuration.
gmail-imap-2
4. Enable Gmail API
  1. Open Menu → APIs and services → Library.
  2. Search for Gmail API.
  3. Select Gmail API from the search results.
  4. Click Enable.
gmail-imap-3
gmail-imap-4
gmail-imap-5
5. Set up OAuth consent screen

Configure the OAuth consent screen for the Gmail API application.

  1. Open the OAuth consent screen section.
  2. Enter the Application Information and click Next button.
  3. Select External as Audience.
  4. Select email address of developer as Contact Information.
  5. Click on I agree and continue to finish the setup.
  6. Click Create.
6. Create new credentials

Create the OAuth credentials required to connect Gmail with SupportCandy.

  1. Go to the Create OAuth Client section.
  2. Start fill the all infor.
  3. Click on create.
  4. You will see the popup appeared on screen.
  5. Copy Client ID & Client secret and download the json for future reference of Client ID and Client secret.
7. Connect to the Gmail APIs

Use the generated Google credentials to connect the Gmail account to SupportCandy.
Follow the Gmail connection process provided in the SupportCandy Email Piping settings.

Example

To connect a Gmail account for Email Piping:

  1. Select GMail under Support → Settings → Email Piping → General.
  2. Create a Google Cloud Project named SupportCandy.
  3. Enable the Gmail API.
  4. Configure the OAuth consent screen.
  5. Create the required OAuth credentials.
  6. Publish the app.
  7. Connect the Gmail account through SupportCandy.
  8. Configure a real-time CRON job.

After the connection is configured, Gmail can be used as the Email Piping connection.

Notes / Tips
  • Gmail Email Piping uses the Gmail API.
  • A Google Cloud Project is required for the Gmail API setup.
  • Make sure the Gmail API is enabled for the selected project.
  • Complete the OAuth consent screen before creating the required credentials.
  • Select GMail under Support → Settings → Email Piping → General.
  • WordPress CRON may not provide consistent email checking when the website has low visitor activity.
  • A real-time CRON job is recommended for reliable Email Piping.
Troubleshooting Tips
1. Email Piping Disconnects After a Few Days

If email piping works initially but disconnects after a few days, this may be related to low traffic on your website.

If your website does not receive visits for several days, WordPress Cron may not run regularly. As a result, the refresh token or access token may expire, and email piping may stop working.

In this case, we recommend setting up an external Cron job. An external Cron service can access your website at regular intervals and trigger WordPress Cron even when your site has little or no traffic.

2. Email Piping Suddenly Stops Working

If Gmail email piping suddenly stops working, try resetting the Gmail connection:

  1. Open the Google Account App Permissions page and make sure you are logged in with the Gmail account used for email piping.
  2. Find and remove the Google app you created for Gmail email piping.
  3. Go to SupportCandy → Settings → Email Piping.
  4. Click Save & Connect. The email address you want to pipe should already be entered.
  5. Select the Gmail account you want to use for email piping.
  6. If you see a “This app isn’t verified” warning, click Advanced.
  7. Click Go to [Your App] (unsafe). This warning appears because you are using your own Google app.
  8. Click Allow to complete the connection.
  9. Send a few test emails to the piped Gmail address.
  10. Wait 2–3 minutes if your email piping Cron is configured to run every minute, and check whether the tickets are created.
What are your feelings