Gmail

Learn how to connect Engini to Gmail.

Using Engini’s gmail activities, you can check for new sent emails, send emails and include attachments seamlessly.

To get started with the gmail app, create an free account at Google.com or use your organizational google mailbox.

Getting Started with Gmail #

Prerequisites #

• An Gmail account.

Add a connection to Gmail in Engini #

1. Enter your Engini account at https://app.engini.io.
2. Navigate to Connections page by clicking on the Connections on the left sidebar or by clicking here.
3. Click on the Add connection option located at the topbar.
   
4. Choose Gmail option from the available applications.
   
5. Enter the following details in the “Add Connection” form:
   
   • Connection name
   • Fields automatically populated post connecting to a Google account include:
     • Email: Used as the primary email address associated with the account.
     • Display Name: Employed when utilizing the email sending activity, enabling customized sender names.
     • Access Token: A token for authorization to access Google services.
     • Refresh Token: A token used to obtain a new access token when the current one expires.
   • Click on the “Sign in with Google” button.
   • Sign into your Google account.
   • Click on the save button to save the connection.

Trigger #

Check for new emails #

The trigger monitors the mailbox, listening for new emails sent to the connected mailbox at scheduled intervals as defined.

1. Choose the Gmail software.
2. Click on the “Check for new emails” trigger.
3. Starting (UTC)
   Select the start date and time for the scheduled trigger.
4. Recur every
   Choose the time interval for triggering and checking emails. The minimum time interval is 15 minutes.
5. Add time frame
   You can specify a time frame during which the trigger will operate.
   
   1. Click on “Add time frame” button.
   2. Select a specific time frame to activate the trigger.
      For example, every 15 minutes from 8 AM to 5 PM.
6. Select a filter if necessary:
   
   1. Click on “Add Filter” button.
   2. To select an item from the list, click the small arrow.
   3. Choose the field on which you want to apply the filter from the drop-down.
   4. Select the condition.
   5. Choose the value for which you want the condition to be met.
      For example, to receive emails with attached files:
      • Choose “include attachment” from the drop-down.
      • Select the condition “equals.”
      • Click the empty field and in the pop-up window, choose “true.”

Email’s properties #

Let’s understand what the properties received are:

1. Body – The body property contains the entire message body in formal HTML format.
2. CC – The “CC” contains a string with all the emails included in the CC (carbon copy) field. The emails are separated by commas within the string.
3. From – The ‘From’ property contains the email address from which the email to this mailbox was sent.
4. Labelids – This property holds the labels associated with the email, providing categorization or classification details.
5. Message Id – This property contains the unique identifier for the email for use in subsequent actions.
6. Received Datetime – The ‘Received date time’ received is in the Israeli time zone (UTC + 3) and includes both the date and time.
7. Size Estimate – It indicates an estimated size or storage space occupied by the email content.
8. Snippet – It presents a brief excerpt or summary of the email content for quick insight or preview.
9. Subject – It contains the email subject.
10. Threadid – This property carries the identifier linking the email to its respective email thread or conversation.
11. To – The ‘To’ property contains a string with all the email addresses to which the email received by this mailbox was sent. If the email was only sent to this mailbox, only the email address of this mailbox will appear. If the email was sent to additional email addresses, the email addresses will be separated by commas in the string.

Actions #

Sent Email #

Send Email when using your gmail account.

1. To
   Enter the recipient’s email address.
   1. Click on the empty field, and a tooltip will appear, displaying the email fields you can use.
   2. From the tooltip, select the recipient’s email address, or you can use a static value.
      When using strings, be sure to enclose them in single quotes (‘).
2. Subject
   Fill in the email subject.
   1. Populate the field with Static value – number / string. when using strings, you need to surround them with single quotes (‘).
   2. You can also use property value from a previous activity (Using the tooltip that opens when clicking on the field).
3. Body
   The body of an email is the main content of the message you are sending. It is the section where you write the text of your message and convey the purpose or intention of your email.
   1. Click on the empty field next to the label “body.”
   2. A window will open where you can enter the email body.
      
      You can populate the body with:
      • Static value – number / string.
      • Property value from a previous activity (Using the tooltip that opens when clicking on the field).
      • Expression – using functions and/or Previous activity properties and/or static values.
      • Pictures – click on the picture icon.
      • Links – click on the picture icon.
4. Add Field
   
   By clicking the “Add field” button, you can choose how to fill in the various fields. You can add one field to the action or more.
   1. Choose from the drop down the field you want to fill.
      You can choose a field from the following:
      
      • BCC (Blind Carbon Copy): This field allows for recipients to be added in a way that others are unaware of their inclusion in the email.
      • CC (Carbon Copy): This field holds a string comprising email addresses included in the CC field. Multiple emails are separated by commas within the string. You can add addresses to be CC’d on the email.
      • From (Display Name): Specify the sender name from which the recipient will perceive the email to be sent. This value is automatically populated when creating the connection in Engini.
      • Attachments[]: This field allows you to include an array of files attached to the email being sent. To accommodate this field, initiate a attachment array, append the files, and then this array can be integrated into the field. Learn more.
   2. Click on the empty field to the right of the drop down to be shown the tooltip with all the options you can use to fill the field.
   3. You can populate the fields in one of the following options:
      • Static value – number / string. when using strings, you need to surround them with single quotes (‘).
      • Property value from a previous activity (Using the tooltip that opens when clicking on the field).
      • Expression – using functions and/or Previous activity properties and/or static values (Using the tooltip that opens when clicking on the field). 
   4. Repeat steps a-c for all the fields you want to populate.

Initialize attachment array #

To create multiple files that will be sent in the email, you need to initialize an array for the files. Choose this action to initialize the array and give it a name.

Append to attachments array #

Append files to attachments array.

1. To use this action, you first need to initialize an array.
2. Choose the array in which you want to include the files from the drop-down.
3. Specify the file name.
4. Choose the content that the file will contain. Please note that the content should be in base64 format.