Knowledge Base
  1. Home
  2. Knowledge Base
  3. Documentation
  4. Creating the Heroic Inbox Google App

Creating the Heroic Inbox Google App

The Heroic Inbox plugin requires a Google App to access Gmail inboxes, send and receive mail on behalf of the plugin.

Once the App creation is complete, a Client ID and Client Secret will be generated, which can be entered in the Heroic Inbox setup assistant during installation.

1. Register a New Project

Log into the Google Cloud Platform, click the Select a Project dropdown (the current project name may already be selected) to show the Projects in the current organization.

In the project management dialog, click NEW PROJECT.

Give the project a descriptive name such as Heroic Inbox Project and click CREATE.

In the notifications area, select the new project to switch to management of the new project.

2. Enable the Gmail API

Now the project has been created, the Gmail API needs to be enabled.

In the APIs and Services tab or Quick access shortcut, click APIS AND SERVICES, then search for Gmail.

Select the Gmail API and click ENABLE to activate.


3. Create Credentials

Once you’ve activated the Gmail API, you’ll need to create OAuth credentials.

You first need to create an OAuth consent screen, this will be displayed when you allow Heroic Inbox to access Gmail messages.

In the OAuth consent section, select the user type as Internal – this permits the app to access any accounts within the organisation. Click Create

In the App Information section set a meaningful App name, such as Heroic Inbox App. From the User support email dropdown, pick an appropriate contact email. The same Email address can be used in the Developer contact information section.

Enter the URL of the site the Heroic Inbox plugin will be used on in the Authorised domains section. All the other sections (not marked with *) do not need to completed.

Click <strong>SAVE AND CONTINUE<strong>

2. Scopes

Nothing needs to be changed from the default in the Scopes section, this will be set automatically by the App on first use.

Click <strong>SAVE AND CONTINUE<strong>

A summary will be displayed, review this and click to go back to the Google App dashboard.

3. Create OAuth Client ID

In Credentials Section click CREATE CREDENTIALS.

Next, select Web Application as the Application type.

Inthe OAuth Client ID section, select the Application type as Web application from the dropdown. Give the client a meaningful Name, such as Heroic Inbox WordPress Plugin.

Switch back to the Heroic Inbox setup assistant screen, which may look similar to the screen below to obtain the Authorised redirect URI.

The authorised redirect URI, if not displayed, is in the form example.com/wp-admin/?page=ht_desk_gmailbox_setup_callback where example.com should be substituted for your site url.

Click <strong>CREATE<strong>

5. Obtain Credentials 

Once the client has been created a dialog will appear. Copy the Client ID and Client secret into Heroic Inbox setup assistant and continue with remainder of the setup process.

<< RETURN TO HEROIC INBOX DOCUMENTATION

Was this article helpful?
Related Articles