IMAP (Internet Message Access Protocol) is a protocol used to retrieve emails from a mail server. Unlike POP3, IMAP allows emails to be stored on the server and accessed from multiple devices simultaneously.
Key features of IMAP include:
In Bika.ai automation, you can use the Inbound Email trigger to initiate an automation workflow whenever the target email account receives an email.
In the trigger configuration, you must first select an IMAP integration. If you have already set up an integration in the Space Station settings, you can directly select and use it. If not, you can connect your email account here.
Click Create Integration, and a popup window will appear for configuring IMAP. Several parameters need to be set. Below are common IMAP configuration options and their meanings:
MAP Server (IMAP Server Address) Specifies the mail server address used to receive emails. This is typically the IMAP server domain of the email provider. Examples include:
imap.gmail.comoutlook.office365.comimap.mail.yahoo.com imap.qq.comPort (Port Number) Specifies the network port for the IMAP server. Common port numbers include:
Username
The login name for the email account, usually the full email address (e.g. yourname@gmail.com).
Password (Password or Authorization Code) The credentials required to access the mail server. Some email services (such as Gmail, Outlook, and QQ Mail) require an app-specific password or authorization code instead of the regular account password.
imap.gmail.comGmail no longer supports simple password authentication. You must first create an app-specific password for IMAP authentication. To do this, go to Google Account Security, enable 2-Step Verification, then create an app password at the bottom of the page. Copy and paste this app password into the IMAP integration password field.
Once the IMAP integration is successfully added, you can retrieve the list of email folders in the Folder Menu. The default selection is the Inbox.
You can specify which folder to monitor. Emails received in other folders will not trigger automation.
If you only want to trigger automation for specific emails, you can add retrieval rules using node-imap syntax to precisely filter emails. Examples include:
['UNSEEN'][['SUBJECT', 'hello'], ['FROM', 'ana@gmail.com']]['UNSEEN', ['SINCE', 'April 20, 2024']]
When Download Attachments is enabled, email attachments will be saved. You can select them later in the workflow using the Variable Selector.
After completing the configuration, click Run Test. This will fetch an email and display the result, confirming that the trigger is set up correctly. You can then proceed to add the required automation steps.
After completing all automation settings, remember to enable automation. Once enabled, the automation will trigger automatically upon receiving an email.
