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:

Multi-device synchronization: Emails remain stored on the server and can be accessed through multiple clients.
Remote management: Supports marking emails as read, deleted, or archived directly on the server.
Partial download: Allows previewing email content without downloading the entire email.

How to Use IMAP in Automation

In Bika.ai automation, you can use the Inbound Email trigger to initiate an automation workflow whenever the target email account receives an email.

Adding an IMAP Integration

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.

How to Configure IMAP Integration

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:
- Gmail: imap.gmail.com
- Outlook: outlook.office365.com
- Yahoo: imap.mail.yahoo.com
- QQ Mail: imap.qq.com
Port (Port Number) Specifies the network port for the IMAP server. Common port numbers include:
- 993 (default, SSL/TLS encryption)
- 143 (STARTTLS encryption, less commonly used) Modern email services typically recommend using port 993 for security.
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.

Gmail Configuration Example

IMAP Service: Use imap.gmail.com
Port Number: Default is 993, no changes needed
Username: Your Gmail email address
Password: Use an app-specific password from your Google account

Gmail 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.

Monitoring the Inbox Folder

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.

Custom Email Retrieval Rules

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:

Retrieve only unread emails: ['UNSEEN']
Emails with subject containing "hello" and sent from ana@gmail.com: [['SUBJECT', 'hello'], ['FROM', 'ana@gmail.com']]
Unread emails received after April 20, 2024: ['UNSEEN', ['SINCE', 'April 20, 2024']]

Downloading Attachments

When Download Attachments is enabled, email attachments will be saved. You can select them later in the workflow using the Variable Selector.

Running a Test

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.

Recommend Reading

Recommend AI Automation Templates

Lightweight CRM

A lightweight CRM template designed to manage companies, contacts, sales pipelines, investor opportunities, and activities efficiently

AI Automated Product R&D Management

AI Automated Product R&D Management helps teams efficiently control the entire product process, covering requirements-tasks-BUG management. Based on AI-structured data intelligent analysis and optimization, it automatically generates iteration reports and improves collaboration efficiency.

LinkedIn Post Automation

You can use this template to achieve AI automated Linkedin posts, read the prepared Linkedin content in the database, and automatically post to help you increase the exposure of social media and also automatically record their public URLs in your database for tracking engagement.

Coming soon

7-Day Automated Email Marketing

Quickly set up a 7-day automated email outreach, especially suitable for scenarios including: continuous contact with potential customers, product launch countdown marketing, and ongoing welcome emails for new registrants.

Onboard & Engage: New User Welcome Automation

Kickstart user engagement with this automated welcome series. Begin with a warm welcome email and give users the option to unsubscribe. For those who stay engaged, send a follow-up email 4 days later asking for valuable product feedback. Track open rates and retention, while ensuring unsubscribed users are excluded from further emails. 🔖Tip: You can customize email content with HTML for a richer experience. Please replace the unsubscribe link in your emails with the share link to the "Unsubscribe Form" you’ve created.

NPS Customer Referral Value

This template aims to provide an automated Net Promoter Score (NPS) follow-up form system for the company's Client Server team, Product Manager, market researchers, and company management. Through this system, you can achieve real-time monitoring and reminders of customer feedback, automatically collect and process new data, and display analysis results through intuitive dashboards to help the team more efficiently understand customer satisfaction and improvement directions.