Zendesk Basics
module-name: "Zendesk Basics"
area: "Customer Service"
maintainers:
- atanayno
- support operations
- support managers
Introduction
Zendesk is our Support Center and the main communication line with our customers. This module will bootstrap you to work with Zendesk efficiently as a GitLab Support Engineer.
Goals of this checklist
At the end of the checklist you will be able to:
- Utilize Zendesk to perform ticket management tasks
- Access the CustomersDot (customer portal) to look up customer & account information
- Use helper tools for ZenDesk
General Timeline and Expectations
- Read about our Support Onboarding process; the page also shows you the different modules you'll need to complete as part of your Onboarding.
- This issue should take you 1 day to complete.
Stage 1: Prerequisites
-
Done with Stage 1
Tasks: click to expand/contract
Review the Zendesk resources listed below:
-
Complete Zendesk Agent training -
Sign up at Zendesk University. You'll receive an email with information on accessing the Zendesk courses -
Complete the Zendesk Overview: Support course (approx. 10 min)
-
-
Review additional Zendesk resources and our Zendesk workflow -
Zendesk: UI Overview -
Zendesk: Updating Tickets -
Zendesk: Working w/ Tickets (Read Avoiding Agent Collisions carefully) -
Zendesk: Using Macros -
Zendesk: Triggers and how they work -
Zendesk: Formatting text with Markdown -
GitLab: Useful tools for copying internal notes/drafts to public replies and for spell-checking -
Zendesk: Support search reference -
GitLab: working with macros in Zendesk -
GitLab: translation using Unbabel for Zendesk -
GitLab: triggers in Zendesk. -
GitLab: Marking tickets as spam in Zendesk; more details on the alternate way to mark tickets as spam.
-
-
Check how your personal Zendesk signature looks like. -
In Zendesk, click your user icon in the upper-right corner, select View Profile and check the Signature field.
-
-
(optional) Determine if you want personalized salutation such as Thanks
orBest regards
in your Zendesk signature- You can add these by editing the support-team.yml file, but it's better to end each message with words that match the situation of that ticket.
Stage 2: Studying ticket lifecycle
-
Done with Stage 2
Tasks: click to expand/contract
This section describes the common lifecycle of a ticket and explains how to use some Zendesk features while working with tickets. Each theoretical part is accompanied by some practical steps. Be sure to go through all the practical steps to make sure that you understand Zendesk behavior correctly in each case.
We have created a test organization, Zendesk Basics Module
, for this Module. Please use it for all the tasks below.
-
Ticket statuses: read the article about ticket statuses to understand how we use them in GitLab Support. -
Creating a new ticket: GitLab customers can submit tickets by navigating to our Support Portal and completing the support form.
Sometimes you may need to create a new ticket for a customer. Common use cases include:
- Creating a follow-up ticket for an emergency
- A ticket is too long and it contains a mix of various issues, so you want to move one of those issues to a new ticket
To create a ticket as a support agent:
- Open our Support Portal in a new browser (or via incognito mode)
- Select the correct form to use
- Fill out the form information relevant to the customer you are submitting the ticket for
- Make sure to use the customer's email, not your own
- Submit the ticket
Notes:
- It is highly recommended to create a ticket as a customer, not as an agent. In this case, it will get proper SLA immediately.
- After a support agent creates and submits a ticket as
New
orOpen
, the ticket will have no SLA. SLA is assigned only when a customer updates a ticket. If you decided to create a ticket on your own, it is recommended to send a reply to the customer and submit a ticket asPending
,Solved
orOn-hold
, depending on the situation. - When a ticket is submitted by an unknown user, a user account will be automatically created by Zendesk.
Practice:
-
Create a ticket pretending you are a customer by completing the form from the Support Portal. Use the following values for each field. Once you fill out the form, submit it and look for an automated reply in your personal email. Field Value Choose the reason why you are reaching out to us today Support for GitLab.com (SaaS)
Your email address Your personal email Subject ***IGNORE*** Test ticket only for ZD Basics Onboarding ***IGNORE***
Description Add a description that reiterates that this is a test and can be ignored Tell us about your GitLab subscription Free user
Problem type Project in broken state
GitLab.com Username Your GitLab.com username GitLab.com Project Path test/test
What is the ticket severity? Severity 4
Priority Low
Preferred region for support Select the appropriate region for you -
Auto-responder will ask you to provide a support entitlement. Reply to the auto-responder via e-mail with any message. -
Log in as an agent and find the new ticket by searching for the ticket name -
Take ownership of the ticket by using the "take it" link in the upper left area -
Log in to Zendesk as the end-user that you used to create a test ticket and explore how it looks like in this mode. To get a password, you will need to click Sign in > Get a password in the Support Portal.
-
Modifying CC list in tickets. To add yourself, a customer or another GitLab team member to the CC list in the ticket: - Open the ticket in the agent interface.
- Copy the email address you need to add and paste it to the
CCs
field. - Click
Submit
to save your change.- Note that this will save any text that you have entered in the "Public reply" or "Internal note" field. Be aware that in case of having entered text in the "Public reply" field, this content will be sent as a response to the customer upon doing so. This happens whether the ticket is submitted in the same state or in a new state.
- Zendesk will send only public replies to non-GitLab users who are included in the CC list of a ticket, whereas it will send all replies, public or internal, to the Support Agents in the CC list.
Note: At the moment the ability to add addresses to the CC list via the support portal is disabled due to this security issue, which is why we need to perform this action for customers.
If you need to remove someone from the CC list:
- Open the ticket in the agent interface.
- Click the cross near the specified email address to remove it and click
Submit
to save the change.
Practice:
-
Add your work email address to the CC list of the previously created ticket.
-
Changing a ticket's form and sending replies: In most cases the customer selects the correct ticket form when they submit a ticket. If the specified form looks wrong, likely the customer made a mistake. Given this possibility, please always review the contents of a new ticket and do the following:
- If the current form used and the form that is needed is SaaS, SaaS Account, or Self-Managed, you can change the form on the current ticket.
- If the above is not true, use the macro
General::Forms::Incorrect form used
Practice:
-
As a support agent, send a reply to the ticket and set the ticket to Pending. -
You will get a message in your personal email. Now reply back from your personal email and check Zendesk; you will see that the ticket is back in the views, it has Open status and SLA is shown in green.
Note: there is a limitation on Zendesk side: markdown only works for support agents, not for customers.
-
Using macros in tickets: a macro is a message template that you can use as a starting point for a public response in a common situation, such as: - You need to change the form of a ticket from Self-Managed to GitLab.com or vice versa.
- You need to provide a CE user with information about free support resources.
- You need to explain to a GitLab.com user what they can do to reset 2FA.
- After the call with a customer, you would like to summarize everything that was done during the call.
Please edit the message contents after applying the macro so that the message is delivered in your own voice and is appropriate for the ticket.
To add a macro to your reply:
- Open a ticket.
- Click the
Apply Macro
button. - Search for the macro if you know its name or find it in the list, and then click it. The macro will be added to the comment field of your ticket.
Practice:
-
Let's pretend that you scheduled a call with customer. In order to meet the SLA, reply to the ticket and set it to On-hold. Note that this action will reset the SLA clock and assign the ticket to you. If you leave it in the On-hold status for 4 days, it will be reopened but there will be no SLA. If you want to put a ticket to On-hold once again, you will need to send another public reply to do it. -
Suppose that you held a call with a customer and fixed the problem they had reported. Add the Post-customer call macro to the ticket, fill in the template provided by the macro and set the ticket's status to Solved when sending the update. Check that you got email messages in your personal email inbox regarding all these actions. Note: if you want to put a ticket to On-hold status for a longer period of time, utilize our GitLabReminders App, see GitLab Reminders App & GitLab Reminders App project for details.
-
Using Unbabel to translate your replies: If a customer's reply was sent in one of non-English languages supported by us, we should reply using Unbabel - automatic translation tool built as Zendesk app. Please do not use it with test tickets though, as they are paid for us. Instead, it is recommended to read Unbabel for Zendesk Support and review existing tickets where Unbabel was used to learn more about the syntax specifics. You can also find the recorded training session and slides provided by Unbabel when it was first introduced to GitLab.
Practice:
-
Find some tickets translated using Unbabel. You may do it by searching for tickets with unbabeled
tag -
Briefly review 2-3 tickets and check how Unbabel syntax was used in practice.
Note: if a ticket has any status other than Closed,
#unbabel
keyword will be automatically inserted to the internal comment field. Make it a habit to remove those comments as they can be confusing to others: if you leave a comment there, Zendesk will show that you are editing a ticket. -
-
Changing Priority and using a macro This exercise combines a couple of the previous exercises. Start by reading about ticket priority. Practice:
-
Change the priority on one of your tickets and use the appropriate macro as part of your response.
-
-
Merging tickets: Sometimes customers create duplicate tickets. In order to avoid confusion it is a good idea to merge them into one. Let's imagine we have tickets 0001
and0002
, and we want to merge0002
into0001
. To do it:- Open the ticket
0002
. - Click the arrow to the far right of the ticket subject, and select
Merge into another ticket
. - The
Ticket merge
dialogue will appear. Enter the ticket ID0001
into the fieldEnter ticket ID to merge into
and clickMerge
. - In the next window it is important to pay attention to the
Requester can see this comment
checkboxes. It is recommended to ensure the checkbox is unchecked for both tickets. - Important: note that it is not possible to unmerge tickets. Be careful and thoroughly check everything before merging tickets.
Practice:
-
Create two tickets using the Support Portal. After that, as an agent, merge the second ticket into the first one.
- Open the ticket
-
Viewing original email message: Sometimes you will see that there is an envelope icon in the upper right part of the customer’s comment. It can contain some useful information such as: - original formatting of the e-mail message - the list of original recipients that the customer attempted to CC - replies to questions that the customer has placed inline in the quoted text
To view the original email message, follow the steps from How can I view the original recipients of a ticket I received in Zendesk Support?
Practice:
-
Send a reply as an end user to one of your test tickets. Use your e-mail agent to do it, add some random e-mail to CC and apply any formatting you like. -
Open this ticket as an agent in Zendesk. You will see that the formatting and CC list is not reflected there. Open the original email message to see them.
-
-
Cleanup: after you are done with all the tests, please close all your tickets: - You may mark them as Solved. Such tickets will move to Closed automatically after 7 days according to Understanding Ticket Status.
- You may mark them as Pending but note that if you do so for a ticket that has SLA, you should send a public reply when moving it to Pending. After 20 days in the Pending status, the ticket will be marked as Solved.
- Make sure that there are no test tickets left in On-hold status as they will move to Open in 4 days.
- It is considered a good practice to delete your user and all the test tickets you created. To delete a test ticket, click the arrow to the far right of the ticket subject > Delete > Ok. To delete a test user, click the user, find the same arrow icon and click Delete > Ok.
Stage 3: Learning about Zendesk from the Support Operations point of view
-
Done with Stage 3
Our Support Operations team has prepared some materials about how we use Zendesk that you may find useful.
(NOTE: The materials were compiled February/March of 2021 and some information is outdated, please check the handbook for the most up-to-date information about Zendesk)
Watch the below-listed videos and review presentations associated with them:
-
Watch videos from the playlist State of Zendesk Global: around 35 min totally -
Review the presentations associated with the videos if you prefer text over videos:
Stage 4: Zendesk Instances
-
Done with Stage 4
Tasks: click to expand/contract
-
Read about the different Zendesk instances. -
If you are a U.S. Citizen, you will be working in the U.S. Federal instance in addition to the standard instance. All other team members should be aware that there is a U.S. Federal instance and who it's for.
Stage 5: Looking up Customer & Account Information
-
Done with Stage 5
Tasks: click to expand/contract
We use several tools to look up customer & account information.
Customer Portal and LicenseDot App
-
Familiarize yourself with the workflow for looking up customer information. -
Read about and be aware of the CustomersDot, and the LicenseDot apps.
If you will primarily focus on License & Renewals, you should be given access to the above tools, along with training on the License & Renewals workflows.
Congratulations! You made it, and now have a basic understanding of using Zendesk for ticket management!
You are now ready to continue on your onboarding path to tackle the next module in line based on your role. Reach out to your manager or onboarding buddy if it is not assigned to you yet; you can check the onboarding page or your New Support Team Member Start Here
issue to see the list of all modules under the Onboarding pathway.
Please also submit MRs for any improvements to this training that you can think of. The file is located in an issue template in the support-training repository.