Skip to main content
Send emails to your mixus agent and receive AI-powered responses that understand context, maintain conversation threads, and integrate seamlessly with your workflows.

​
How It Works

​
Email-to-Chat Integration

mixus automatically converts email conversations into internal chat sessions while maintaining proper threading and participant management:

​
Intelligent Email Understanding

The system provides sophisticated email analysis and processing:
Email Analysis Capabilities
{
  "email_intelligence": {
    "intent_classification": {
      "questions": "direct_questions_requiring_ai_response",
      "requests": "action_items_and_task_requests",
      "org_selection": "organization_switching_commands",
      "space_switching": "workspace_navigation_requests",
      "unsubscribe": "opt_out_and_unsubscribe_handling",
      "spam_detection": "automated_spam_and_auto_response_filtering"
    },
    "threading_analysis": {
      "message_id_tracking": "proper_email_threading_with_headers",
      "subject_based_threading": "fallback_threading_by_subject_analysis",
      "participant_tracking": "maintain_conversation_participant_lists",
      "thread_continuation": "seamless_conversation_flow_across_emails"
    },
    "organization_handling": {
      "multi_org_users": "automatic_organization_detection_and_switching",
      "cross_org_emails": "secure_handling_of_multi_organization_emails",
      "guest_users": "automatic_guest_user_creation_for_new_senders",
      "org_preferences": "remember_user_organization_preferences"
    }
  }
}

​
Getting Started

​
Setup Your Email Agent

  1. Send an Email Simply send an email to your mixus agent address: 
    agent@mixus.com        # Production
agent@dev.mixus.com    # Development
  2. Organization Selection If you’re part of multiple organizations, the system will help you select the appropriate one:
    • First-time users get an organization selection email
    • Use inline commands: #org:organization-name in your email
    • System remembers your preference for future emails
  3. Start Conversing Your email becomes a chat conversation with full AI capabilities:
    • Ask questions and get intelligent responses
    • Request tasks and workflows
    • Access all mixus tools and integrations
    • Maintain context across the email thread
Important for Group Emails: When CC’ing others or in email threads with multiple recipients, mention @mixus in your message to ensure the agent responds. For 1-on-1 emails, no mention is required.

​
Email Features

​
Greeting

  • Sender-only greeting in replies: “Hi [FirstName],” when known; otherwise “Hi there,”.
  • This does not change recipients; TO/CC remain as in the original thread.

​
Seamless Threading

  • Proper Email Headers: Maintains In-Reply-To and References for email client threading
  • Subject Preservation: Keeps original subjects with “Re:” prefixes
  • Participant Management: Includes all original TO/CC recipients in responses
  • Thread Continuity: Links email conversations to persistent chat sessions

​
Organization Management

  • Multi-Org Support: Automatically handles users in multiple organizations
  • Inline Switching: Change organizations mid-conversation with #org:name
  • Guest Users: Creates temporary users for unknown email addresses
  • Secure Boundaries: Enforces organization permissions and data isolation

​
Content Processing

  • Rich Text Support: Processes both HTML and plain text emails
  • Attachment Handling: Supports email attachments and file processing
  • Link Extraction: Automatically processes and analyzes shared links
  • Markdown Support: Converts AI responses to proper email formatting

​
Advanced Features

​
Cross-Organization Emails

Handle emails spanning multiple organizations securely:

​
Email Loop Prevention

Sophisticated anti-loop mechanisms prevent email storms:
  • Agent Email Detection: Automatically identifies emails from mixus agents
  • Auto-Response Filtering: Detects and ignores auto-generated emails
  • Rate Limiting: Prevents excessive email processing
  • Content Analysis: Identifies circular email patterns

​
Notification Management

Intelligent notification handling prevents duplicate alerts:
Notification Integration
{
  "notification_system": {
    "email_participants": {
      "in_app_notifications": "automatically_muted_for_email_participants",
      "agent_mode": "uses_agent_notification_mode_to_prevent_duplicates",
      "cross_platform": "coordinates_between_email_and_in_app_notifications"
    },
    "response_delivery": {
      "email_responses": "delivers_via_email_to_original_participants",
      "chat_updates": "maintains_internal_chat_for_context",
      "status_tracking": "tracks_delivery_and_read_status"
    }
  }
}

​
Use Cases

​
Customer Support

  • Automated Responses: Intelligent replies to customer inquiries
  • Ticket Integration: Create and manage support tickets from emails
  • Escalation Management: Route complex issues to appropriate teams
  • Follow-up Tracking: Ensure customer issues are resolved

​
Team Collaboration

  • Project Updates: Automated project status emails and summaries
  • Task Management: Convert email requests into actionable tasks
  • Meeting Coordination: Schedule and manage meetings via email
  • Document Sharing: Process and analyze shared documents

​
Business Operations

  • Invoice Processing: Automated invoice analysis and routing
  • Contract Management: Review and process contract documents
  • Vendor Communication: Manage supplier and vendor relationships
  • Compliance Reporting: Generate and distribute compliance reports

​
Integration Points

​
Email Platform Support

Works with all major email platforms through standard email protocols:
  • Gmail/Google Workspace: Full integration via standard email
  • Outlook/Exchange: Complete compatibility with Microsoft systems
  • Apple Mail: Native support for Apple email clients
  • Third-party Clients: Any email client supporting standard protocols

​
mixus Platform Integration

  • Chat System: Seamless conversion to internal chat conversations
  • Agents: Full access to all mixus AI agents and capabilities
  • Tools: Complete integration with mixus tools and workflows
  • Files & Memory: Access to organizational knowledge and files
  • Integrations: Connect with 200+ external services and platforms

​
Technical Architecture

​
Email Processing Pipeline

​
Key Components

  • EmailChatBridgeV5: Main orchestration class handling email-to-chat conversion
  • Email Intent Classifier: AI-powered email classification and routing
  • Threading Validator: Ensures proper email thread continuity
  • Organization Resolver: Handles multi-organization email scenarios
  • Loop Prevention: Sophisticated anti-spam and loop detection

​
Configuration & Setup

​
Environment Setup

Required environment variables for email agent functionality: 
# Postmark Configuration
POSTMARK_API_TOKEN=your_postmark_token
POSTMARK_FROM_EMAIL=agent@yourdomain.com

# Email Agent Settings
EMAIL_AGENT_ENABLED=true
EMAIL_DEBUG_MODE=false
EMAIL_LOOP_PREVENTION=true

​
Webhook Configuration

Set up Postmark webhook to process inbound emails: 
Webhook URL: https://yourdomain.com/api/email/inbound
Events: Inbound Email
Method: POST

​
Monitoring & Analytics

​
Email Processing Metrics

Track email agent performance and usage:
  • Processing Times: Monitor email-to-response latency
  • Thread Accuracy: Measure threading detection success rates
  • Organization Resolution: Track multi-org email handling
  • Error Rates: Monitor processing failures and causes
  • User Engagement: Analyze email response patterns

​
Debugging & Troubleshooting

Built-in debugging capabilities for email processing issues:
  • Enhanced Timing: Detailed performance analysis for each email
  • Processing Logs: Comprehensive logging of email handling steps
  • Thread Validation: Verify email threading accuracy
  • Organization Mapping: Debug multi-organization scenarios

​
Security & Compliance

​
Data Protection

  • Encryption: All email content encrypted in transit and at rest
  • Access Control: Organization-based permissions and data isolation
  • Audit Logging: Comprehensive logging for compliance requirements
  • Data Retention: Configurable retention policies for email data

​
Privacy Features

  • Unsubscribe Support: Automatic handling of unsubscribe requests
  • Spam Detection: Advanced spam filtering and auto-response detection
  • Cross-Org Security: Secure handling of multi-organization emails
  • Guest User Management: Temporary users with limited access scope

​
Best Practices

​
Email Management

  1. Clear Subject Lines: Use descriptive subjects for better threading
  2. Organization Context: Include organization context for multi-org users
  3. Attachment Optimization: Keep attachments under reasonable size limits
  4. Response Timing: Expect responses within typical AI processing times

​
Integration Strategy

  1. Gradual Rollout: Start with internal teams before external communications
  2. User Training: Educate users on email agent capabilities and conventions
  3. Monitoring Setup: Implement monitoring for email processing metrics
  4. Backup Procedures: Maintain fallback procedures for system maintenance

​
Support & Troubleshooting

​
Common Issues

  1. Threading Problems: Check email headers and subject line formatting
  2. Organization Confusion: Use explicit org switching commands
  3. Missing Responses: Verify spam filters and email delivery
  4. Attachment Issues: Ensure attachments meet size and format requirements

​
Getting Help

For email agent support:
  • Check processing logs in your mixus dashboard
  • Verify webhook configuration and delivery
  • Contact support with specific email Message-IDs for detailed troubleshooting
  • Review organization settings for multi-org scenarios
The email agent system is continuously being enhanced with new capabilities. Check the recent changes for the latest updates and improvements.
⌘I