RT: Difference between revisions

From SNAFU Con Wiki
Jump to navigation Jump to search
(not sure what I did. It was sitting open for a long while. Saving just to be sure.)
(large overhaul for new users, mostly on how to reply/comment)
Line 1: Line 1:
[[Category:Procedures]][[Category:Third Party Software]]
[[Category:Procedures]][[Category:Third Party Software]]
==Request Tracker==
==Request Tracker==
RT (Request Tracker) is the ticketing system the con uses to handle email requests. The goal is to have '''all''' departmental emails in RT over the next few years. Please read through this if you are new to RT. '''PLEASE''' update this with detailed procedures as you learn how to do things that aren't listed here.  
RT (Request Tracker) is the ticketing system the con uses to handle email requests. As of 2016, '''all''' departmental emails are handled in RT.  
 
The best way to think of RT is like a really fancy group email system. Queues are the group email boxes. Multiple people can see and handle emails, and everyone who is involved with that box gets updated on everything going on so that everyone is on the same page.


==Logging in==
==Logging in==
You can access RT from '''[http://mail.snafucon.com/tickets/ mail.snafucon.com/tickets/].''' Your account is now linked to [[BACON]] and so you only need to log in with your current username and password. However, you will need to have privileges set up first or you will only be able to see your tickets - not actually be able to see or answer any from the queue.   
You can access RT from '''[http://mail.snafucon.com/tickets/ mail.snafucon.com/tickets/].''' Your account is linked to [[BACON]] so log in with your current username and password. However, you will need to have privileges set up by the admin or you will only be able to see your previous tickets (if any) buy not actually be able to see or answer any from the queue.   
 
==Reply/Comment to a Ticket==
When you reply to a ticket it is sent to all of the people who administer the queue that it is in, and the requester (the person who sent the email in the first place.)
 
When you comment on a ticket, it is only sent to the people who administer the queue.
 
There are two ways of replying to and commenting on tickets.
 
===Reply by Email===
You should only reply by email if you aren't closing or resolving the ticket. You can not resolve the ticket by email.
 
#Simply respond to the email that was sent to you.
 
Notice that the email you're sending goes back to the queue email. So, if you're responding to an email that originally went to registration@, then the email you send will also go to registration@. It is important that you do not alter the subject. RT will look at the subject to put the reply in the right ticket.
 
The information that is added to the beginning of the email you received (the ticket information with Queue info and Ticket URL, etc.) '''WILL be included in your email if you don't delete it'''. It is up to you if you want that information in your email, but it should probably be removed before sending to minimize confusion.
 
===Comment by Email===
Comment by replying and changing the email to (queueemail)+private@ snafucon.com
So if the queue email was registration, you can comment by sending an email to registration+private@
 
As before, keep the subject the same so RT can route your comment correctly.
 
 
===Reply/Comment by Logging In===
To reply to a ticket you need to get into a ticket to view it. You can click on a ticket from your dashboard, or from your queue.
 
#To reply/comment to the ticket, scroll down to the '''History''' section. You can view all history for this ticket (emails in and out).
#Click Reply or Comment
[[File:History.png]]
#If you are the first reply, on the right-hand side you may want to update the '''Status to Open''' and the '''Owner to you'''. RT should update it for you after your reply if you don't make any settings. '''If you are closing the ticket''' you will want to change the status to '''resolved''' (or rejected as applicable). [[file:Ticket and Transactions.gif]]
#Type your reply in the box (if you have one set up, your signature is automatically added to the end of the message - if you are replying at the top of the message make sure your signature is at the top. If you are replying in-line, your signature stays at the bottom).
#If you want to add a person as a one-time cc or bcc, then do that in the applicable fields
#When you are ready to send your reply (or add your comment), click "Update Ticket" and your reply will be sent and will show in the ticket history
 
'''NOTE:''' The reply box is exactly the same for reply or comment except it will be pink if you are replying. If you want to change your reply to a comment (or vice versa) on the right-hand side of the screen there is a drop-down menu and you can change whether the message you are writing is a reply or a comment. The color of the text area will change accordingly.
[[file:Reply-vs-comment.png]]
 
 


===Changing Your Password===
Your password is set by [[BACON]]. If you need to change your password you need to do it there.


==Queues==
==Queues==
Line 24: Line 63:


[[file:Bulk_Update.gif]]
[[file:Bulk_Update.gif]]
==Replying or Commenting==
To reply to a ticket you need to get into a ticket to view it. You can click on a ticket from your dashboard, or from your queue.
You can update all the headers' information. See Updating below.
#To reply to the ticket, scroll down to the '''History''' section. You can view all history for this ticket (emails in and out).
#Click Reply or Comment
#If you are the first reply, on the right-hand side you may want to update the Status and the Owner. RT should update it for you after your reply if you don't make any settings. '''If you are closing the ticket''' you will want to change the status to resolved (or rejected as applicable).
#Type your reply in the box (the signature is automattically added to the end of the message - if you are replying at the top, move your signature but if you are replying in-line, leave it at the bottom).
#If you want to add a person as a one-time cc or bcc, then do that in the applicable fields
#When you are ready to send your reply (or add your comment), click "Update Ticket" and your reply will be sent and will show in the ticket history
'''NOTE:''' The reply box is exactly the same for reply or comment except it will be pink if you are replying. If you want to change your reply to a comment (or vice versa) on the right-hand side of the screen there is a drop-down menu and you can change whether the message you are writing is a reply or a comment. The color of the text area will change accordingly.


==Updating a Ticket==
==Updating a Ticket==
Line 59: Line 84:
If you have two or more tickets that are really all part of the same thread then they should be merged into the same ticket. Luckily, merging is really easy (a little TOO easy).
If you have two or more tickets that are really all part of the same thread then they should be merged into the same ticket. Luckily, merging is really easy (a little TOO easy).


===Merging One Ticket===
#In the ticket view click on "Links"
#Fill out the Merge Into field the bottom
#Click Save Changes
The ticket is now merged.
===Merging by Bulk Update===
The way you merge tickets is:
The way you merge tickets is:
#Determine the id number of the main ticket you want to merge into.  
#Determine the id number of the main ticket you want to merge into.  
Line 64: Line 96:
#Scroll to the bottom and enter the id number of the main ticket  
#Scroll to the bottom and enter the id number of the main ticket  
#Click Update.
#Click Update.


[[File:RT_Merge.png]]
[[File:RT_Merge.png]]

Revision as of 12:22, 23 January 2016

Request Tracker

RT (Request Tracker) is the ticketing system the con uses to handle email requests. As of 2016, all departmental emails are handled in RT.

The best way to think of RT is like a really fancy group email system. Queues are the group email boxes. Multiple people can see and handle emails, and everyone who is involved with that box gets updated on everything going on so that everyone is on the same page.

Logging in

You can access RT from mail.snafucon.com/tickets/. Your account is linked to BACON so log in with your current username and password. However, you will need to have privileges set up by the admin or you will only be able to see your previous tickets (if any) buy not actually be able to see or answer any from the queue.

Reply/Comment to a Ticket

When you reply to a ticket it is sent to all of the people who administer the queue that it is in, and the requester (the person who sent the email in the first place.)

When you comment on a ticket, it is only sent to the people who administer the queue.

There are two ways of replying to and commenting on tickets.

Reply by Email

You should only reply by email if you aren't closing or resolving the ticket. You can not resolve the ticket by email.

  1. Simply respond to the email that was sent to you.

Notice that the email you're sending goes back to the queue email. So, if you're responding to an email that originally went to registration@, then the email you send will also go to registration@. It is important that you do not alter the subject. RT will look at the subject to put the reply in the right ticket.

The information that is added to the beginning of the email you received (the ticket information with Queue info and Ticket URL, etc.) WILL be included in your email if you don't delete it. It is up to you if you want that information in your email, but it should probably be removed before sending to minimize confusion.

Comment by Email

Comment by replying and changing the email to (queueemail)+private@ snafucon.com So if the queue email was registration, you can comment by sending an email to registration+private@

As before, keep the subject the same so RT can route your comment correctly.


Reply/Comment by Logging In

To reply to a ticket you need to get into a ticket to view it. You can click on a ticket from your dashboard, or from your queue.

  1. To reply/comment to the ticket, scroll down to the History section. You can view all history for this ticket (emails in and out).
  2. Click Reply or Comment

History.png

  1. If you are the first reply, on the right-hand side you may want to update the Status to Open and the Owner to you. RT should update it for you after your reply if you don't make any settings. If you are closing the ticket you will want to change the status to resolved (or rejected as applicable). Ticket and Transactions.gif
  2. Type your reply in the box (if you have one set up, your signature is automatically added to the end of the message - if you are replying at the top of the message make sure your signature is at the top. If you are replying in-line, your signature stays at the bottom).
  3. If you want to add a person as a one-time cc or bcc, then do that in the applicable fields
  4. When you are ready to send your reply (or add your comment), click "Update Ticket" and your reply will be sent and will show in the ticket history

NOTE: The reply box is exactly the same for reply or comment except it will be pink if you are replying. If you want to change your reply to a comment (or vice versa) on the right-hand side of the screen there is a drop-down menu and you can change whether the message you are writing is a reply or a comment. The color of the text area will change accordingly. Reply-vs-comment.png



Queues

Most users will only have one Queue, but some users will have multiple ones. The easiest way to navigate RT is by queue, especially if you need to do something to a lot of messages at once. The Queues you have access to are listed on the right-hand side of the screen under "Quick Search."

Bulk Update

To do a bulk update (most useful for deleting spam):

  1. From the landing page, click on the queue you want to update (right-hand side of the screen)
  2. In the upper-right corner, click on Bulk Update
  3. Uncheck the messages you want to leave alone, or use the Clear All button at the bottom if that's faster.
  4. Once you have only the messages checked that you want to update, scroll to the bottom
  5. In the form at the bottom make the changes that you want to apply to all the messages checked. To set them to "deleted," you pull down the drop-down next to Make Status and choose deleted.
  6. Once you have filled the form with all the changes you want to make, click Update.

You can also use Bulk Update to merge tickets (see below) or do many other maintenance tasks. Deleting is the most common.

Bulk Update.gif

Updating a Ticket

Once you are in a ticket you will see a header with all sorts of information you can change. Every section had things you can modify by clicking on its header. So, if you want to update who owns the ticket and whether it's open/closed, you can click on The Basics and update those things from there. If you have multiple queues you can change what queue the ticket is in from The Basics section, because people often send requests to the wrong email.

Statuses

  • New status is the default status for new tickets.
  • Open status is best for tickets that we have replied to and are in the process of helping but are completed.
  • Stalled status is best for tickets that are on hold for some reason.
  • Resolved status is for tickets that are completed and closed.
  • Rejected status is used for tickets that we aren't answering intentionally, or we've answered and asked for more info, but they aren't getting back to us and after a long while we just want to clear it from the queue.
  • Deleted status is best for spam or emails that don't need to be in the ticketing system. DELETED TICKETS ARE NOT TRULY DELETED at first. So, if you set it to deleted accidentally and then need to fix it, you can. About twice a year the admin will purge the deleted tickets from the system.

When a ticket is resolved, rejected, or deleted, it will disappear from your queue but is not actually deleted from the system.


Merging Tickets

Sometimes the way someone replies to a thread opens a new ticket. Sometimes people email multiple times. Sometimes you just need to merge everything together.

If you have two or more tickets that are really all part of the same thread then they should be merged into the same ticket. Luckily, merging is really easy (a little TOO easy).

Merging One Ticket

  1. In the ticket view click on "Links"
  2. Fill out the Merge Into field the bottom
  3. Click Save Changes

The ticket is now merged.

Merging by Bulk Update

The way you merge tickets is:

  1. Determine the id number of the main ticket you want to merge into.
  2. Go to bulk update for that queue and select the other ticket(s) you want to merge
  3. Scroll to the bottom and enter the id number of the main ticket
  4. Click Update.


RT Merge.png

You should now have the whole thread in one. Notice that it warns that the process is not reversible, so don't mess it up!

CAUTION: If you do any more bulk updating RT will continue to merge tickets until you either navigate to another page or clear out the merge field!

For the Admin

To add a user to a queue

  1. Admin->Users->Select
  2. Put user in the go to user box. Unfortunately this will not necessarily be all the users.
    • If the user does not exist, it needs to be created. So you can create the user by sending them an email from RT letting them know they can log into RT. It's freaking magic!
  3. Open the user account
  4. Check the box to make the user a privileged user
  5. Save Changes at the bottom
  6. Admin->Queues->Select
  7. Select the queue
  8. Click "Watchers"
  9. enter the user's name in the "Find People whose" box and hit Go - The user will show up in the lower right area
  10. Select "AdminCC"
  11. Click "Save Changes"