- Home
- Documentation
- Team & Collaboration
- How Do Shared Mailboxes and Routing Work?
How Do Shared Mailboxes and Routing Work?
Learn how mailboxes are shared within your organization, how to route inquiries to team members, and how to set up effective routing rules using handoffs and automation.
Shared mailboxes in Propel allow your entire team to collaborate on prospect inquiries. All team members can view and manage conversations from shared mailboxes, and you can route inquiries to specific team members using handoffs and automation rules. This guide explains how shared mailboxes work and how to set up effective routing.
What Are Shared Mailboxes?
In Propel, mailboxes are automatically shared within your organization:
- Organization-wide access - All team members can view engagements from any mailbox
- Collaborative management - Multiple people can review and manage conversations
- Unified view - All conversations appear in the Engagements page for all team members
- No separate setup - Mailboxes are shared by default - no additional configuration needed
Key Points:
- Not email accounts - Propel mailboxes are monitoring configurations, not separate email accounts
- Team visibility - All team members see all engagements from all mailboxes
- Permission-based - Only admins can create and configure mailboxes
- Multiple mailboxes - You can have multiple mailboxes for different purposes
Use Case Examples:
- Property Management: One mailbox for "Leasing Inbox" - all leasing team members can see and manage inquiries
- Real Estate: Multiple mailboxes (e.g., "Buyer Leads", "Seller Inquiries") - all agents can view all conversations
- Short-Term Rentals: Shared mailbox for booking inquiries - property managers and guest services can collaborate
- Commercial Real Estate: Territory-based mailboxes - team members can see inquiries across territories
Understanding Mailbox Sharing
How Sharing Works
When you create a mailbox:
- Mailbox is created - Configured to monitor a specific email account
- Automatically shared - All organization members can access engagements from it
- Team visibility - Engagements appear in the Engagements page for all team members
- Collaborative access - Any team member can view, approve, or manage conversations
Mailbox vs Email Account
It's important to understand the difference:
- Email account - Your actual Gmail or Microsoft 365 account (e.g.,
leasing@example.com) - Mailbox - A Propel configuration that monitors an email account (e.g., "Leasing Inbox" mailbox monitors
leasing@example.com)
Note: One email account can have multiple mailboxes monitoring different folders, but typically you'll have one mailbox per email account.
Team Member Access
All team members can:
- View engagements - See all conversations from all mailboxes
- Review responses - Approve or reject AI-generated responses
- Manage conversations - Add notes, update status, manage follow-ups
- View contacts - Access contact information and history
Only admins can:
- Create mailboxes - Set up new mailboxes
- Configure mailboxes - Modify mailbox settings and rules
- Delete mailboxes - Remove mailboxes
Routing Inquiries to Team Members
While mailboxes are shared, you can route inquiries to specific team members using several methods:
Method 1: Handoffs
Handoffs automatically CC team members when specific conditions are met:
- Enable handoffs in mailbox settings
- Set default handoff agents - Team members who should be CC'd
- Configure handoff rules - Define when handoffs should occur
- Team members receive emails - CC'd on responses when handoffs trigger
When to use:
- Important prospects that need human attention
- High-value inquiries that require team involvement
- Complex situations where AI needs human help
- Specific types of inquiries (e.g., luxury properties, commercial deals)
For detailed handoff setup, see Setting Up Handoffs.
Method 2: Approval Workflows
Approval workflows require team members to review responses before sending:
- Enable approvals in mailbox settings
- Team members review - Responses appear in Dashboard for approval
- Approve or reject - Team members can approve, reject, or edit responses
- Response sent - Only approved responses are sent
When to use:
- Initial setup when you want to review all responses
- Compliance requirements that need human review
- Quality control for important conversations
- Training period to understand AI behavior
For detailed approval setup, see Approval Workflows.
Method 3: Property Agent Assignments
Assigning agents to listings routes inquiries to specific agents:
- Create property agents - Set up agents for your team members
- Assign agents to listings - Link agents to specific properties
- Propel references agents - Responses mention assigned agents
- Inquiries routed - Prospects are directed to the assigned agent
When to use:
- Properties with dedicated agents
- Territory-based assignments
- Specialized property types (luxury, commercial)
- Agent-specific expertise areas
For agent setup, see Property Agents and Assignments.
Method 4: Automation Rules
Create rules that trigger specific actions based on inquiry characteristics:
- Create rules in Settings > Rules
- Define conditions - Set criteria for when rules trigger
- Set actions - Configure handoffs, approvals, or other actions
- Rules execute - Automatically route based on conditions
When to use:
- Complex routing logic
- Multiple routing scenarios
- Conditional handoffs based on inquiry content
- Territory or property type-based routing
For rule setup, see Creating Your First Rule and Rule Conditions and Triggers.
Setting Up Effective Routing
Step 1: Identify Routing Needs
Determine how you want to route inquiries:
- By property type - Different agents for different property types
- By territory - Geographic routing for real estate teams
- By inquiry value - Route high-value inquiries to senior agents
- By expertise - Route specialized inquiries to experts
- By availability - Route to available agents
Step 2: Set Up Agents
Create property agents for team members who will handle inquiries:
- Go to Settings > Property Agents
- Create agents for your team members
- Assign agents to listings as needed
- Set up agent availability and fallbacks
Step 3: Configure Mailbox Settings
Set up mailbox-level routing:
- Go to Settings > Mailboxes
- Open the mailbox you want to configure
- Enable handoffs - Set up default handoff agents
- Configure response rules - Set up rules for routing
- Set approvals - If you want review before sending
Step 4: Create Routing Rules
Set up automation rules for complex routing:
- Go to Settings > Rules
- Create rules for different routing scenarios
- Set conditions (property type, inquiry content, etc.)
- Configure actions (handoffs, agent assignments, etc.)
- Test rules to ensure they work correctly
Step 5: Monitor and Adjust
Review routing effectiveness:
- Monitor engagements - Check how inquiries are being routed
- Review handoffs - See which inquiries trigger handoffs
- Check agent assignments - Verify agents are assigned correctly
- Adjust as needed - Modify rules and settings based on results
Routing Strategies
Strategy 1: Property-Based Routing
Route inquiries based on the property being inquired about:
- Assign agents to listings - Link agents to specific properties
- Propel uses assignments - Responses reference assigned agents
- Inquiries routed - Prospects directed to property-specific agents
Best for:
- Property management with dedicated leasing agents
- Real estate with listing-specific agents
- Properties with specialized requirements
Strategy 2: Territory-Based Routing
Route inquiries based on geographic territory:
- Create territory-based rules - Rules based on location keywords
- Assign agents to territories - Link agents to geographic areas
- Route by location - Inquiries routed based on property location
Best for:
- Real estate teams with territory assignments
- Commercial real estate with regional teams
- Large property management companies
Strategy 3: Value-Based Routing
Route high-value inquiries to senior team members:
- Create value-based rules - Rules that identify high-value inquiries
- Set handoff conditions - Route high-value inquiries to senior agents
- Configure approvals - Require review for high-value inquiries
Best for:
- Luxury property inquiries
- High-value commercial deals
- VIP client inquiries
Strategy 4: Expertise-Based Routing
Route specialized inquiries to experts:
- Identify expertise areas - Define specialized inquiry types
- Create expertise-based rules - Rules that identify specialized inquiries
- Route to experts - Hand off to team members with relevant expertise
Best for:
- Commercial real estate with specialized asset types
- Property management with different property types
- Real estate with specialized services
Best Practices
Mailbox Organization
- Use descriptive names - Name mailboxes clearly (e.g., "Leasing Inbox", "Buyer Leads")
- One purpose per mailbox - Keep mailboxes focused on specific functions
- Multiple mailboxes - Create separate mailboxes for different inquiry types
- Regular review - Periodically review mailbox configuration
Routing Configuration
- Start simple - Begin with basic handoffs, add complexity gradually
- Test thoroughly - Test routing rules before relying on them
- Document routing - Keep notes on how routing works
- Monitor effectiveness - Review routing results regularly
Team Collaboration
- Communicate routing - Let team members know how routing works
- Set expectations - Explain when team members will be involved
- Provide training - Help team members understand the system
- Gather feedback - Ask team members for routing improvement suggestions
Agent Management
- Keep agents updated - Maintain accurate agent information
- Balance assignments - Distribute listings evenly across agents
- Manage availability - Set up time off and fallback agents
- Review assignments - Periodically review agent-to-listing assignments
Common Scenarios
Scenario 1: Property Management Team
Setup:
- Create one mailbox: "Leasing Inbox"
- Create agents for each leasing agent
- Assign agents to their properties
- Enable handoffs for manager review
- All team members can see all inquiries
Result: Inquiries are automatically routed to property-specific agents, with manager oversight via handoffs.
Scenario 2: Real Estate Team with Territories
Setup:
- Create mailboxes by territory: "North Territory", "South Territory"
- Create agents for each territory
- Assign agents to territory-specific listings
- Create rules for territory-based routing
- Team members can see inquiries across all territories
Result: Inquiries are routed to territory-specific agents while maintaining team visibility.
Scenario 3: Luxury Property Team
Setup:
- Create mailbox: "Luxury Inquiries"
- Create rules to identify luxury inquiries
- Set handoffs to senior agents for luxury inquiries
- Enable approvals for all luxury responses
- Assign luxury specialists as agents
Result: Luxury inquiries are routed to senior agents with approval workflows for quality control.
Troubleshooting
Team Members Cannot See Engagements
- Check organization - Verify team members are in the correct organization
- Verify permissions - Ensure team members have access
- Check mailbox status - Make sure mailboxes are enabled
- Refresh page - Try refreshing the Engagements page
Routing Not Working
- Check rules - Verify routing rules are configured correctly
- Test rules - Use rule testing tools to verify rules work
- Review conditions - Ensure rule conditions match inquiries
- Check agent assignments - Verify agents are assigned to listings
Handoffs Not Triggering
- Verify handoffs enabled - Check that handoffs are enabled in mailbox settings
- Check handoff agents - Ensure default handoff agents are set
- Review handoff rules - Verify handoff conditions are met
- Check email addresses - Ensure handoff agent emails are correct
Related Articles
- Setting Up Your Team - Learn how to add team members who can access shared mailboxes
- Property Agents and Assignments - Understand how to assign agents for routing
- Setting Up Handoffs - Configure automatic handoffs to team members
- Approval Workflows - Set up approval workflows for team review
- Creating Your First Rule - Learn how to create routing rules
Related Documentation
How Do Team Collaboration Features Work?
Learn how team members collaborate in Propel using internal notes, mentions, handoffs, and activity feeds to work together on prospects and conversations.
How Do I Set Up My Team?
Learn how to add team members to your Propel organization, manage roles and permissions, send invitations, and remove members when needed.
How Do I Create Property Agents and Assign Them to Listings?
Learn how to create property agents, assign them to listings, manage agent information, and understand how Propel uses agent assignments for personalized responses.
How Do I Set Up Handoffs?
Learn how to set up handoffs in Propel to automatically involve team members when the AI needs human assistance. Understand handoff configuration, when handoffs occur, and best practices.