Gmail

​

Step 1. Create a Google Cloud Platform project

1. Login to Google Cloud Console with your Gmail account.
2. Select Select a project dropdown in the top navigation. Then, select New Project.
3. Follow the on-screen instructions to create the new project.

​

Step 2. Enable the Gmail API

1. In Google Cloud Console, navigate to the APIs & Services section.
2. Select Library from the left sidebar.
3. Search for Gmail API and select the result.
4. Select Enable to enable the Gmail API for your project.

​

Step 3. Configure the OAuth consent screen

1. In Google Cloud Console, navigate to the APIs & Services section.
2. Select OAuth consent screen in the left sidebar.
3. Select Get Started and fill out the App Information section. Then, select Next.
4. Under Audience, select External
5. Fill in the other required sections, then select Create.
6. Navigate to the Data Access tab, then select Add or remove scopes.
7. Under Manually add scopes, enter the following:

https://www.googleapis.com/auth/userinfo.email
https://www.googleapis.com/auth/userinfo.profile
https://www.googleapis.com/auth/gmail.readonly
https://www.googleapis.com/auth/gmail.send

8. Select Add to table, then Update.
9. Select Save at the bottom of the screen.
10. Navigate to the Audience tab. Under Test users, select ** + Add users**.
11. Add an email address for testing the app, then select Save.

​

Step 4. Create OAuth credentials

1. In Google Cloud Console, navigate to the APIs & Services section.
2. Select Credentials in the left sidebar.
3. Select Create credentials, then OAuth client ID.
4. Select Web application as the application type.
5. Enter a name for the OAuth client ID.
6. Under Authorized redirect URIs, enter https://botpress.com.
7. Select Add URI, then Create.
8. Copy the Client ID and Client secret for use in the next steps.

​

Step 5. Create a service account

1. In Google Cloud Console, navigate to the IAM & Admin section.
2. Select Service accounts in the left sidebar.
3. Select Create service account.
4. Enter a name for the service account. Then, select Done.

6. Copy the service account email address for use in the next steps.

​

Step 6. Create a Pub/Sub topic

1. In Google Cloud Console, search for and navigate to the Pub/Sub section.
2. Select Topics in the left sidebar.
3. Select Create topic.
4. Enter a name for the topic in the Topic ID field.
5. Uncheck the Add default subscription checkbox. Leave the other options unchanged.
6. Select Create to create the topic.
7. Copy the Topic name for use in the next steps.

​

Step 7. Grant publish rights on the Pub/Sub topic

1. In Google Cloud Console, search for and navigate to the Pub/Sub section.
2. Select Topics in the left sidebar.
3. From the topic list, find the topic you created earlier. Then, select the triple-dot ⋮ button on the right.
4. Select View permissions from the dropdown menu.
5. Select Add principal.
6. Under Add principals, enter [email protected].

7. Under Assign roles, select Pub/Sub Publisher.
8. Select Save to grant publish rights to the service account.

​

Step 8. Generate a shared secret

1. Generate an alphanumeric string to use as a shared secret for signing Pub/Sub push events. We recommend using a string with at least 32 characters.

2. Copy this string for use in the next steps.

​

Step 9. Create a Pub/Sub subscription

1. In Google Cloud Console, search for and navigate to the Pub/Sub section.
2. Select Subscriptions in the left sidebar.
3. Select Create subscription.
4. Enter a name for the subscription in the Subscription ID field.
5. Select the topic you created earlier from the topic dropdown.
6. Under Delivery type, select Push.
7. Enter your integration’s Botpress-provided webhook URL in the Endpoint URL field. To this URL, add ?shared_secret=, followed by the shared secret you generated earlier.

8. Check the Enable authentication checkbox.
9. Select the service account email address you created earlier in the Service account field.
10. Enter the shared secret you generated earlier in the Audience field.
11. Under Expiration period, select Never expire.
12. Under Acknowledgement deadline, enter 60 seconds.
13. Under Retry policy, select Retry after exponential backoff delay. Set the minimum backoff to 60 seconds and the maximum backoff to 600 seconds.
14. Select Create to create the subscription.

​

Step 10. Authorize the OAuth application

1. On Gmail, log in to the Google account you want to use with the Gmail integration.
2. Once logged in, go to the following URL in your browser:

3. Follow the on-screen instructions to authorize the OAuth application with your personal Gmail account.

4. Copy the authorization code from the URL in your browser’s address bar. The authorization code is the string that appears after code= and before &scope= in the URL.

5. You can now safely close this page.

​

Step 11. Configure the integration in Botpress

1. In Botpress Studio, select Explore Hub in the upper-right corner.
2. Search for the Gmail integration, then select Install Integration.
3. In the Configuration menu, select Configure manually with your own GCP App.
4. Fill in the required fields with all the information you saved from the previous steps.

10. Select Save Configuration. If no error message is displayed, the integration was successfully configured.