Introduction


Do you want to save time and effort by automatically turning emails into leads in your SuiteCRM? With the SuiteCRM Email to Anything package, you can integrate

SuiteCRM with Gmail API and Google Cloud Pub/Sub to extract data from incoming emails and create CRM records in real time.

In this guide, we’ll walk you through the step-by-step process of setting up this powerful integration.




Step 1: Install SuiteCRM Email to Anything Package


Before you begin, install the necessary package in SuiteCRM.

  1. Go to the Admin Panel in SuiteCRM.

  2. Click on Module Loader.

  3. Locate the SuiteCRM Email to Anything package.

  4. Click Install, then Commit.

  5. Wait for the installation to finish. The license should activate automatically.

Step 2: Set Up Google Developer Console


To enable Gmail API integration, you need to configure the Google Developer Console.

  1. Search for Google Developer Console and open the site.

  2. Go to the Dashboard and create a New Project.

  3. In the search bar, type "topic" and select Pub/Sub Topic.

  4. Click Create Topic and give it a name.

  5. Click Create to finalize the topic setup.


Step 3: Add Permissions in Google Cloud


To ensure smooth communication between Gmail API and SuiteCRM, you need to assign the right permissions.

  1. Navigate to your Pub/Sub Topic.

  2. Click Add Principals (found on the right side of the screen).

Add this Gmail API Push Service account:


perl


CopyEdit



[email protected]  

  1. Assign the Owner role.

  2. Click Save and confirm the permissions in the Role and Principals section.


Step 4: Configure Inbound Email in SuiteCRM


Now, set up SuiteCRM to listen for incoming emails.

  1. In SuiteCRM Admin Panel, go to the SuiteCRM Email to Anything section.

  2. Enter the email address you want to extract data from.

  3. Check the Active box to enable it.

  4. Copy the Topic Name from Google Cloud Console and paste it into SuiteCRM.


Step 5: Set Up API and OAuth Credentials


Now, create and connect the necessary API credentials.

  1. In Google Cloud Console, go to API & Services → Credentials.

  2. Open the OAuth Client. If you haven’t created one, follow Google’s OAuth setup guide.

  3. Copy the Client ID and Client Secret.

  4. Paste them into SuiteCRM.

  5. Click Save.


Step 6: Connect Webhook and Redirect URL


After saving, SuiteCRM will generate a Webhook URL and a Redirect URL.


Set Up the Webhook URL:


  1. Copy the Webhook URL from SuiteCRM.

  2. Go to your Google Cloud Pub/Sub Topic.

  3. Click the Subscription ID.

  4. Click the Edit icon.

  5. Set Delivery Type to Push.

  6. Paste the Webhook URL into the Endpoint URL field.

  7. Scroll down and click Save.

Set Up the Redirect URL:


  1. Copy the Redirect URL from SuiteCRM.

  2. Open the OAuth 2.0 client in Google Cloud Console.

  3. Add the Redirect URL to the Authorized Redirect URIs.

  4. Click Save.


Step 7: Sign In with Google


Now, authorize Gmail API access in SuiteCRM.

  1. Go back to SuiteCRM.

  2. Click Sign in with Google.

  3. Choose the email account you configured for inbound emails.

  4. Click Allow to grant access.

  5. If everything is set up correctly, you’ll see a success message.


Step 8: Configure Receiver Settings


  1. Refresh the SuiteCRM Admin Panel.

  2. Go to Receiver Settings.

  3. Save in the Leads module, but you can change this to another module if needed.


Step 9: Test the Integration


  1. Ensure your Leads module is empty before testing.

  2. Have a client fill out a web form that sends an email to your configured inbox.

  3. Go to the Leads module in SuiteCRM.

  4. You should see a new lead record created instantly.

  5. Open the record to verify that all data has been properly extracted and assigned.


Conclusion


By integrating SuiteCRM with Gmail API and Google Cloud Pub/Sub, you can automate lead generation and contact creation directly from incoming emails. This setup

eliminates manual data entry, improves accuracy, and saves valuable time.

Are you ready to take your SuiteCRM automation to the next level? Get started with SuiteCRM Email to Anything today and streamline your CRM workflow