This article contains:
About Email channel
When you sign up for a Freshchat account, you will automatically receive a default email address in the format support@yourcompany.freshchat.com (also known as a wildcard support address) to handle your support conversations. All emails sent to this address will be converted to conversations in the Conversation Inbox.
In addition to the default Freshworks mail server, you can add multiple support email addresses and choose public email servers like Microsoft Office 365 or other custom email servers to manage your email transactions for both incoming and outgoing communications in Freshchat.
Currently, you can set up email in Freshchat via:
Features supported in email
Message Types | Text | Incoming | Yes |
Outgoing | Yes | ||
Image | Incoming | Yes | |
Outgoing | Yes | ||
Video | Incoming | Yes | |
Outgoing | Yes | ||
Audio | Incoming | Yes | |
Outgoing | Yes | ||
File | Incoming | Yes | |
Outgoing | Yes | ||
Emoji | Incoming | Yes | |
Outgoing | Yes | ||
GIFs | Incoming | Yes | |
Outgoing | Yes | ||
Automation | Bots | Bot to user | No |
Structured Messages | Articles | Bot to user | No |
Carousel | Bot to user | No | |
Buttons | Bot to user | No | |
Dropdown List | Bot to user | No | |
Message Events | Delivered | Incoming | No |
Outgoing | No | ||
Read | Incoming | No | |
Outgoing | No | ||
Typing | Incoming | No | |
Outgoing | No | ||
Consumer Profile | User Name | No | |
Image | No |
Before you begin:
Here are a few things to note before you set up email:
- You can add multiple emails and choose Freshworks or Microsoft email servers to manage your email communications.
- You can do this for incoming, outgoing, or both email transactions.
- When you set up a mailbox, emails from the mailbox's inbox (both read and unread) are fetched and converted into conversations. Replies on Freshchat will be also sent via these custom mail servers.
- By default, older emails from the last 7 days will be fetched and converted into conversations.
Set up emails using the Freshworks mail server
- Log in to your account as an administrator.
- Go to Admin Settings > Channels > Support Email > Add new email.
- Click Freshworks mail server.
- Enter the Support email name and add your email alias.
- Configure your incoming and outgoing Email systems.
- Incoming email system
Set up forwarding rules for incoming mails so Freshchat can start capturing emails sent to this address as conversations. - Outgoing email system
Configure the email server for outgoing emails. You can choose your outgoing mail server as Freshworks email server or Microsoft Office 365.
- Incoming email system
- Click Save. Proceed to Email verification.
Verify Emails
If you use the Freshworks email server to send outgoing mails or have set up email alias (different reply-to address), perform the following steps for verification:
- Verify emails
- Configure DKIM
Verify emails
- On the Email list page, click on the Verify button next to the email address you want to verify.
- To verify emails, click Send. You will receive a verification email. Click on the link in the email to verify.
- You can check the verification status on the Email list page.
Configure DKIM
DKIM adds a signature to emails to verify their source, preventing impersonation and reducing spam.
- To configure DKIM, click Configure DKIM. You will be redirected to the Email Domains page, where you can add domains. For instructions, see How to verify your domain for better email deliverability.
- Once verified, you will see the status on the Email list page.
Set up emails using Microsoft Office 365
- Log in as an administrator.
- Go to Admin > Channels > Support Email > New Support Email > Microsoft Office 365.
- Sign in to your Microsoft account and authorize Freshchat to access your emails (Read / Write / Delete).
- If you are already logged in to your account, you will directly land on the permissions page, where you can grant the required permissions.
- Once the permission is granted, the mail server is ready to use.
Set up emails using other custom mail servers
In addition to Freshworks mail server and Microsoft Office 365, you can choose other custom servers to manage your email transactions, for incoming, outgoing, or both.
To add a support email via a custom Email server:
- Log in as an administrator.
- Go to Admin > Channels > Support Email > New Support Email > Custom.
- Enter the Support Email name.
- Add the email address.
- Proceed with the following sections to configure settings for Incoming and Outgoing server details.
Configure incoming and outgoing server details
Enter the following details:
- Incoming Email Server: Enter the IMAP server name from where the incoming mails have to be fetched.
- IMAP Port: Enter the port details.
- Use SSL: To establish a secure connection, ensure that you select the Use SSL option.
- Login details:
- Choose the Authentication method based on your server settings. The options are Plain, Login, CRAM-MD5.
Note: The authentication method varies for different email servers. Ensure that you choose the correct authentication method. - Enter the username and password of your email account.
Note: If you want to use a custom mail server for both your incoming and outgoing emails, fill in the details for both incoming and outgoing email server settings.
- Choose the Authentication method based on your server settings. The options are Plain, Login, CRAM-MD5.
Note: If you want to use the custom mail server for both your incoming and outgoing emails, fill in the details for both incoming and outgoing email server settings.
Configure additional settings
Post email setup and successful verification, you can choose to have a different mail server configured for your outgoing emails or use an email alias.
You can also configure additional settings, for example, you can automatically route conversations from the email you have set up to specific groups.
Configure a different incoming/outgoing email server
- Click on the Configure button next to the mail server on the email list page.
- You can edit your email name and address.
- You can also configure a different incoming/outgoing
- Choose a different mail server and perform re-authorization.
- Save configuration.
Note: If you change the incoming mail server, you will not be able to reply to existing conversations.
General Settings
Under General Settings, you can configure CSAT surveys and assign conversations from email to specific groups.
Enable CSAT surveys
- On the Email list page, click Configure next to the email.
- Under General Settings, enable CSAT. For more details on setting up CSAT surveys, refer to Building a CSAT survey for your messaging channels.
- Click Save.
Assign conversation to group
- Under Assign to group, select the group to which you want to route the conversations coming from email.
- Click Save.
Handling errors
Here are some of the common errors you might encounter while connecting a mail server.
SMTP / IMAP errorThis could occur due to:
- Incorrect configuration, such as invalid port number, and wrong credentials
- Invalid TLS certificate
- Mailbox IP restrictions
For Microsoft Office 365 users
To correct this error in Microsoft Office 365, ensure that IMAP is enabled in Microsoft Office 365 settings. For instructions, see Enable IMAP and SMTP settings Troubleshooting Email Errors in Freshchat.
Agent experience
Once the email setup is complete, your agents can access all customer interactions, irrespective of the channel, and have truly personalized conversations.
- All incoming emails are clearly marked with a source label as "Email" in the left pane of the Inbox, making them easy to identify.
- Agents can view each email in a conversation format.
- Using the reply editor, agents can draft responses, add CC and BCC recipients (up to a total of 25), formatt text, and include emojis, images, canned responses, and FAQs. Files can also be attached to enhance responses.
Note: The maximum number of recipients in the CC and BCC fields that can be added is 25. - Customers will receive the response as an email, and agents can track the delivery status directly in Freshchat.
Tips and best practices
- You can configure advanced Email settings to customize your emails. For example, you can allow your agents to send outbound emails to customers. For more information, see Configure Advanced Settings.
- If the password for the support email account is modified, it is important to re-authenticate using the updated password within Freshchat. Failure to do so will result in emails not being converted into tickets.
If you’re unsure about the setup, check with your email service provider or IT administrator.