Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.heylua.ai/llms.txt

Use this file to discover all available pages before exploring further.

Overview

Email integration allows your agent to automatically respond to emails. There are two modes:
  • Generated inbox - Lua creates a dedicated email address for your agent (e.g. [email protected])
  • Existing email - Use your own email address (e.g. [email protected]) with forwarding

Professional

Business-appropriate channel

Universal

Everyone has email

B2B Friendly

Preferred for business

Threaded

Conversation threading

How It Works

1

Lua Creates Inbox

A dedicated email address is generated for your agent
2

User Sends Email

Customer emails the generated address directly
3

Agent Processes

Agent reads and understands email
4

Agent Responds

Agent sends reply via email
5

User Receives Reply

Reply appears in their inbox

Connection Method 1: CLI

$ lua channels
βœ… Using agent: myAgent

? What would you like to do? πŸ”— Link new channel
? Select channel type: πŸ“§ Email

? Select email channel mode: πŸ“¬ Generate new inbox
? Enter display name (shown in email header): Support Team

πŸ“‘ Creating Email channel...

βœ… Email channel created successfully!

πŸ“§ Display Name:    Support Team
πŸ“¬ Email Address:   [email protected]

────────────────────────────────────────────────────
Your agent's email inbox has been created.
────────────────────────────────────────────────────

Share this address with your customers or use it
in your workflows:
   [email protected]

Emails sent to this address will be handled by
your agent.
────────────────────────────────────────────────────
No additional setup required β€” your agent is ready to receive emails immediately.

Connection Method 2: Admin Dashboard

1

Open Admin

lua admin
Channels β†’ Connect New Channel β†’ Email
2

Email Configuration Form

Email form
Screenshot: Form with Mode selection, Display Name, and Email Address fields
3

Click Create Channel

Creating
4

Get Forwarding Address

Forward address
Screenshot: Success screen showing:
  • Unique forwarding address
  • Copy button
  • Setup instructions link

Email Provider Setup

Gmail Forwarding:
  1. Open Gmail Settings
  2. β€œForwarding and POP/IMAP” tab
  3. β€œAdd a forwarding address”
  4. Paste Lua forwarding address
  5. Check verification email
  6. Click verification link
  7. Return to Gmail settings
  8. Enable β€œForward a copy”
Gmail forwarding
Screenshot: Gmail forwarding settings page

Testing

1

Send Test Email

To: [email protected]
Subject: Test
Body: Is this working?
2

Check Admin Dashboard

Email received
Screenshot: Admin showing received email
3

Agent Responds

Response received
Screenshot: Response in your email inbox

Best Practices

Email is formal - configure persona accordingly
  • Aim for < 1 hour response
  • Set auto-reply for delays
  • Mention expected response time
  • Use proper paragraphs
  • Include signature
  • Format lists clearly
  • Proofread responses

Next Steps

Website Widget

Add chat to website

All Channels

View all options