Objective
Manage incoming and outgoing emails with AI and human approval (human-in-the-loop).Access
Sidebar -> Inbox Routes:- /app//inbox (main view)
- /app//inbox/all (all accounts)
- /app//inbox/ (one account)
- /app//inbox/message/ (email details)
Roles
- owner, admin, agent
Prerequisites
- At least one agent with Email channel enabled.
- A connected Email account (Gmail/Outlook OAuth or SMTP/IMAP).
- Integrations with OpenAI or Google if the plan does not include models.
Connect an email account
In Inbox, tap Connect Email Account (or Email Accounts). Options:- Gmail/Workspace (OAuth)
- Outlook/Microsoft 365 (OAuth) 3)Custom SMTP/IMAP
Gmail (OAuth)
Steps:- In the Email Accounts panel, choose Gmail.
- Select an agent in Assign agent.
- Press Connect Gmail (OAuth).
- Complete the Google Flow and return to the portal.
Outlook (OAuth)
Steps:- In the Email Accounts panel, choose Outlook.
- Select an agent in Assign agent.
- Press Connect Outlook (OAuth).
- Complete the Microsoft flow and return to the portal.
SMTP/IMAP (Custom)
Steps:- Press Add via SMTP/IMAP.
- Complete Account Information and SMTP Settings.
- (Optional) Complete IMAP Settings for incoming emails.
- Press Add Account.
| Field | Mandatory | Format | Example | Note |
|---|---|---|---|---|
| Email Address | Yes | valid email | support@acme.com | Connected account |
| Display Name | No | text | Acme Support | Display name |
| Signature | No | long text | Regards, Acme | Account signature |
| Auto-Reply Language | Yes | language or auto code | car | Auto = sender mirror |
| Assign agent | Yes | selection | Support Agent | Required for AI |
| Generate AI Responses | No | checkbox | ON/OFF | Create AI drafts |
| Field | Mandatory | Format | Example | Note |
|---|---|---|---|---|
| SMTP Host | Yes | hostname | smtp.gmail.com | - |
| Port | Yes | number | 587 | - |
| SMTP Username | Yes | text | user@acme.com | - |
| SMTP Password | Yes | text | ******** | - |
| Use TLS/SSL | No | checkbox | ON | Recommended |
| Field | Mandatory | Format | Example | Note |
|---|---|---|---|---|
| IMAP Host | No | hostname | imap.gmail.com | Required to receive |
| Port | No | number | 993 | - |
| IMAP Username | No | text | user@acme.com | - |
| IMAP Password | No | text | ******** | - |
| Use TLS/SSL | No | checkbox | ON | Recommended |
Manage connected accounts
In the account list you can:- Verify: test connectivity.
- Test email: send test email.
- Toggle Active/Inactive. -Assign Agent.
- Delete.
- Edit (opens Email Configuration).

Email Configuration (per account)
Quick route: Inbox -> account card -> EditAccount Configuration
Fields:| Field | Mandatory | Format | Example | Note |
|---|---|---|---|---|
| From Name | No | text | Helios Support | Sender name |
| Assigned Agent | Yes | selection | Support Agent | Required for AI |
| Account Signature | No | long text | Regards, | Applies when sending |
AI Response Settings- Generate AI Responses: create drafts.
- Send Automatically: send without approval.
- Agent Signature: signature of the agent.
- Auto-Reply Language: auto response language.
- Require Manual Review For: High / Urgent.
- Auto-Reply Guard: blocking rules for tokens, domains and headers.
| Field | Usage | Example |
|---|---|---|
| Additional blocked sender tokens | Block senders with tokens | noreply, billing |
| Additional blocked domains | Block domains | noreply.company.com |
| Allowed reply domains | Only reply to domains | yourcompany.com |
| Block headers | Block by headers | List-Unsubscribe |
Email Categorization
- List of active categories. -Enable dynamic categories. -Enable Other category.
- Sync categories to Gmail labels / Outlook categories.
- Archive on label sync (Gmail only).
Daily Summary Email
Set up a daily activity summary. Fields:| Field | Mandatory | Format | Example | Note |
|---|---|---|---|---|
| Enable Daily Summary | No | checkbox | ON | Activate summary |
| Send Time | Yes (if enabled) | HH:MM | 08:00 | Local time |
| Timezone | Yes (if enabled) | timezone | America/Bogota | - |
Inbox (email list)
Main functions:- Search: search by sender, subject, agent, category.
- Account filter: filter by account.
- Direction: inbound / outbound.
- Status: pending, ready_for_review, approved, sent, reviewed, failed, quota_exceeded.
- Agent filter: all, unassigned, or an agent.
- Category filter: all, uncategorized, not_analyzed, or a category.
- Sort: Date or Category.
- Sync: (only in single account view) force synchronization.
Email details
Path: /app//inbox/message/ Main sections:- Subject
- Summary (Generate/Refresh summary)
- AI-Generated Response (editable)
- Original Message
- Metadata (Received, Assigned agent, Send using, Signature)
- Analysis (Intent, Sentiment, Category, Tags)
- No Reply Needed
- Approve & Send
- Refresh summary / analysis
- Reassign agent
- Choose shipping account (Send using)
- Choose signature (My / Agent / Account / None)
- If Auto-reply blocked, the system deactivates AI and asks for confirmation to send.
- To send, the response field must not be empty.

Good practices
- Assign an agent to each account before activating AI.
- Use clear categories for classification.
- Maintain Auto-Reply Guard rules to avoid no-reply responses.
- Use signatures with variables for consistency.
Common errors
- Reconnect required in Gmail: reconnect the OAuth from the card.
- Verify fails: check SMTP/IMAP and credentials.
- AI response does not appear: check agent and LLM provider.