Google Gmail Integration

Overview

Amity's integration with Google G Suite Gmail imports email messages and stores them as engagements.

Once enabled, the integration will check for new messages every hour.

 

Requirements

Amity uses a Google service account to access email in your company's G Suite Gmail system.

Before Amity can import email from Gmail, you must ask your system administrator to do the following:

  1. Enable API access
  2. Grant API client access to Amity's service accounts 
  3. Provide the email address of your system administrator

 

Part 1 - Enable API Access

  1. Log into https://admin.google.com.

  2. Click the Security icon in the Admin console section.  If you do not see the Security icon, click on the More Controls button at the bottom of the page.

  3. Click API reference.

  4. Look for the API access section.  Click the Enable API access checkbox.

  5. Click the Save button.

Part 2 - Grant API client access to Amity's service account

  1. Scroll down and click Show more.

  2. Click Advanced settings.

  3. Look for the Authentication section.  Click Manage API client access.

  4. Copy the following value into the Client Name field:

    303054567953-f5jtb6n089emgu4fg4g03oa1dg2030fa.apps.googleusercontent.com

    This value is the unique client name that Google created for Amity's service account.

  5. Copy the following API scopes into the One or More API Scopes field:

    https://mail.google.com/,https://www.googleapis.com/auth/admin.directory.group.readonly,https://www.googleapis.com/auth/admin.directory.user.readonly

  6. Click Authorize.

The final result will look like this:Google_manage_API_client_access.png

 

Part 3 - Provide email address

Once part 1 and 2 are complete, provide the email address of your G Suite system administrator to your Amity Customer Success Manager.  

 

Limitations

Email messages can consist of multiple parts. Each part has a type.  The types are plain text, HTML text, and binary file attachments (photos, documents, spreadsheets, etc.)

Email software like Gmail, Apple Mail, Hotmail, etc. can parse all types. Amity does not parse HTML text or binary attachments. Our implementation is currently limited to plain text.

That means that if the email only contains an attachment or HTML text, the message body will appear empty in the Amity engagement.

This limitation is rarely a problem because the vast majority of email applications will generate both plain text and HTML text whenever a message is created.

 

 

 

 

 

Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.
Powered by Zendesk