Skip to main content
Each Ravenna channel gets a unique email address that automatically converts incoming emails into tickets. Use email integration to handle support requests, collect feedback, or manage inquiries from users who prefer email over other channels.

Enable email for a channel

1

Open channel settings

Select your channel from the sidebar and click Settings.
2

Navigate to inbound email

In the left navigation, click Inbound Email.
3

Enable inbound email

Toggle on Allow inbound emails to be sent to this Channel.
4

Copy your channel email address

Your unique email address appears in this format:Copy this address to share with users or configure email forwarding.
Each channel has a unique email address. Emails sent to this address automatically create tickets in that specific channel.

How email-to-ticket conversion works

When an email arrives at your channel’s email address:
  1. Ravenna receives the email and extracts the sender, subject, and body
  2. Thread detection checks if this email replies to an existing ticket
  3. New ticket creation happens if no matching thread exists
  4. Guest user creation occurs automatically if the sender is external to your organization
  5. Notifications are sent according to your channel’s notification settings
The ticket inherits properties from your channel configuration, including assigned , , and .

Email threading and replies

Ravenna preserves email conversation context by mapping email threads to ticket threads:New tickets are created when:
  • The email subject doesn’t match any existing ticket
  • The sender starts a new conversation
  • The email doesn’t contain reply headers referencing an existing ticket
Existing tickets are updated when:
  • The email replies to a previous message in the thread
  • Email headers (In-Reply-To, References) match an existing ticket
  • The subject line contains a ticket reference like [HELP-123]
All replies appear as messages in the ticket timeline, maintaining the complete conversation history.
When team members reply to tickets created from email:
  • Replies are sent to the original sender’s email address
  • The sender name appears as configured in your channel settings
  • Email formatting is preserved (plain text and HTML)
  • Attachments from Ravenna tickets are included in the email
  • Reply-to headers ensure responses thread correctly
Team members can reply to email-based tickets from Ravenna, Slack, or any integrated channel. All replies route to the requester’s email address.

Guest users

When inbound email is enabled with guest users allowed, emails from addresses outside your organization automatically create guest user accounts.
are external contacts who submit tickets via email. They receive:
  • A user record in Ravenna for tracking and identification
  • Email notifications when their tickets are updated
  • The ability to reply to tickets via email
  • No access to your Ravenna workspace or web interface
Guest users appear in ticket requesters, notifications, and user searches, but cannot log in to Ravenna or view other tickets.
Guest users have restricted permissions:What guest users can do:
  • Create tickets by emailing your channel address
  • Reply to their own tickets via email
  • Receive email notifications about their tickets
What guest users cannot do:
  • Access the Ravenna web interface
  • View other users’ tickets
  • Use Slack integration features
  • Access internal notes or private information
Guest user creation requires the Guest users setting to be enabled in your channel’s inbound email configuration.

Outbound email configuration

Customize the sender name that appears in the “From” field of outbound emails. This helps recipients identify where the email came from.By default, outbound emails use your workspace name. Configure a custom sender name in your channel’s inbound email settings to:
  • Match your brand or team name
  • Distinguish between different support teams
  • Provide clearer context for external recipients
Example: “Acme Support Team” instead of “Acme Workspace”
Enable bounce email notifications to receive alerts when emails fail to deliver. Bounce handling helps you:
  • Identify invalid email addresses
  • Detect delivery failures
  • Update contact information for requesters
  • Monitor email deliverability issues
When enabled, Ravenna sends bounce notifications to your configured notification channels or workspace administrators.

Security and filtering

Control which email addresses can create tickets in your channel using allowlists.
By default, Ravenna only accepts emails from addresses matching your organization’s domain. This prevents unauthorized ticket creation while allowing internal users to submit requests.When guest users are enabled without allowlists configured, all external email addresses can create tickets.
Specify individual email addresses permitted to create tickets. Use allowlisted emails to:
  • Grant access to specific partners or vendors
  • Allow select external users to submit requests
  • Create a controlled list of authorized senders
Add email addresses one per line in the allowlisted emails field.Example:
Specify entire domains permitted to create tickets. Use allowlisted domains to:
  • Allow all users from a partner organization
  • Accept emails from customer domains
  • Enable access for external teams
Add domains using the @domain.com format, one per line.Example:
@partnercompany.com
@customerdomain.org
If allowlists are defined, only emails from specified sources will be processed. All other emails will be rejected. Ensure your allowlists include all necessary addresses and domains before enabling.

Troubleshooting

If emails aren’t creating tickets, check:
  • Inbound email is enabled in channel settings
  • Email address is correct and matches your channel’s unique address
  • Sender is allowlisted if allowlists are configured
  • Guest users are enabled if the sender is external to your organization
  • Email isn’t being rejected by allowlist rules
Review your channel’s inbound email settings and verify the sender meets all requirements.
If email replies create new tickets instead of updating existing ones:
  • Ensure the subject line includes the ticket reference (e.g., [HELP-123])
  • Check that reply headers (In-Reply-To, References) are preserved by the sender’s email client
  • Verify the email is sent from the same address as the original ticket requester
Some email clients strip reply headers. Ask senders to preserve the subject line with the ticket reference for reliable threading.
If external users aren’t receiving email notifications:
  • Verify Guest users is enabled in channel settings
  • Check that the sender’s email address is valid
  • Look for bounce notifications indicating delivery failures
  • Ensure the user’s email provider isn’t blocking emails from @mail.ravenna.ai
Ask external users to check spam folders and add @mail.ravenna.ai to their allowed senders list.