Service App admins can add and manage their support team’s mailboxes with Email Settings. Admins can use Insightly’s server or add their own mail server.
In this Article
- How does it work?
- How to set up with New Insightly Email Address
- How to set up with an External Email Address
How does it work?
Admins can configure their Email Settings within the Service App account to provide a support email address that their customers can submit Tickets to, like support@mycompany.com, which can then forward those emails from that address to an Insightly generated address, like support@zoola.insightlyservice.com.
When an email is sent to a support forwarding email address, Insightly will automatically create a Ticket.
When agents reply to a Ticket or when Insightly sends outgoing notification emails, Insightly’s server will be used by default to send emails, but admins can use their own SMTP Server to send outgoing emails instead.
Admins can add a maximum of 10 support email addresses for each Brand created. Multiple Brands are available on Enterprise plans.
Deleting an email address will not remove the Tickets associated with that support email address.
Verifying an External Email Address
Insightly will need to verify ownership of an external email address after you add it to Insightly Email Settings. An email will be sent and the admin must click the verification hyperlink within the email to verify that it's valid. If the email has not been received, it can be resent by editing the email address and clicking Resend Verification Email.
Primary Email Address
The primary email address is the email address that is the default for each brand (or the default brand when no brands have been added). The first email address created for each brand will become a primary email address.
When a Service App subscription has been enabled, the primary email address for the default brand will be created automatically by Insightly. This email address cannot be removed or replaced by another email address.
Whenever a Ticket is created through your Public Portal Website’s web-to-ticket form, the Ticket replies will be sent from the primary email address assigned to the brand. The external email address for a brand cannot be deleted after verification.
Generating a new Forwarding Email Address
Insightly uses the email name and brand subdomain to generate a forwarding email address. The information entered is used to generate the section of the inbound email address to the left of the @ symbol.
After Insightly generates a forwarding email address, users will need to set up their forwarding email address through their company’s email provider.
How to set up with New Insightly Email Address
- Go to System Settings > Email Settings.
- Click the Add Email Address dropdown and select Add New Insightly Email Address.
- Enter an Email Name to identify the email address.
- Enter the Email Address. Insightly provides the domain, so enter the text you want to appear before the @ symbol.
- Select a Queue to assign the email address to. The New Tickets Queue will be assigned by default, but can be changed at any time.
- Select a Brand. Your default brand will be assigned by default. The Brand cannot be changed after the email address has been created.
- Click Save Address.
How to set up with an External Email Address
- Go to System Settings > Email Settings.
- Click the Add Email Address dropdown and select Connect External Email Address.
- Enter an Email Name to identify the email address.
- Enter your External Email Address.
- Select a Queue to assign the email address to. The New Tickets Queue will be assigned by default but can be changed at any time.
- Select a Brand. Your default brand will be assigned by default. The Brand cannot be changed after the email address has been created.
- In the Outgoing Mail Server section, select Default (Insightly Server) or Use Your Own Mail Server.
- If you select Default (Insightly Server), skip forward to step 12.
- If you’ve selected Use Your Own Mail Server, select an Email System:
- Gmail (Note: Gmail limits the number of emails that can be sent per day)
- Microsoft Office 365
- Other
- Enter your SMTP server name and SMTP Port. If you selected Other in the previous step, check or uncheck your SSL.
- Select an option from the Authentication dropdown.
- Enter your server username and password.
- Click Save Address. A verification email will be sent to the email address.
Microsoft Office 365 authentication changes
Microsoft has deprecated basic authentication and now requires customers to use OAuth2 for accessing its services. To address this, we have updated the Email Settings in our Service App to support OAuth2 authentication, ensuring that the Office 365 email sending process is compliant with the new authentication standard.
Existing Office 365 Email Settings:
For existing Microsoft O365 users, a banner will be displayed notifying them that support for the old authentication methods is being phased out. The banner will prompt users to authenticate their email address using OAuth to ensure continued service
All fields within the Outgoing Mail Server section will be read-only.
Users will only have the option to Save and Authenticate, meaning any changes to the email address will require OAuth authentication.
Creating a New Email Setting Using Office 365:
- A single 'Save and Authenticate Address' button is provided, which will initiate the OAuth authentication process. Clicking the button navigates to the Microsoft sign in modal where you can fill in the email address and password when prompted.
Editing an OAuth-Authenticated Email Setting:
When editing an email setting with an Office 365 outgoing server authenticated via OAuth, users will see a 'Disconnect' button, allowing them to disconnect their OAuth connection.
Once disconnected, users will be redirected to the edit page, where they will see the 'Save and Authenticate Address' button to re-authenticate.