Skip to content
Mint Service Desk Documentation centre

General

Mint Service Desk 3.4.2 user manual.

Files

Files is the default page in Settings > General. Configure maximum file sizes for avatars, logos and attachments in megabytes (MB), and set the number of attachments allowed per asset.

Max. avatar size (MB): the maximum size of an Avatar user can upload to profile information in the ‘User profile’ part of the account. Can be set from 1 to 5 MB.

Max. logo size (MB): the maximum size of a logo (both: sidebar and login page) you can upload in the ‘Logo’ section of the ‘General’ part of the ‘Settings’ section. Can be set from 1 to 5 MB.

Max. asset attachment size (MB): the maximum size of each attachment that can be added to an asset. Can be set from 1 to 30 MB.

Limit for asset attachments: you can define the number of possible attachments that can be added to each asset in your Mint Service Desk system. You can set it up from 1 to 5.

Max. dynamic field attachment size (MB): the maximum size of each attachment that can be added to dynamic field. Can be set from 1 to 30 MB.

Default dynamic field attachment file extensions: A list of all extensions that can be used in the attachments. For example: pdf, doc, docx, odt, rtf, txt, etc.

Max. email attachment size (MB): the maximum size of each e-mail attachment that can be downloaded to MINT from external e-mail message in ticket details. Can be set from 1 to 50 MB.

Allowed extensions of files uploaded to MINT: List of all allowed file extensions uploaded to MINT.

Templates

Choose templates for system emails: account confirmation, password reset and two-factor authentication.

At the very beginning of this guide, in the ‘Basics’ part, you already selected a template for the email confirmation.

Always remember that before selecting a new template here, first you need to create some components, then create a template (with those components). It was already described in Channels > Components and Templates parts of this guide.

Once you save a new template it will be available to choose from the dropdown lists.

You can set 3 types of email message templates.

Email confirmation: right here you can select a template which will be used for the email sent to a user, right after he signed up to the Mint Service Desk, to confirm a new account.

Reset password: this template will be used for the email which will be sent to a user once he chose the option ‘Forgot my password’ on the login screen.

Two-Factor authentication: select the template for the email containing a verification code.

Logo

Replace the sidebar and sign-in logos with your company’s images.

Click the image to the right of “Sidebar logo” to select a replacement.

In the file picker, select an image and click ‘Open’ to upload it.

Then you can add: Text in background, Text color in background, Text size in background (1-100) and Text font in background to be displayed on the login page.

Next, you can add is Background logo and Login page background. Click on the image located on the right side of the “Background logo” or “Login page background”.

For images, it is better to upload a transparent background image and for “Login page background” it is better to use a file with a height/width ratio of 11:10.

If you prefer the default MINT Service Desk images you can always reset both images to default values by clicking on the button

If you select the wrong type of file (e.g. .pdf by mistake) you will receive the ‘Invalid file’ error message.

If you select an image with the size exceeding the limit set in the ‘Files’ section, you will also receive the same error message. In that case, you need either choose a smaller image or go to the ‘Files’ tab and raise up the size limit.

Global Settings

Configure the system’s time zone, default language and ticket and article preview options.

Time Zone: the default time zone for the system.

Default language: the default language for system users.

Browser Tab Title: allows you to specify what will be displayed in the Tab Title

Browser Tab Title: here you can set the default theme that will be set for new users of the system

Domain adresses regex Here you can set a regular expression that will filter e-mail addresses when sending reports by e-mail (sending to e-mails matching the regex will be blocked - additional settings related to this can be found under Settings => Reports tab)

Upgrade

This section contains information about the modules that are locked in the free version. When you see means that you have access to this module.

Currently available modules are:

  • Access to Automation module
  • Access to reports
  • Access to grouped reports
  • Access to Time Tracking module
  • Api Access
  • Access to ticket conditional attributes
  • Access to Customer Portal
  • Acces to File Repository
  • Acces to search engine
  • Access to identity providers
  • Access to surveys
  • Access to content manager
  • Access to SQL reports
  • Access to Approvals module

When the module has been purchased and there is still a blank field instead of checkmark, press button to refresh the feature flags.

When you want to upgrade your version to Enterprise, press button.

Tickets

Configure ticket defaults, form fields and communication settings.

General ticket settings

Settings on the left:

Max. article attachment size (MB): it allows you to set the maximum size of an attachment in megabytes.

Queues sorting: This option allows you to choose whether you want to sort the queues or By ordering in admin panel.

Priority sorting: This option allows you to choose whether you want to sort priorities alphabetically or By ordering in admin panel.

Assets relation: This option allows you to establish relationships to assets. You can choose from one-to-many or many-to-many.

Default answer: In this option there is a choice of two options “None” and “Reply all”. Selecting “Reply all” means that when you enter a ticket, the system will behave as if you pressed the “Reply all” button on the last article.

Selection default ticket creation type for users: This option has two choices “None” and “Enable for agents”. Selecting the first option will cause the agent to rely on the default settings and selecting the second option will appear in a new field in the agent’s profile:

Notify parent tickets about changes in child tickets: This setting allows you to define whether the parent ticket should be informed about status changes in a child ticket. Available options:

  • None – no notification is sent.
  • Private articles – a private article is added to the parent ticket.
  • System article – a system article is added to the parent ticket.

You also can configure the relevant notification event, related to this functionality in the Notifications section of the admin profile.

Subscription management strategy: This option allows you to select the behaviour of the Subscribe button () in the ticket details. You can choose:

  • Allow assigning only yourself: subscribe yourself to the ticket.
  • Allow agents to assign other agents: subscribe yourself and, if you are an Agent, other agents.
  • Everyone can assign everyone: subscribe yourself and other users, including when you are a Customer. This option lets customers see the list of all agents in the system.

Automatic article expansion: This option specifies the default display mode for articles within a ticket. Three options are available:

  • Do not expand automatically - articles are displayed in a collapsed state, showing only the first few lines of content
  • Expand automatically - articles are displayed with a limited height, showing approximately 20 lines of content. If an article exceeds the available space, a scrollbar is displayed to allow users to view the remaining content.
  • Expand full automatically - articles are fully expanded, with their entire content visible

Article order: This option Specifies the order in which articles are displayed in the ticket details. Available options:

  • Oldest at the top – articles are displayed in chronological order, with the oldest article first and the newest at the bottom
  • Newest at the top – articles are displayed in reverse chronological order, with the newest article first and the oldest at the bottom

Display and behaviour

Settings on the right:

Extend ticket type color to ticket number: display ticket numbers on the Dashboard in the colour configured under Tickets / Custom fields / Tickets structure.

Auto reassigne on reply: This option allows you to determine whether a new agent should be assigned to a ticket after a response. For example: Agent 1 is assigned to the ticket, Agent 2 responds to the ticket. If the option is checked, the system assigns Agent 2 to the ticket after their response

Extend filter client by email adress applies to the Company user filter on the agent and customer dashboards. When enabled, you can search by Name, Surname and/or email address. When disabled, only Name and Surname are searched.

Show default ticket creation properties panel for agent This option can enable or hide default ticket creation properties panel in Agent profile, where each Agent can set personal default properties when creating new ticket

Show default ticket creation properties panel for customer This option can enable or hide default ticket creation properties panel in Customer profile, where each Customer can set personal default properties when creating new ticket

Enable search engine This option allows you to enable improved searching in filters on dashboard (available in Mint Enterprise version)

Enable merge tickets This option allows you to enable Merge Tickets in Ticket Details in Agent role

Show preview: it allows you to choose if users, by default, should have the preview of tickets and articles enabled (checked box) or not (empty box).

Show article resend button: it allows you to resend email article with sending error in Articles section in ticket details

Block ticket closure if required custom fields are empty: Determines whether a ticket can be closed when required custom fields are left empty. When enabled, the system prevents users from closing a ticket until all required custom fields have been completed

Hide information about the age of the ticket on the ticket details: Determines whether information about the ticket’s age is displayed in the ticket details, near the Estimation and Spent time fields.

Show the SLA panel for closed tickets: Determines whether the SLA panel remains visible in the ticket details after a ticket is closed. When enabled, the SLA panel and its associated time information remain visible after the ticket is closed. When disabled, the SLA panel is hidden once the ticket is closed

Display the ticket form as a single block: Determines how custom fields are displayed when creating a ticket. When enabled, custom fields are displayed below the ticket description field. When disabled, they are displayed in a separate column on the right-hand side of the page.

Ticket form configuration

In the Ticket form configuration section you can configure what things will be displayed when creating a ticket.

User type is about specifying who this configuration should go to: To a Customer or an Agent. You can choose which values should be visible on ticket creation and which should be visible on ticket details. Some of these settings have only one option to set.

Below are the values possible to configure (can be different for agent and for customer):

  • Assets
  • Assignee
  • Tickets relation
  • Customer portal (channel in ticket details)
  • Queue
  • Priority
  • Company
  • Company user
  • Ticket type
  • Service
  • Contract
  • E-mail tickets

Checking the E-mail tickets option will add an additional tab when creating a ticket:

Pressing this option will change the Assign company user tab to E-mail recipients with two fields, TO and CC, in which you need to enter the e-mail addresses to which you want to send the ticket.

  • Default ticket creation type

The selection under Default ticket creation type indicates which channel should be the default when creating a ticket.

Some fields, such as Assets and Priority, can be marked as required.

If you uncheck Queue and Ticket type on ticket creation, you will have available ‘Default value’ column to choose default value for them.

The Hide create ticket button option determines whether ticket creation buttons are hidden throughout the system, including on the ticket list and in resource details (e.g., Create related ticket). This option is typically used for Customer accounts to ensure that tickets can only be created through the Customer Portal.

My Tickets

Section My Tickets you can enable or disable “My Tickets” feature in Agent and Customer

Default search settings

In the Ticket search default settings section, you can configure default settings to search for tickets.

Four values are possible to configure:

  • Minimum input length for search: Specifies the minimum number of characters that must be entered in the search field on the ticket list before the search begins.
  • Page size: Allows you to determine how many tickets should be presented per site.
  • Enable filtering ticket with SLA times: Enables filtering of tickets with SLA time checkbox on Agent dashboard.
  • Visible columns: This setting allows you to determine which columns should be visible on the dashboard.
  • Searchable columns: This setting allows you to determine which columns should be searchable by default on the dashboard.

Signatures

In the Signature section, you can configure signature settings.

Two values are possible to configure:

  • Signatures Policy

    • Only System signatures - This option only allows system signatures, which are selected in the “System Signatures” option.
    • Only Queue signatures - This option allows you to select the signatures that have been assigned to given queues.
    • System na Queue - This option is a combination of Only System signatures and Only Queue signatures.
    • All types of signatures - This option allows you to select all signatures in the system.
  • System Signatures - Here you assign what signatures will be referred to as system signatures.

  • Signature spacing - Determines the amount of space inserted before the signature when it is added to the ticket text field

Automatic replies

In the Ticket autoresponse section, you can configure autoresponse for a ticket.

  • Source type - You choose which channel you want the autoresponse to go through.

    • Internal
    • E-mail ticket form
    • Api
    • Mail - to
    • Customer portal
    • Mail - cc
    • Mail - bcc
    • Public form
  • Autoresponder policy - You select the policy for the autoresponser, that is, whether the autoresponser should be selected by queue or by admin selection.

    • Selected by queue

    • Set on admin settings

      • Autoresponder MailBox

Time Tracker

Configure these Time Tracker options:

  • choosing ‘spent time type’,
  • ‘disable estimation’
  • ‘disable spend time’

Spend time type: it allows you to change the type of time spent. You can add such types in Fields settings -> Dictionaries

Disable estimation: it allows you to disable or enable the estimation visible in the ticket preview

Disable spend time: it allows you to disable or enable the spent time visible in the ticket preview

Users

Configure user accounts, profile validation and sign-in options.

Company user section:

  • Can edit E-mail - Enabling this option will allow the user to edit their E-Mail address.
  • Default customer role - Here you can select which company and role should be automatically assigned to the new user registering via the website. Blank fields mean that the new user will be marked as Unassigned

User Validation Patterns section:

  • Regex - First name - Here you select the regex for the first name field
  • Regex - Second name - Here you select the regex for the second name field
  • Regex - Last name - Here you select the regex for the last name field
  • Regex - Phone number - Here you select the regex for the phone number field

Password policy settings - Here you can set requirements for passwords created and changed by all users, including Admin.

  • Password policy enabled - This option is always enabled and cannot be modified
  • Require password change - Here you can set to force password change for users whose passwords do not meet the new policy requirements
  • Minimum password lenght - Here you can set password lenght from 6 to 30 characters
  • Require at least one lower case letter - Here you can set requirement to use at least one lower letter in password
  • Require at least one upper case letter - Here you can set requirement to use at least one upper letter in password
  • Require at least one digit - Here you can set requirement to use at least one digit in password
  • Require at least one special character - Here you can set requirement to use at least one special character in password

Two-Factor Authentication section:

  • Two-Factor Authentication type - Here whether to have two-step authorization or not. At this time, only the email option is available.

Login settings section:

  • Show forgot password button - Unchecking this checkbox will remove the “Forgot my password” option from the login screen.
  • Show sign up button - Unchecking this checkbox will remove the “Sign up” option from the login screen.

This is what the login screen looks like after unchecking both checkboxes:

Privacy settings - Here you can enable or disable functionality to anonymize user data in user profile

Assets

Configure asset QR codes and menu visibility.

In the QR Codes section you can edit what information should be included in the QR Code printout.

If you don’t need the QR code in assets then you can disable it by disabling Hide QR codes checkbox

Assets menu section:

  • User type: Here you choose who you want the setting to refer to. You can choose between agent and customer.
  • Show assets in sidebar menu: Here you choose whether the asset should be visible on the sidebar.
  • Enable My Assets: Here you choose whether the ‘My assets’ should be visible on the sidebar. The ‘My Assets’ tab is visible in the Agent and Customer profiles. It displays the assets that are assigned to the logged-in user.

Customer Portal

Here you can set whether the Customer Portal (tab in the Customer profile) is to be visible or not.

In addition, you can select whether the Dashboard or the Customer Portal should be visible by default (start page) when the Customer is logged in

The last setting controls the types of views available in the Customer portal within the Customer’s profile.

You can select any number of views from the list. Furthermore, the order in which the views are selected is reflected in the order of the views in the Customer’s profile:

To find out more about the available views, please refer to the documentation in the Customer section, under ‘Customer Portal’.

Mailing

For emails sent on behalf of another person, choose whether the sender or the person represented is assigned as the ticket’s Customer. This applies to tickets created through the email channel, for example from Outlook’s send-on-behalf feature.

Reports

Configure report limits and email delivery rules.

Reports section:

  • Maximum size of all reports: Here you can set the maximum permissible size of all reports, beyond which the system will prevent further reports from being generated. The current report size is displayed in the line above this setting
  • Maximum number of rows in report preview Here you can set the maximum number of rows presented when the Agent clicks on the report preview
  • Behavior when sending outside the domain: Here you can set whether reports are to be:
  1. sent to all email recipients
  2. sent taking into account the regex filter from the Settings => Global settings tab from the Domain adresses regex field
  3. not sent (blocked)