Skip to main content

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:
  1. Gmail/Workspace (OAuth)
  2. Outlook/Microsoft 365 (OAuth) 3)Custom SMTP/IMAP

Gmail (OAuth)

Steps:
  1. In the Email Accounts panel, choose Gmail.
  2. Select an agent in Assign agent.
  3. Press Connect Gmail (OAuth).
  4. Complete the Google Flow and return to the portal.

Outlook (OAuth)

Steps:
  1. In the Email Accounts panel, choose Outlook.
  2. Select an agent in Assign agent.
  3. Press Connect Outlook (OAuth).
  4. Complete the Microsoft flow and return to the portal.

SMTP/IMAP (Custom)

Steps:
  1. Press Add via SMTP/IMAP.
  2. Complete Account Information and SMTP Settings.
  3. (Optional) Complete IMAP Settings for incoming emails.
  4. Press Add Account.
Fields: Account Information
FieldMandatoryFormatExampleNote
Email AddressYesvalid emailsupport@acme.comConnected account
Display NameNotextAcme SupportDisplay name
SignatureNolong textRegards, AcmeAccount signature
Auto-Reply LanguageYeslanguage or auto codecarAuto = sender mirror
Assign agentYesselectionSupport AgentRequired for AI
Generate AI ResponsesNocheckboxON/OFFCreate AI drafts
Fields: SMTP Settings (Outbound - Required)
FieldMandatoryFormatExampleNote
SMTP HostYeshostnamesmtp.gmail.com-
PortYesnumber587-
SMTP UsernameYestextuser@acme.com-
SMTP PasswordYestext********-
Use TLS/SSLNocheckboxONRecommended
Fields: IMAP Settings (Inbound - Optional)
FieldMandatoryFormatExampleNote
IMAP HostNohostnameimap.gmail.comRequired to receive
PortNonumber993-
IMAP UsernameNotextuser@acme.com-
IMAP PasswordNotext********-
Use TLS/SSLNocheckboxONRecommended

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 Accounts

Email Configuration (per account)

Quick route: Inbox -> account card -> Edit

Account Configuration

Fields:
FieldMandatoryFormatExampleNote
From NameNotextHelios SupportSender name
Assigned AgentYesselectionSupport AgentRequired for AI
Account SignatureNolong textRegards, Applies when sending
Available signature variables:

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.
Key fields (Auto-Reply Guard):
FieldUsageExample
Additional blocked sender tokensBlock senders with tokensnoreply, billing
Additional blocked domainsBlock domainsnoreply.company.com
Allowed reply domainsOnly reply to domainsyourcompany.com
Block headersBlock by headersList-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:
FieldMandatoryFormatExampleNote
Enable Daily SummaryNocheckboxONActivate summary
Send TimeYes (if enabled)HH:MM08:00Local time
TimezoneYes (if enabled)timezoneAmerica/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:
  1. Subject
  2. Summary (Generate/Refresh summary)
  3. AI-Generated Response (editable)
  4. Original Message
  5. Metadata (Received, Assigned agent, Send using, Signature)
  6. Analysis (Intent, Sentiment, Category, Tags)
Actions: -Regenerate Response
  • No Reply Needed
  • Approve & Send
  • Refresh summary / analysis
  • Reassign agent
  • Choose shipping account (Send using)
  • Choose signature (My / Agent / Account / None)
Important notes:
  • If Auto-reply blocked, the system deactivates AI and asks for confirmation to send.
  • To send, the response field must not be empty.
Email Detail

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.