Configuring the PSA incoming email server

To use this feature, you must use a dedicated email account or a test email account. Do not use a personal email account with the same address as a Management Portal user account.

When the PSA email parser processes an incoming email message, the message is not deleted. The message moves to an archive folder. If there is no archive folder, the system creates one.

The system cannot assign tickets to users that are not present in Management Portal, as there can be no association with an email address.

If you are using a mail server other than Office365 or Gmail, ensure that it supports RFC 6851.

To configure the PSA incoming email server

  1. Go to Settings > Service desk > Mail server configuration.

  2. In the Incoming email settings row, click the pencil icon.

  3. Turn on the Active option switch to enable incoming emails.

    When you activate the parser, it will convert all unread messages that it finds in the inbox into tickets. If you do not want this to happen, select the Do not process messages received before the specified date option. See below for more details.

  4. Select the relevant email server protocol type:

    • IMAP (default)

    • Exchange

    • Office365

      For an Office365 protocol type, the system uses the current browser session to detect if you are already signed in to a Microsoft Office365 MFA account. If you are, it activates the integration with the email details of that Microsoft account. If you are not, it asks you to sign-in.

      In this way, there is a possibility that you inadvertently activate the server integration for an incorrect account. To avoid this, sign out of your Microsoft account before activation.

  5. Select the Enable SSL checkbox.

    Secure Sockets Layer (SSL) encrypts your email messages during transport. SSL is only supported in these scenarios:

    • Secure (TLS) - StartTLS - Port 587

    • Secure (SSL) - SSL - Port 465

  6. Enter the host name and port.

  7. Enter the account username and password.

  8. Enter the Timeout value in milliseconds.

    This value specifies how long the system waits for a successful connection to your email server before it times out.

  9. Select the Process messages from unknown users checkbox to convert messages from unknown users, without assigning to a user or company.

    If not selected, incoming emails from an address that is not in the customer database are not converted into a ticket.

  10. Select the Do not process messages received before the specified date checkbox to ensure that tickets are created for emails received after a specified date only.

    This option prevents tickets from being automatically created for all existing emails, including those received prior to defining your incoming email settings.

    When the checkbox is selected, additional date and time fields appear.

  11. Click Test Connection to verify your incoming email settings.

    The system validates your settings, and displays a confirmation message.

  12. Click .