Skip to content
Mint Service Desk Documentation centre

Client Portal

Mint Service Desk 3.4.2 user manual.

Basics

The Customer Portal lets customers create requests from templates prepared by an administrator. Its visibility depends on the administrator profile settings.

The module consists of:

Cases: These are templates created by the Administrator.

Containers: Here, you can assign and group the cases mentioned above.

Customers can create tickets through the Customer Portal even without permission to access the relevant queues or ticket types.

Click Customer Portal in the left sidebar to open the module.

An administrator can set the Customer Portal as the first screen shown after a customer signs in.

Use the ‘Search’ field at the top to find cases by:

  • Container name
  • Container description
  • Case name
  • Case short and long descriptions

Views

Customers can choose from three available view types:

  • Block
  • List
  • Tree

The order in which they are displayed and their availability are determined by the settings in the administrator’s profile under Settings -> General -> Customer Portal.

BLOCK VIEW

The Block View allows cases to be grouped by subject area while providing quick access to specific case types. This presentation method displays available containers arranged one below the other.

Each container can include description.

Containers and cases can be collapsed or expanded. When a user expands a selected container, the cases available within that category are displayed. The cases are presented as separate tiles arranged side by side, allowing the user to quickly find and select the appropriate type of issue.

Each tile contains the case name. Collapsed case presents a short description

When user expands the case, a long description is presented, which help the user determine what a given case is for.

User can easily create the case by clicking the plus button.

Creating the case is described in Creating a ticket section.

LIST VIEW

The list view displays available cases as topic-based containers arranged side by side in a grid.

Each container can include description.

When a selected container is expanded, the user is shown the request templates available within that category. The cases are displayed as a list arranged one below the other, allowing the user to quickly find and select the appropriate type of issue.

Each tile contains the case name. Collapsed case presents a short description.

When user expands the case, a long description is presented, which help the user determine what a given case is for.

User can easily create the case by clicking the plus button.

Creating the case is described in Creating a ticket section.

TREE VIEW

The tree view displays the available cases as a grid, while the containers are accessible via a menu on the left-hand side. This presentation method allows you to build a multi-level category structure similar to a folder structure, and to quickly navigate between different levels and topics.

Upon logging into the Customer Portal, the tree view displays all available cases by default, regardless of the container to which they belong. From this level, the user can expand or collapse each case as well as create a new case directly based on a selected template.

Selecting a specific container from the menu on the left narrows the displayed content to cases belonging to the selected category.

You can return to the view of all cases at any time by selecting the home button with the house icon.

In the tree view, it is possible to nest containers — that is, to place one container inside another, similar to folders within folders. After selecting a parent container from the menu, a view of the subcontainers is displayed. This allows for the creation of a multi-level category structure.

For example - we would like to connect three containers into one category:

We need to log in to the admin profile and creating the new container with these three subcontainers selected. Remember to set the container order you want to have and - if new container will have only subcontainers - to select ‘Show container even if it does not contain any cases’. Otherwise the new container will not be shown.

Next we are log in to the Customer profile. We will see our new container and the expand button before the container name

Clicking it will expand the subcontainer list. From there we can select specific subcontainer and the connected cases will be shown

Creating A Ticket

Select a case and click to create a ticket. A new window opens.

The “Subject” field contains the case name, and the description contains its short description. You can edit both fields and add attachments or assets.

The tile in the top right corner shows a preview of the case template.

Click in the bottom right corner to submit the ticket. The next screen depends on your permissions:

  • If you have the required ticket type and queue permissions, you can view the ticket details.

  • Otherwise, a message confirms that agents will handle the case.

Dashboard

The Dashboard opens after you sign in. It lists the tickets available to you, including your own tickets and those created by colleagues in the same company.

Filtering and columns

You can filter the tickets listed by ‘Queues’, ‘Ticket type’, ‘Status’ and ‘Period’, or choose to sort tickets by different attributes like “Ticket Number”, “Subject”, “Creation date” and more. To do so just click on the column name. You will notice that each time you do that a small icon next to the column’s name will change: -> ->

Click on the right to open “Set column properties” and choose which columns to show. Changes are saved automatically and remain in place when you leave the view.

Use “Search” to find tickets in the fields selected under ‘Search by’ in ‘Set column properties’.

In the upper part, above the tickets list, you will see a button, which will allow you to reset the view and remove all of the active filters.

Exporting the ticket list

Click to export the ticket list, then choose one of the 2 formats: .CVS or .XLSX.

Click ‘Save’ in the new window to save the file in your browser’s default download folder.

The file includes ‘Ticket number’, ‘Id’, ‘Subject’, ‘Creation date’, ‘Last modification’, ‘Company’, ‘Status’, ‘Customer’, ‘Queue’ and ‘Assignee’.

Browsing tickets

If you like to see or hide tickets that have already been solved and closed, you can always mark/unmark the option . The same situation is for filters located on the left - you can always hide and unhide them by button. Both of these checkboxes are located on the right side of the Dashboard screen.

Use the controls below a long ticket list to switch pages or change the number of tickets per page.

Page navigation is on the left. On the right, choose 5/10/15/20/25/50 or 100 tickets per page; the default is 10. Similar controls appear elsewhere in Mint Service Desk.

Click any ticket attribute in the list to open that ticket’s details.

If the following message appears when you open a ticket or asset, an administrator has changed your access rights. Contact the administrator for help.

New Ticket

On the top right side of the Dashboard screen, you will find two shortcut icons: and .

Click either icon to open ‘Create new ticket’.

Ticket information

Complete the required information marked with *:

  • “Subject”: a short description of the incident or request.
  • “Description”: details of the problem or need.
  • Select the ‘Ticket type’.
  • Select the queue from ‘Assign to queue’.

If the problem concerns a device, you can add an asset available to you. Click the magnifier to search for and select assets to associate with the ticket.

Apart from the above you can also choose a ‘Service’ (along with SLA/parameters/priorities which are specified individually for each service), add some attachments (pictures, screenshots, .zip files, docs, etc.), and select a ‘Priority’ of your ticket.

If the selected ‘Ticket type’ has additional attributes, a section with further fields and options appears on the right.

Knowledge Base suggestions

As you type in ‘Description’, a ‘Knowledge Base’ section may appear on the right. It shows topics matching your words that may describe or resolve the problem.

Click a topic to read its details.

The following screen shows a completed form.

Draft and submission

To clear ‘Subject’ and ‘Description’, click at the top of ‘New ticket’.

Once you do that, the ‘Subject’ and ‘Description’ fields will be cleared.

Mint remembers the content of ‘Subject’ and ‘Description’. If you leave ‘Create new ticket’ accidentally, the same text is restored when you return.

Scroll down while creating the ticket to preview its appearance.

Click in the bottom right corner to submit the ticket, then wait for the agent’s response.

Ticket Details

Creating a ticket opens ‘Ticket details’, where you can read the conversation and view information about the ticket.

Details and related assets

The ‘Details’ section on the right contains “Ticket number”, “Company user”, “Company”, “Status”, “Queue”, “Assets”, “Ticket type”, “Priority”, “Service” and “Age”.

To close the ticket, click the button in the top right corner. Next to it there are two buttons which are used to switch between tickets.

Click to open the ticket history. It records changes to the ticket type, service, queue and other fields.

Use the search in “Assets” to find an asset and link it to the ticket.

Once you choose one (or more) and click Save those assets will be visible in the ‘Assets’ part of the ‘Details’ section.

If you click on any of them it will open a new window where you will see details of this chosen Asset. If from this place you click the button inside you will go to the ‘Edit asset’ view where you can change the assets details (if you have the required rights).

Additional attributes below ‘Details’ depend on the Ticket type. Administrators create and manage them in Admin > Tickets > Types, described later in this guide.

Conversation and notifications

The main area of ‘Ticket details’ contains the conversation. Use to choose a framed or chat view.

Chat is the default view. Switch to framed view with to see a list of messages, then click a message to expand its details.

The other two buttons next to chat/framed view are used for the ‘Notifications timeline’ and Subscribing/Unsubscribing the ticket.

Click to open the notification history for this ticket. Click to load earlier activities.

The second one, once activated () will send notifications each time something new happens within the ticket.

Subscriptions

The behaviour of the button when clicked depends on the option selected under ‘Subscription management strategy’ in ‘Admin’ > ‘Settings’ > ‘General’ > ‘Tickets’

With the ‘Allow assigning only yourself’ option selected, You subscribe only yourself to the ticket by selecting the button.

With ‘Allow agents to assign other agents’ selected, an agent can also subscribe other agents to the ticket.

Click ‘Subscribe someone else’ to open the selection window.

Choose users from the list.

Add them with the arrow button. The selected agent appears below.

If you subscribe yourself, your account also appears in the list.

Use the button shown below to unsubscribe another user.

With ‘Everyone can assign everyone’ selected, you can subscribe yourself and other users, including agents and customers. This setting lets customers see the list of all agents in the system.

Subscribing users is similar to subscribing in the “Allow agents to assign other agents” option (above).

File repository

Next button is the File Repository

The File Repository stores MINT application documents. Available actions depend on the user’s access level. Customers can download files assigned to a ticket.

To open the File Repository as a customer, go to Ticket details and find the icon shown below.

Click the icon to see files pinned by an agent in the File Repository tab.

Click a pinned file to download it. Downloads work as described in the agent profile section.

Reading and sending messages

Long chat messages are shortened. Click to read the full text.

The chat also shows system information, such as changes to the ticket Status or Priority made by an agent.

Use ‘Enter a message…’ below the chat to write a reply.

Type the message, add some attachments (‘Add attachment’) if you want, and click button.

You can also format your message by using the text editor, which will be displayed the moment you click on the ‘Enter the message…’ field.

Click to send the message. It immediately appears in the chat.

Use beside an article to export it to a PDF file.

Ticket Details records the communication and actions taken by customers and agents to resolve the ticket.

My Tickets

An administrator can enable or disable this function in Settings => General => Tickets.

“My Tickets” is an additional dashboard listing tickets you created, either in the system or by email. It is available to both agents and customers.

You can track your tickets and see basic information, including the queue, ticket type and assignee, even without permission to open them. Access to ticket details still depends on queue and ticket type permissions.

The view contains a ticket table, a sidebar with basic filters and a top panel with “Show Closed” and “Show Filters”. The table includes columns such as status, queue and agent.

Navigation works as described in the “Dashboard” section.

Assets

The “Assets” section lists company or provider assets available to you. An asset does not have to be assigned directly to you: an administrator may make it available so that you can relate a request to it or request an associated service.

For example, you can check whether the company already has the software or licence you need before buying it again.

Filtering and searching

Filter assets by ‘Categories’ or ‘Period’. Click to reset all active filters, or use or next to a selection to remove that category or filter.

Click on the right to open “Set column properties”, then select the information to show in the asset list. Changes are saved automatically and remain in place when you leave the view.

Use the “Search” field to find an asset. The search covers the fields selected under ‘Search by’ in ‘Set column properties’.

Asset details and export

Click an asset to see its details.

Click an asset in the list to open ‘Asset details’ and view its information without editing it.

If the asset is related to any of your Tickets (an Agent is able to do it) you will find it on the list once you click the button.

Click ‘Generate pdf’ to export asset information to a PDF file.

Click ‘Print QR’ to print the QR code.

Scan the QR code to open the details of this asset.

Knowledge Base

To see the full description of the Knowledge Base, please consider to visit section Agent portal -> Knowledge base from the Documentation menu

Browse Knowledge Base topics, questions and answers to find help with your problem. Suggestions also appear while you type the content of a new ticket, as described in ‘Ticket details’.

Categories and topics

The default view shows the list of all available topics. On the left side, you can see available categories.

Select a category or subcategory to narrow the topic list. Click the category path at the top to return to a higher level.

You can also click on the ‘X’ button located on the right side of the currently selected category/sub-category.

Columns and search

By default, in the main view of the Knowledge Base section, you will see the list topics with the following attribute columns: Name,Category, Question, Answer, Description, Revision, Action. In order to see more information, you need to click the button.

In ‘Set column properties’, select the information to display. Changes are saved automatically and remain in place when you leave the view.

Also, you can look for a specific topic by using the section “Search” field. Whatever you type here will be searched for, depending on the things you marked in the ‘Search by’ button.

In the upper part, above the topics list, you will see the buttons like below:

Description of the buttons and their functions:

  • Reset table - resets the columns to their default state
  • Most viewed - sorting from most viewed to the least viewed (column ‘Number of visits’)
  • Last added – sorting from most recently added topic to the oldest one (column ‘Age’)
  • Last modified – sorting from the most recently modified = most up to date (column ‘Last modification’)

Activities

The Activities section is near the bottom of the left sidebar.

The list shows tickets with new activity. An entry blinks when a change occurs, such as a new message (Article) from an agent. Only an administrator can change notification colours, titles, content and other settings.

Managing notifications

You can delete any position from the Activities list, by clicking the button.

If the list contains several activities, use ‘Delete all’ to remove them or ‘Read all’ to mark them as read.

When a ticket has several unread notifications, such as messages from an agent, their count appears on the right of the notification.

Click the notification to open Ticket Details and read the messages.

Click the ‘Read’ icon to mark a notification as read; it becomes grey. The ‘Read all’ icon marks all notifications included in the count as read.

The following screen shows notifications marked as read.

A long list initially shows only some activities. Click ‘See more activities’ to load more.

Each time you click on the notification in the ‘Activities’ section you will be moved to the Ticket Details screen where you can continue communicating with an Agent.

Sidebar layout

Click in the top left corner to change the sidebar layout.

When the activity button is pressed, the activity box will slide out.

To hide the activity sections, press the Activities button again.

Access changes

If the following message appears when you open a ticket or asset, an administrator has changed your access rights. Contact the administrator for help.