Managing IEM Mailboxes

Activating Incoming Email

As a prerequisite, you will need existing mailboxes to configure your IEM. If you have purchased a mailbox through Issuetrak, make sure you have that account information available.

Steps:

  1. Click the gear icon in the upper right > click Features beneath System.
  2. Click the checkbox next to Process Incoming Email.
  3. Click Update.

A confirmation message will display when the update is complete. The Incoming Email menu option will then appear available on the Settings Lightbox.


Adding an Exchange, IMAP, or POP3 Mailbox

Steps:

  1. Click the gear icon in the upper right > click Incoming Email beneath Email.
  2. Click Add beneath Mailboxes in the right context menu.
  3. Under Email Account Information, the first option available is an Active check box. This box will be checked by default when adding a new mailbox and can be unchecked to ensure new issues are not created if messages are sent to the specified address.

This can be useful if the mailbox you are adding has existing emails that need to be cleared before going live with this feature.

  1. Click the radio button for the type of mailbox you’re setting up (Exchange, IMAP, POP3).

When you select the Exchange server type, Enable Autodiscover is checked by default. To enter the Mail Server, Domain, and EWS endpoint URL manually, uncheck this option to make the appropriate fields available.

  1. Fill out the server, account, and password information. If using IMAP or POP3, make sure you select Use TLS if applicable.

    1. If using IEM Exchange, you will need to select your version from the drop-down.

  2. Include return address and from name information. If you only have a single mailbox, you can omit this step and the system will automatically use the return address specified in System Lightbox > Outgoing Email beneath Email.

    • This needs to be a general account, not one that belongs to an actual user.

  3. (Optional) Test your connection to the server information provided by clicking on Test Connection.

    If the test is successful, a green message will appear next to the Test Connection button that states Connection Successful. If the test is unsuccessful, a red message will appear with details to assist in resolving the connection issue. If you cannot achieve a successful connection after correcting the specified settings, please contact our Support Team for assistance at 757-213-1351, support@issuetrak.com or https://support.issuetrak.com

  4. (Optional) Select a user or group to be automatically assigned to new issues created.

  5. (Optional) Select a default Class value to apply to all new issues created.

  6. Select a default Issue Type to be applied to any new issue where the Type/Subtype was not derived.

  7. (Optional) Select whether you want the system to derive the Issue Type/Subtype by scanning the subject line and finding an exact match or a contained match.

  8. (Optional) Select whether a default Quick Pick should be applied to all new issues created.

  9. (Optional) Select whether you want the system to derive a Quick Pick to apply by scanning the subject line and finding an exact match or a contained match to a Quick Pick name

  10. Under the User creation section, select one of the radio button options.

    • Accept mail only from existing Issuetrak users, or active Active Directory users (if module purchased)
    • Submit new issues as a specified user. If selected, use the magnifying glass to select the specific user for the issues to be submitted under.
    • Create users from this template. If selected, use the magnifying glass to select an existing template, or click Add User Template to create a new template to be used.  Users created via template will have organization memberships and permissions mirroring those selected in the template profile.
    • Create user with these default values. If selected, use the magnifying glass to set default Organization and Location values.
  11. (Optional) If either of the create options were selected, you can select whether to determine the Organization from the email domain. This will look at the email domain and attempt to match it to the web address field of an organization record. You can also select whether you want to email login credentials to those new users.

  12. (Optional) If you want the submitting user account to have the ability to add notes to issues regardless of its ability to view those issues, you may uncheck the option labeled with "Require user to have issue visibility to add notes" which is enabled by default. 

    • If set to Accept email from existing users only, email from any address not found in your users table will be rejected. If you have specified a user to be notified on error, that user will get a notification that the issue was not created.

  1. (Optional)  Enable Include users from the email's CC list on the Issue's distribution list

  2. (Optional)  Choose between the following three options:

    • Only add existing Issuetrak users to Issue distribution list
    • Create users from this template:  (Select a template)
    • Create users with these default values:  (Select an organization)
       
  3. (Optional)  Enable Email login instructions when new user is created from a template
  4. (Optional)  Enable Attempt to determine organization from email domain when creating a user.  If this is enabled, IEM will compare each sender's email domain against the value stored for each organization's "IEM Email Domain" field and will associate the sender with the first matching value.  

  1. (Optional) Select Reopen Issue if note added after close If you want closed issues to be reopened when someone sends in a reply via IEM.

  1. Select a user to be notified if there are any errors in email processing.

  2. Adding a value to the Attachments field applies a size limit to the individual Attachments IEM will add to issues.

  3. (Optional) Adjust the loop prevention settings. The default is to refuse email when the mailbox received more than five messages from the same person within five minutes.

  1. Click Add Mailbox button. 

A confirmation message will appear when this process is complete.


Adding an Office365 Mailbox

In order to add an Office365 mailbox, you or your Azure administrator must create a new app registration in Azure:

Creating a New App Registration in Azure

Steps:

  1. From "App Registrations" create a new registration for an application.
  2. Take note of the Application ID (will be needed in Issuetrak as Client ID) and Directory ID (will be needed in Issuetrak as Tenant ID).
  3. Move to "Clients & Secrets" and create a new client secret.
  4. Take note of the create secret Value that appears, as once you leave this page you will not be able to see the value again.
  5. Move to "API permissions" and Add permissions.
  6. Select "Microsoft Graph" then Application Permission.
  7. Expand "Mail" and select Mail.ReadWrite.
  8. Expand "User" and select User.ReadAll.
  9. Select Add Permissions.
  10. (If your account lacks permission to do this) An administrator will have to approve the permissions granted.

The steps above explain how to implement an app registration with the right permissions for Issuetrak to utilize your O365 mailbox.  You may wish to constrain the permissions to just a particular mailbox that you want Issuetrak to have access to.  If that is the case, please look here for additional information on doing that. 


Configuring Issuetrak to Retrieve Mail from Office365

Steps:

  1. Click the gear icon in the upper right > click Incoming Email beneath Email.
  2. Click Add beneath Mailboxes in the right context menu.
  3. Under Email Account Information, the first option available is an Active check box. This box will be checked by default when adding a new mailbox and can be unchecked to ensure new issues are not created if messages are sent to the specified address.
  4. Select the Office365 radio button.
  5. Fill out the Tenant Id, Client Id, Account Email (the email address/mailbox you will be retrieving email for), and the Client Secret from the earlier set of steps above. 
  6. Include return address and from name information. If you only have a single mailbox, you can omit this step and the system will automatically use the return address specified in System Lightbox > Outgoing Email beneath Email.

    • This needs to be a general account, not one that belongs to an actual user.

  7. (Optional) Test your connection to the server information provided by clicking on Test Connection.

    If the test is successful, a green message will appear next to the Test Connection button that states Connection Successful. If the test is unsuccessful, a red message will appear with details to assist in resolving the connection issue. If you cannot achieve a successful connection after correcting the specified settings, please contact our Support Team for assistance at 757-213-1351, support@issuetrak.com or https://support.issuetrak.com

  8. (Optional) Select a user or group to be automatically assigned to new issues created.

  9. (Optional) Select a default Class value to apply to all new issues created.

  10. Select a default Issue Type to be applied to any new issue where the Type/Subtype was not derived.

  11. (Optional) Select whether you want the system to derive the Issue Type/Subtype by scanning the subject line and finding an exact match or a contained match.

  12. (Optional) Select whether a default Quick Pick should be applied to all new issues created.

  13. (Optional) Select whether you want the system to derive a Quick Pick to apply by scanning the subject line and finding an exact match or a contained match to a Quick Pick name

  14. Under the User creation section, select one of the radio button options.

    • Accept mail only from existing Issuetrak users, or active Active Directory users (if module purchased)
    • Submit new issues as a specified user. If selected, use the magnifying glass to select the specific user for the issues to be submitted under.
    • Create users from this template. If selected, use the magnifying glass to select an existing template, or click Add User Template to create a new template to be used.  Users created via template will have organization memberships and permissions mirroring those selected in the template profile. 
    • Create user with these default values. If selected, use the magnifying glass to set default Organization and Location values.
  15. (Optional) If either of the create options were selected, you can select whether to determine the Organization from the email domain. This will look at the email domain and attempt to match it to the web address field of an organization record. You can also select whether you want to email login credentials to those new users.

  16. (Optional) If you want the submitting user account to have the ability to add notes to issues regardless of its ability to view those issues, you may uncheck the option labeled with "Require user to have issue visibility to add notes" which is enabled by default. 

    • If set to Accept email from existing users only, email from any address not found in your users table will be rejected. If you have specified a user to be notified on error, that user will get a notification that the issue was not created.

  17. (Optional)  Enable Include users from the email's CC list on the Issue's distribution list

  18. (Optional)  Choose between the following three options:

    • Only add existing Issuetrak users to Issue distribution list
    • Create users from this template:  (Select a template)
    • Create users with these default values:  (Select an organization)
       
  19. (Optional)  Enable Email login instructions when new user is created from a template
  20. (Optional)  Enable Attempt to determine organization from email domain when creating a user.  If this is enabled, IEM will compare each sender's email domain against the value stored for each organization's "IEM Email Domain" field and will associate the sender with the first matching value.  

  21. (Optional) Select Reopen Issue if note added after close If you want closed issues to be reopened when someone sends in a reply via IEM.

  22. Select a user to be notified if there are any errors in email processing.

  23. Adding a value to the Attachments field applies a size limit to the individual Attachments IEM will add to issues.

  24. (Optional) Adjust the loop prevention settings. The default is to refuse email when the mailbox received more than five messages from the same person within five minutes.

  25. Click Add Mailbox button. 

  26. A confirmation message will appear when this process is complete.


 

Updating an Existing Mailbox

Once mailboxes are created, the values can be adjusted at any time.

Steps:

  1. Click the gear icon in the upper right > click Incoming Email beneath Email.
  2. Click edit next to the appropriate mailbox in the list.
  3. Make your changes in the Edit Mailbox screen that opens.
  4. Click Update Mailbox.

A confirmation message will appear when this process is complete.


 

Deleting an IEM Mailbox

Note that you can always inactivate a mailbox at any time by toggling them on and off via the Active slider. However, if you choose to delete a mailbox, please follow the below steps.

Steps:

  1. Click the gear icon in the upper right > click Incoming Email beneath Email.
  2. Click del next to the mailbox you are deleting.
  3. Click OK when prompted to confirm.

A confirmation message will appear when this process is complete.