TechDocs/TicketSystem

Some teams within FSFE use a support ticket system for the handling of external requests and for internal processes. FSFE maintains an OTRS instance at https://tickets.fsfe.org/ for this purpose.

Some more technically oriented teams use the issue tracker built into FSFE's git server for bug and feature request handling.

Also available: A quick guide to ticket dispatching.

Teams using the ticket system

If you as a team want to start using the ticket system, please send an email to contact@fsfe.org and we'll discuss how to implement it.

Getting access

If you are a member of a team which uses the ticket system for its work, and you want to help with the tickets, just let your team coordinator know, who will make sure the ticket system administrators activate your login.

Terms and concepts

A ticket represents a task to be fulfilled. All communication around this task is stored within the ticket. A ticket can be for example a question asked at contact@fsfe.org, a merchandise order, a request to sign an open letter, or a speaker submission to the Legal and Licensing Workshop.

A queue is a container where tickets of similar kind are collected. For example, there is one queue which contains all merchandise orders, and there is another queue which contains all signature requests, and so on. There also is the Raw queue for tickets that manually must be sorted into one of the other queues, the Misc queue where all tickets go which don't fit anything else, and the Junk queue for spam. Each queue is assigned to a team within FSFE and only accessible by the members of that team. Queues can be organised hierarchically, meaning that any queue can have sub-queues.

The customer of a ticket is the person (in most cases from outside the FSFE) who initiated the request, for example the person who ordered merchandise, wants to sign the open letter, or asked the question on contact@fsfe.org. Even though FSFE is not a company, we'll use the term “customer” throughout this document.

The owner of a ticket is the person within FSFE who currently works on the ticket. In this document, we'll use the term “your tickets” for “all the tickets where you are the owner”.

The ticket has a lock if the owner has actually taken (or been assigned) responsibility for that ticket. In FSFE's configuration of OTRS, all locked tickets have an owner, and all unlocked tickets have no owner (indicated through the text “Admin OTRS”).

The ticket state new means that the customer has not yet received any feedback on that ticket.

The ticket state open means that there already has been some communication with the customer, but the ball lies in FSFE's field. This includes tickets that have already been closed, but later the customer has sent another followup.

The ticket state pending reminder means that the ball lies in the customer's field. For all tickets of this status, an alarm clock is set to remind the owner (and others) about the issue in case the customer does not react within the time you'd have expected.

The ticket state closed successful means that the task is finished with a positive outcome, for example the question was answered, the merchandise was sent, or the speaker submission was accepted.

The ticket state closed unsuccessful means that the task is finished with a negative outcome, for example we weren't able to answer the question, the merchandise was sold out, or the speaker submission was declined.

A ticket is escalated if the last communication with the customer (in either direction) is “too long ago” (that is, nothing has happened about the ticket for “too long”), where the ticket system administrator defines for each queue what “too long” means in hours or days. For most queues, the escalation threshold is one week.

Basic use

The OTRS Dashboard (Screenshot by Florian Snow)

Finding tickets which require your attention

After login, you see a screen called “Dashboard”, and you can always return to this screen by clicking on the “Dashboard” button at the top left.

On the dashboard, you see four important blocks in which tickets are displayed which require your attention:

In each of these blocks, you can select one of three filters which represent the priority of the tickets for you personally:

The OTRS Ticket View (Screenshot by Florian Snow)

Exploring a ticket and basic ticket operations

When you click of any of the tickets in the dashboard (or in any other view where tickets are listed), you get detailled information about the ticket.

The “Ticket view” is split into several parts:

Sending a reply (Screenshot by Florian Snow)

Sending a reply

It is important that you send outgoing emails related to tickets only within the ticket system, so the email will be visible within the ticket for everybody.

When you want to send a reply to an email, first select the previous email you want to reply to within the ticket's article overview, then click on the "Reply" or "Reply to all" button. You can select to start with an empty reply or already fill in one of the boilerplate texts available for the ticket's queue. If you want to have the boilerplate texts changed or extended, please contact the OTRS administrator.

Like in any other email client, you can add more recipients in the To:, Cc:, and Bcc: fields, edit the actual email body, and attach files to the email.

Now before sending the email, take care to update the ticket state, according to the following guidelines:

Do not forget to update the ticket state. For you (and others!) to be able to find tickets needing your attention, it is essential that the state of each ticket is accurate.

Receiving followups

If the customer sends a followup to a ticket of state “pending reminder”, it is set to state “open”, so it will again be brought to the attention of the owner and the people watching the queue.

If the customer sends a followup to an already closed ticket, it is also set to state “open” and at the same time locked for the last owner it had, assuming that whoever closed the ticket should handle this followup. Sometimes people just send a "thank you" after you've closed the ticket, in that case you can simply close the ticket again directly in the ticket view.

Personal configuration

The OTRS configuration view (Screenshot by Florian Snow)

You can reach the configuration view by clicking on the cogwheel symbol at the top of the OTRS browser window. You will want to set your preferences for the following settings:

Please note that each box has its own “Update” button which must be used to save the settings of this box.

Browsing and searching tickets

The most useful tools to browse through tickets are the following:

The OTRS My Locked Tickets view (Screenshot by Florian Snow)

Browsing through your locked tickets

You get a list of your locked tickets when you click on the lock symbol at the top of the OTRS screen. In the grey bar, you can select between 4 subsets:

The OTRS QueueView, Small (Screenshot by Florian Snow) The OTRS QueueView, Medium (Screenshot by Florian Snow) The OTRS QueueView, Large (Screenshot by Florian Snow)

Browsing a ticket queue

You can see all the tickets in a queue when you click on the “Tickets” button at the top of the OTRS screen and then select the queue you want to examine.

If a queue contains unlocked tickets (i.e. tickets for which nobody has taken responsibility) older than 24 hours, the queue name is displayed in yellow, and after 48 hours, it turns red.

The numbers behind the queue name indicate the total count of tickets in that queue (including subqueues) and the count unlocked tickets.

If you repeatedly click on the same queue name, you toggle between whether or not tickets from subqueues should be included in the list.

In the grey bar, you can again select between two subsets:

Searching for tickets

When you click on the button with the magnifying glass symbol at the top of the OTRS screen, you can do a full-text search through all tickets.

Browsing options

All the above lists offer three different display variants which can be selected at the top right of the list:

Small

In the most compact view, you can click on any column header to sort by this column. Some column headers also display a funnel symbol; clicking on that gives you the opportunity to filter the list by that column. Please be aware that these settings get stored, so if you want to reset to a non-filtered view, simply click on the trashbin symbol at the top right of the list.

Medium

In the medium view, you see all available metadata about the ticket, but you don't have the flexible options for sorting or filtering as you have with the small view. On the other hand, whenever you move the mouse into a ticket's area on the screen, you receive a menu with some important operations for the ticket, so you can apply these operations without actually opening the ticket.

Large

In the most verbose view, you see the ticket metadata and a list of articles (emails and internal notes), with the last article being unfolded. You can unfold older articles by clicking on their line in the list. Again, some operations are availabe through a menu popping up when you move the mouse over the ticket, and you can also initiate a replay to an article directly from this list.

Advanced operations

Declaring to be unavailable

If you are on vacation or not able to handle tickets for another reasons, it's a good idea to declare this in the ticket system, so nobody else assigns you an urgent ticket during that time. In the preferences view (which you get when you click on the avatar at the top left of the screen), go to personal preferences, and there declare that you're “out of office” with a start and end time.

Creating a new ticket

If you want to start a new ticket with an outgoing email rather than reacting on an incoming one, open the “Ticket” menu at the top of the OTRS screen and choose “New E-mail Ticket”.

Handling phone calls

In the ticket view, the menu “Communication” contains the items “Phone Call Outbound” and “Phone Call Inbound”. Use these items to add notes about phone calls to the ticket.

To start a new ticket with an outbound phone call, open the “Ticket” menu at the top of the OTRS screen and choose “New Phone Ticket”.

Withdrawing responsibility

There are two distinct possibilities to withdraw your responsibility for a ticket:

  1. Assign ownership to somebody else: In the ticket view, in the menu “People”, choose the item “Owner” and set the ownership to the person you want to pass responsibility to.
  2. Unlock the ticket: In the ticket view, in the menu “Miscellaneous”, choose the item “Unlock”.

Passing a ticket to somebody outside the ticket system

Sometimes a request has to be handled by a team which does not use the ticket system for its work. In this case, it is possible to pass the ticket to a mailing list or even a personal email address:

  1. Open the ticket.
  2. Select the article (email or internal note) which you want to pass on (usually it will be the only article in the ticket at all).
  3. From the article menu, select “Bounce”.
  4. Enter the email address to which you want to pass the request.
  5. Check the “Inform sender” checkbox.
  6. Adapt the text of the notification to your needs.
  7. Click on the “Send” button.

Merging tickets

You can merge two or more tickets into one. Use this, for example, if the customer sends a new email instead of replying to a previous one, so the ticket system cannot recognize that the email belongs to the old ticket and creates a new one.

To merge two tickets:

  1. Note the ticket number of the ticket you want to keep (usually the older one).
  2. Open the ticket you want to merge (usually the newer one).
  3. In the ticket menu, select “Miscellaneous” - “Merge”.
  4. Enter the ticket number you previously noted.
  5. Click on “Send”.

Splitting tickets

This is the opposite case: during the communication around a ticket, a topic came up which actually would justify to open a new ticket for handling it.

To split off a new ticket:

  1. Open the original ticket.
  2. Select the article (email or internal note) which should serve as the starting point for the new ticket.
  3. From the article menu, select “Split”.
  4. Choose the queue in which the new ticket should go.
  5. If you want, immediately assign the ticket to somebody (for example, to yourself).
  6. Enter a good subject. Note that this subject will be used as the title for the new ticket!
  7. If you want, modify the text, for example by removing parts irrelevant for the new ticket, or adding a remark by yourself.
  8. Select a ticket state for the new ticket (actually only “open” and “pending reminder” make any sense).
  9. Click on “Create”.

Bulk actions

Sometimes you want to apply an operation to many tickets at once. To do this, use any of the browsing options (My Locked Tickets view, Qeue view, Search) to get those tickets in a list, mark the checkbox at the very left for each ticket you want to touch, and then click on ”Bulk” at the top left of the list. Note that with doing this, you implicitly assign all these tickets to yourself. Now, you can change state and owner of the tickets, move them into another queue, merge all of them into a single ticket, even add a note to all of them, and on your choice automatically unlock all the tickets again after the operation was performed.

Please note that you cannot perform a bulk action on tickets that are locked by somebody else.


Category/HowTo

TechDocs/TicketSystem (last edited 2020-12-17 07:36:54 by mk)