Working on tickets
Introduction
This page helps guide Support Engineers (SEs) to find, select, and work support tickets.
Zendesk views
The default views in Zendesk for Support Engineers (SEs).
Name | Purpose |
---|---|
My Assigned Tickets | Tickets assigned to you that are not Solved or Closed . |
The Global Support Ticket View | Shows all unassigned tickets, sorted by ticket weight. This is the primary view for all support engineers to work from. |
Assigned Support Engineer Tickets | Tickets from organizations that have an Assigned Support Engineer (ASE). |
L&R | Licensing & Renewals tickets |
All FRT and Emergencies | New tickets in the FRT stage. |
All NRT | Non-new tickets in the NRT stage. |
Selecting new tickets
Employ the following workflows for:
Choosing Tickets:
- Work from the top of
The Global Support Ticket View
. Tickets are sorted byTicket Weight
to prioritize the highest-impact tickets first. Tickets receive additional weight as they progress through their FRT and NRT life-cycles, ensuring that soon to breach tickets do not remain low in the view. When everyone aims to start from the top of the queue, it supports our ability to achieve our SLAs. - Take and keep assignment of tickets that have your region as the preferred one. For tickets with other preferred regions, work them by putting out a quality first response. Then follow the guidelines for rehoming tickets to transfer them to the customers’ stated preferred region. (NOTE: APAC may also maintain assignment of low priority tickets with a preferred region of AMER.)
- Both FRT and NRT tickets that do not have an assignee are presented in this view.
Consider assigning tickets that have a status of
open
orpending
and that have your region as the preferred one. These all need owners within the preferred region on the same day they are rehomed from other regions. Refer to the receiving a ticket rehome section of this page for guidelines on working these tickets.
Assigning Tickets:
- Assign tickets to yourself using the “Take It” button and update status to
Open
orPending
. - Please note that the SLA clock continues to run until you’ve sent a public response to the user.
Managing ticket load
- Regularly review your
open
,pending
, andon-hold
tickets under My Assigned Tickets to maintain a balanced workload. - Aim for a manageable number of tickets, adjusting based on daily demands and personal capacity.
- Aim to adhere to the support ticket SLA/SLOs:
- Urgent FRT 30m, NRT 4h
- High FRT 4h, NRT 4h
- Normal FRT 8h, NRT 24h
- Low FRT 24h, NRT 24h
First response and ongoing communication
When starting work on a ticket, prioritize these steps to effectively address the customer’s needs and streamline the resolution process:
- Confirm Understanding: Begin by confirming in the first response your understanding of the customer’s situation, needs, and the problem or question they need resolved. If unsure, request clarification or propose a brief meeting to discuss details.
- Review Past Interactions: Check the customer’s recent tickets for related issues or useful background information. Confirm any relevant environmental details with the customer and review any organizational notes in Zendesk that might dictate specific actions or communication methods.
- Adjust Priorities: If the ticket’s priority doesn’t align with our
Definitions of Support Impact,
discuss and adjust the priority with the customer using the
General::Changed priority
macro. - Prepare for Emergencies: If the ticket could escalate to an emergency, alert the on-call engineer(s).
- Manage Time Effectively: If an extensive response is required or the SLA is near breaching, send an initial brief response. Outline the actions you will take and when the customer can expect an update. Adjust timelines as necessary based on customer feedback.
- Use Tools: Set the ticket to Open and use ‘Due Date’ and ‘Reminder’ apps to keep track.
By following these steps, you ensure a structured approach to ticket handling that can save time and enhance customer satisfaction.
Ticket transfers
GitLab Support has 2 different types of ticket transfers - rehomes and handovers. The following sections describe these, and the supporting concepts of satellite tickets and hot rehomes.
ReHome 🏠: A reHome
is a transfer of a ticket from the region of the SE who delivered the first response to the customer’s specified preferred region. At the end of the assigned SE’s shift, they will forward the ticket to the appropriate (home) region for completion. These are quick, easy, and should be low effort.
Satellite 🛰️: A ReHomed ticket that remains unassigned during the upcoming shift in the designated “home region” and subsequently circulates globally at least once. These are unintended and we should be working to minimize satellites.
Handover 🤝: When a ticket is transferred from one engineer to another due to factors such as paid time off, expertise, or workload management.
Hot ReHome 🔥: A ticket currently being addressed in a different region than the customer’s preferred one. The ticket then requires a rehome because the customer’s temperature is increasing, which raises the urgency. The sending region makes commitments to the customer with the best intentions, but there is no time for alignment and agreement for the receiving region.
Examples of these tickets include:
-
Tickets for which a call or special follow-up has been promised within the next few hours without confirming availability with the receiving region present a challenge for the Support Engineer to address without adequate preparation. (Direct to Call - DTC)
-
Tickets not in their region that will trigger the Hot ReHome process due to unmet customer expectations with a STAR request (Falling Star).
-
Not ReHomed tickets that require additional attention. (The ticket was held outside of the preferred region for longer than 1 shift, which is raising the risk)
Hot ReHome prevention
Before placing any ticket in a region other than the customer’s preferred one, please ensure the following steps are completed:
Agreement: The customer must acknowledge that their initial request for a specific region will not be fulfilled and must provide their consent. Additionally, they should understand the added value associated with the ticket in the current region.
Understanding: The customer should be made aware that there may be delays in responses. If it becomes necessary to transfer the ticket back to the originally requested region, a transition period will be implemented to ensure the receiving engineer is adequately prepared.
As you work on the ticket, refrain from making promises on behalf of others. Instead, leave a detailed note in the ticket that outlines the customer’s situation and emphasizes the intention to achieve a favorable outcome for them. If necessary, contact a manager in the receiving region for assistance. Furthermore, be considerate of the time of the receiving support engineer.
Ticket rehome (transfer to the preferred region)
GitLab Support uses a single view for all unassigned
tickets, regardless of region. The tickets in the view are sorted by
Ticket Weight
to highlight the highest-priority issues first, and support
engineers are expected to work from the top of the view down. Given this
process, support engineers will frequently be taking tickets on which the
customer has specified a Preferred region
different from their own.
Since we aim in GitLab Support to align tickets to an accountable region, we use the following simple process to handle tickets from different regions:
First response
When providing the first response to a ticket from a different region, follow these guidelines:
- Introduce yourself and acknowledge the customer’s preferred region. (
Support::Out of Region::Cross-region_Preferred region clarify assignment
macro is a good starting point) - Explain that you’re providing initial assistance to ensure a timely response.
- Proceed with all appropriate initial steps to begin addressing the customer’s issue.
- Inform the customer that before the end of your workday you will transfer their ticket to their preferred region for continued support unless they request that you keep it.
- If it’s the end of your work day and the customer hasn’t confirmed the region, move it to the region that they chose when they created the ticket. To do that run the
Support::Rehome::Initiate Rehome
macro.
Initiating a ticket rehome
To initiate a ticket rehome, simply use the Support::Rehome::Initiate Rehome
macro. This macro will:
- Remove ticket assignment
- Apply the
rehome_initiated
tag
If the ticket is waiting on a customer reply put the ticket into “Pending”, if the ticket is waiting on a reply from a support engineer put the ticket into “Open”.
Receiving a ticket rehome
When you take an unassigned ticket from the global view and you see an internal
comment that states Rehome initiated from [assignee's region] to [target region]
, you should follow these steps to receive that rehome:
- Verify Regional Alignment: If the target region specified is your region, continue. Otherwise, leave the ticket unassigned in the view so that an SE from the target region can take it.
- Use the
Support::Rehome::Complete Rehome
macro, which:- Assigns the ticket to you
- Applies the
rehome_received
tag - Creates a public response with some initial text for your use
- Edit the initial text to use your name where the placeholder is
- Proceed with all appropriate initial steps to begin addressing the customer’s
issue, and replace the
Next Steps Here
placeholder with your full update to the customer
Keeping an out-of-region ticket
If a customer responds to your initial update on the ticket with an explicit request that you keep the ticket rather than transferring it to their preferred region, you should follow these steps:
- Use the
Support::Rehome::Do Not Rehome
macro, which creates a public comment with some initial text for you to use. - Proceed as you would with any other ticket
Ticket handover (assignee change not related to preferred region)
When an engineer is required to hand over a ticket, either to another region or within the same region (e.g., due to the assignee going on PTO), the following workflows should be followed.
Preparing a ticket for handover
- Set the proper expectations to the customer.
- It is important to be transparent and communicate that certain requirements, such as phone calls and immediate responses, will necessitate coordination with the receiving person or region.
- Please ensure that the receiving team is properly informed and aligned on any tasks and timelines before finalizing them with the customer.
- Use the Zendesk Zendesk
Handover Ticket Summary
macro to ensure all necessary information is included and the ticket is unassigned. - Set the Zendesk Form Field
Handover Status
toNeed Handover
. - CC yourself on the ticket and save the ticket to the
Open State
.
Working tickets handed over from the same region due to PTO
- Update the
Handover Status
toHandover Completed
to ensure accurate metric tracking. - Review the
Handover Ticket Summary
and the Next Response Time (NRT) SLA. - If ready to proceed:
- Introduce yourself to the customer, confirm the handover, and provide the next technical response.
- If additional research is needed:
- Introduce yourself, inform the customer that further research is required, and set expectations for the next steps.
Working tickets handed over from another region
- Update the
Handover Status
text field to reflect the receiving region. For example, if you are in the EMEA region, set it toHanded over to EMEA
to ensure accurate metric tracking. - Review the
Handover Ticket Summary
and the Next Response Time (NRT) SLA. - If ready to proceed:
- Introduce yourself to the customer, confirm the handover, and provide the next technical response.
- If additional research is needed:
- Introduce yourself, inform the customer that further research is required, and set expectations for the next steps.
Contacting a Customer Success Manager (CSM) or Account Manager (AM)
Engage a CSM or AM for reasons such as discussing architecture, Professional
Services, or support collaboration. If escalation is required, follow the
designated workflow. If no CSM is available, contact the AM, identified in
Zendesk as Account Owner
. To involve a CSM or AM, use the following methods:
- Zendesk: Add the CSM/AM as a CC on the ticket, inform the customer, and add an internal note for context.
- Slack: Notify the CSM/AM with one of the following:
- Mention them in an existing ticket discussion.
- Start a new thread in the customer’s channel (#a_customerName-internal).
- Post a message in a relevant support channel (
#support_leadership
,#support_gitlab-com
, or#support-self_managed
).
Helping with a ticket that has an Assigned Support Engineer
Some customers have an Assigned Support Engineer (ASE) who will own their tickets. This will be apparent from the org note in the ticket. For such customers, see the ASE workflow.
FAQ
How many new tickets should I pick up each week?
Each week, every Support Engineer should aim at least to meet, and preferably to exceed, the appropriate baseline from the following list for the number of first responses:
Ticket type | FRT goal |
---|---|
Self-managed | 6 tickets |
SaaS | 7 tickets |
SaaS Accounts | 8 tickets |
L&R | 24 tickets |
The aim is to ensure equitable ticket distribution among team members. These numbers are based on ticket volume, number of SEs, and average PTO (15%). We continuously monitor ticket volume and number of SEs to make sure the above guidelines are accurate.
What if I can’t meet baseline?
There will be times when you may be leading an escalation, working through challenging tickets, or focusing on non-ticket work, and you cannot take on new ticket assignment. This is okay! The key is to make sure you have coordinated with your regional team and Manager so they are aware of the risks to our team.
What can I do when I’m stuck and I really need help?
Follow the how to get help workflow for guidance.
I’m going to be absent, what do I do with my assigned tickets?
Please see the Support Team Member Time Off page for guidance on taking time off.
What if the customer is absent and wants to keep the ticket open until they return?
In this scenario:
- Acknowledge the customer’s request and inform them of your plan.
- Set the ticket status to
on-hold
. - Change the ticket type to Task.
- Set a reminder for yourself to check in with the customer 1-2 days after their planned return date.
Because of the behavior of On-Hold
tickets
the ticket will remain in the on-hold
state until the customer returns. This
is useful if the customer will be unavailable for 1-2 weeks. If a customer will
be unavailable for a longer period of time, consider asking them to handover the
ticket to a colleague, or open a new ticket upon their return.
May I reassign a ticket to someone else?
There are some situations in which it is appropriate to reassign a ticket. A few common situations are listed below, but others may arise. If you encounter a scenario where you need to reassign a ticket that isn’t detailed in the handbook, please discuss with your manager, and then add it below!
If you’ll be out of office
If you’re out of office, either planned or unplanned, follow the guidance in Support Team Member Time Off.
If you need an expert
If you’ve determined that specific expertise outside your own is required to resolve the ticket, pair with an expert so that you can get the ticket resolved and learn in the process. If that person determines that they need to take the lead due to the advanced or complex nature of the problem, then:
- Send a message to the customer informing them:
- You’ve asked another support engineer with relevant expertise to take the ticket
- You’ve reviewed the ticket with that engineer
- You’ll stay involved in order to help in any way you can
- Assign the ticket to the expert
If you have too many tickets
If you’ve become overloaded with tickets, you may look to find one or more other SEs to take some of your tickets. Be sure you discuss each ticket before reassigning it to gain agreement and so that the other support engineers don’t have to start from scratch.
Once you’ve found a new assignee:
- Add an internal note summarizing the ticket and noting the reassignment
- Send a public reply to the customer informing them of the reassignment
- Reassign to the new engineer
What if a customer has confirmed a ticket can be closed but the ticket has no assignee?
While we should ensure that all tickets always have an assignee from FRT to, close, there are some scenarios where a ticket is ready to be closed but has no assignee. For example, a customer may open a ticket and inform us that they have resolved the issue before we send an FRT. In these scenarios:
- Inform the customer that you are changing the ticket status to solved
- Assign the ticket
- If a solution was provided, assign to the engineer who provided the solution
- If the issue was not solved as the result of a direct suggestion, assign it to an engineer who has significantly contributed to the ticket throughout its life cycle
- If the customer solved the ticket before we could respond, take assignment of the ticket yourself. After all, you’re doing the work of acknowledging the customer’s update, and solving the ticket!
- Mark the ticket as
solved
How many issues or incidents should I handle in a single support ticket?
As detailed in Support General Policies it is GitLab’s policy to handle each unique issue or incident within a single support ticket.
How can I open a new ticket on behalf of a customer?
As detailed in the Support General Policies it is GitLab policy to handle each individual incident, problem or issue within a single support ticket. If a situation arises where you need to open a new ticket on behalf of a customer, you must use the Create new ticket plugin within the Zendesk Super App to ensure proper routing and SLA assignment:
- Within a ticket, navigate to the Zendesk Super App and select the Create new ticket plugin.
- Select the appropriate form type. This will most likely match the request type of the originating ticket.
- Enter the customer’s details like subject, problem description and other relevant information. Use the customer’s existing Zendesk Ticket to obtain the necessary customer information to complete the form.
- Submit the ticket using the
Create Ticket
button.
Once the new ticket has been submitted, the app will provide you with the corresponding ticket ID. You can click the ticket ID to directly navigate to the newly created ticket.
If you plan to immediately start working the ticket, please assign the ticket to yourself.
d7fb6610
)