Import tickets and migrate from Zendesk
You’ve made the decision to transform the way your organization executes support 🎉 Now it’s time to implement that change!
Here are the steps and resources required for successfully launching Gorgias with a Zendesk import. Please follow the instructions outlined in the order below.
You cannot bulk apply Macros to imported tickets if no email integration has been used previously in Zendesk. For example, form submissions. (Gorgias does not have an email integration to use to send automated responses in these cases.)
Tickets coming from Zendesk (imported or continuous integrations) do not trigger rules at all.
You cannot reply to Facebook or Messenger tickets imported from Zendesk
Import Zendesk Data
The previous 2 weeks of Zendesk ticket history are imported first to ensure the most important information is available within a few hours. The rest of the two years of ticket history can take several days to import, depending on the volume.
- Go to Settings > Import Data > Add account > Start import
- Please use this doc to find the Zendesk API
Import progress statistics are collected in the background, so you can see how many tickets are already imported and how many are left while the import is running.
How does the import work?
- Gorgias imports Macros, Users, Tags, and Tickets from Zendesk. Macros are the first item to be imported.
- The previous 2 weeks of ticket history are imported first. The rest is imported starting from 2 years in the past and ending when we reach the 2-week mark imported previously.
- There are 2 ticket statuses in Gorgias: `Open` & `Closed`. `Open` means you need to treat the ticket, `Closed` means you're done with it. As a result `Pending` Zendesk tickets come into Gorgias as `Closed`, but they are tagged as pending automatically. Therefore, you can create a view to see those pending tickets (more info on views here: https://docs.gorgias.com/video-tutorials/organizing-and-creating-views)
- `On-hold`, `Solved` & `Closed` Zendesk tickets will all be imported as `Closed` Gorgias tickets. Channels will be imported as well, (i.e. a closed Facebook Zendesk ticket will come in as a closed Facebook ticket in Gorgias as well)
- Depending on the amount of data, it sometimes can take several days to import ticket history. We import about 2,500 tickets per hour.
After the initial import is finished
- Continuous synchronization is enabled by default. You can disable it on the import page by clicking the "Pause" button.
- Resolve and close any imported Zendesk tickets that are open in Gorgias.
- Start working in Gorgias!
How does continuous synchronization work?
- Gorgias looks for updates in Zendesk every 5 minutes. All new tickets and macros will be imported and the new comments in existing tickets as well.
- If a ticket is already imported in Gorgias and then you close it in Zendesk - the status of ticket will not be synced.
- To stop synchronization you can press "Pause" button.
- To start it back just press "Resume".
Enable channels in Gorgias
Enable any channels you would like to use in Gorgias (email, live chat, social). Instructions for each channel are below. If you want to do this in phases, please see FAQ #11 for more info.
Go to Settings > Integrations > Email > Add email
See FAQ #4 for more info.
- For Direct Integration: Connecting your support email via direct integration
- For Forwarding: How to set up email forwarding
Go to Settings > Integrations > Chat > Add chat. For more context, you can check this article!
Go to Settings > Integrations > Facebook, Messenger & Instagram > Login Facebook. More info to be found here or check our video below!
Disable Channels in Zendesk
Disable any channels you have set up in Zendesk. The instructions for each channel are below.
Open Settings > Channels > Email > Select "firstname.lastname@example.org" > Change this address to default email > Delete all other email connections.
- Go to native email settings (Gmail, Outlook, etc.) and disable any forwarding to Zendesk that is toggled on (please ask your email admin for help on this)
Settings > Channels > Deactivate any connected social media platforms
- Create a Zendesk trigger: "Auto-close social tickets with a new message from the customer"
- Respond & close all social tickets in Zendesk
- Deactivate Facebook in Zendesk
Contact Form / Chat / Help Center
Settings > Admin icon > Channels > Widget > Customization > Flip switch to toggle off
If flipping the switch doesn't disable the widgets on your website, you can also remove the Zendesk code. Search for the Zendesk code in the theme.liquid section of your website's code.
- Here are the Zendesk instructions with more detail
Deactivate all Zendesk triggers
- If you have automation to send a Satisfaction survey, disable it too
Frequently asked questions
- Can I import more than once for the same Zendesk account?
Once the initial import is finished, we do a continuous sync so you don't miss any tickets!
- Can I import multiple Zendesk accounts into one Gorgias account?
Yes, you can! You can run several imports in parallel and you'll also be able to see the progress of each import separately.
- Can I import the last 2 years of my emails before importing Zendesk?
You can, but we do not recommend it. If you import emails before Zendesk, there will be discrepancies between open/closed tickets and some messages will be not imported properly. Please do the Zendesk import and then import your emails to avoid any inconsistencies.
Because of the way the Zendesk & email integration works. In your email 'sent' folder you can see that there are no replies sent from Zendesk. In other words, importing from email before importing Zendesk will import only incoming messages, not outbound messages. After importing some of the messages from email we will not be able to match them with tickets from Zendesk.
- Can I integrate my email in Gorgias and Zendesk at the same time?
If you integrate an email address with Gorgias, Zendesk continuous import is enabled, and that email is integrated with Zendesk as well (or you're forwarding to Zendesk), it will create issues with syncing. This is because messages sync via the integrated email faster than through the Zendesk continuous sync (which runs every 5 minutes). This will result in similar issues as the answer above. It's best to integrate email in Gorgias:
1) After you have already migrated from Zendesk and your team is ready to manage support in Gorgias directly.
2) If you are going to disable that email specifically in Zendesk. You can keep other channels or emails enabled in Zendesk. The continuous import can be left enabled to pull new tickets/comments from other Zendesk channels or other emails, which are not integrated in Gorgias yet. Then you can do each email or channel one by one.
- Do my ongoing conversations with customers have to pause during the Zendesk import time?
Yes, you will have to pause any conversations until those tickets are imported. Since the first 2 weeks are imported first, the pause on these tickets should not be too long (2-3 hours).
- Is it OK if I delete all my imported tickets in Gorgias and run another import to start fresh?
No, you can only do one import per Zendesk domain.
- How can I make sure my open Zendesk tickets that are just imported don't get mixed up with other tickets in Gorgias so I can quickly address those?
You can tag your open tickets with a unique name in Zendesk before you start importing. After the import is completed, you can easily create a view and find your tickets by the tag name.
- Will Aircall tickets port over, including the voicemails?
Yes, they will all port over. The voicemail ticket will contain an external link that you will take you to Aircall.
- I've turned off all the channels in Zendesk and completed the import. Why do I still receive tickets in Zendesk?
Most likely this is because you have not disabled forwarding to Zendesk in your email account. Please log into your email account and disable email forwarding to Zendesk.
- Why did some of our customers' accounts get duplicated upon importing?
This can happen only in the event that the customer's email address was updated in Gorgias while the import from Zendesk was still running. If you change the email address of one of your customers in their Gorgias profile settings while the Zendesk import is still ongoing, that action will create a duplicate of that same customer with the new email address.
However, updating details such as the customer's first or last name won't cause this issue. The account will be updated, but not duplicated.
- Can I do the import in phases?
Yes, you can use Zendesk with any channels that aren't in Gorgias. For example, you can have two emails in Zendesk such as (email@example.com, and firstname.lastname@example.org). You can integrate support@ in Gorgias, and disable it in Zendesk. Messages can still go to support.ca@ in Zendesk, while you respond to support@ in Gorgias.
Please note: it is always mandatory to start Zendesk initial import before integrating the same email into Gorgias, otherwise the ticket history will be inaccurate.
- I've turned off Zendesk and have a backlog of open tickets in Gorgias. Can I apply rules to these tickets?
You can use 'ticket updated' and apply a tag to these tickets to trigger a rule. However, the rules are limited: you cannot use rules with conditions regarding message body, sender, intents, and sentiments. Ticket subject, message source, Shopify, etc. should still work as intended.
- Can I cancel my Zendesk account while the import is in progress?
You can, but we do not recommend it. The API token will expire as soon as you cancel and the import will stop at whatever percentage it is at.