Migrate Data From Other Help Desk Servers to Zoho Desk (Zwitch) - Online Help | Zoho Desk

Migrate Data from Other Help Desk Services to Zoho Desk (Zwitch)

Customer support is the cornerstone of every organization. Businesses rely on help desk software that simplifies ticket management, streamlines support processes, and improves overall customer satisfaction.
 
As your business expands, your requirements evolve, leading you to seek a more robust system that aligns with your expectations. When you move to other software, it's important to migrate the existing data to prevent data loss, track essential information, safeguard confidential details in tickets and conversations, and maintain continuity of agent and knowledge base resources.
 
Zoho Desk is a cloud-based platform that enables easy data migration from other help desk systems. The robust ticketing and customer service software allows teams to work more efficiently and effectively towards providing a better support experience.
Data can be migrated to Zoho Desk securely from the following services:
  1. Freshdesk
  2. Zendesk
  3. Salesforce
  4. Kayako
  5. Intercom
  6. HappyFox
  7. Help Scout
  8. Other services
Info Permission Required
The Primary Contact of the Zoho Desk account and users who are Support Administrators can initiate data migration.
Check Feature Availability and Limits

Exporting data from existing accounts

Before migrating to Zoho Desk, ensure that data from your current application is exported in the format specified below. In addition, before you begin data export, certain key information must be readily available. Refer to the table below for details:
Services
File Format
Key Requirements
Freshdesk
XML/JSON

  1. Service URL
  2. API Key
Zendesk
JSON

  1. Service URL
  2. Email
  3. API Token
Salesforce
CSV

  1. Service URL
  2. Email
  3. Password
Kayako
SQL

  1. Service URL
  2. Email
  3. Password
Intercom
CSV

  1. Service URL
  2. Access Token
HappyFox
  1. Data can be fetched via API calls.
  2. Attachments as zip file

  1. Service URL
  2. Auth code
  3. API Key
Helpscout
Data can be fetched via API calls
  1. Service URL
  2. API key
  3. App ID
  4. App Secret
Others
  1. CSV
  2. Documents submitted in other formats will be analyzed. Migration will be initiated upon validation.
  1. Service URL
  2. Email
  3. Password

Prerequisites

  1. You must provide the API key from the service you are migrating and ensure it remains active throughout the migration process.
  2. Disable Zoho CRM or Salesforce integration (if enabled) during migration to prevent duplicating contacts and accounts in Zoho Desk.

Must know to ensure appropriate ticket assignment 

  1. Provide the Name or ID of agents, fields, and departments for mapping the records accurately and avoid mismatches or errors during migration.
  2. Tickets are mapped to agents using their email addresses. Make sure the agent email addresses are correct in the data file. 
  3. Ensure the agents are active in the Desk account and their email address is the same as that mentioned in the source file. This will ensure the ticket details, contact information, and comment ownership is retained. Read more on accepting the invitation.
  4. If the agent is inactive or there is a mismatch in the email address, the tickets will be assigned to the Primary Support Administrator by default.

General information

  1. Supported edition - Migration is supported for all paid editions. For Trial Edition, you can migrate only up to 2 GB of data.
  2. Data center - Automations, configurations, and setups will be migrated only within the same data center. For example, USDC to USDC but not USDC to CNDC.
  3. Probability of failure - 3% to 5% migration failure could occur due to data limitations or schema mismatches. Failed data will be provided as a backup in a .csv file.
  4. Migration ETA - The timeline for data migration depends on the volume of records being transferred and is processed on a priority basis (queue-based). As a result, an exact ETA can be provided by the team after data analysis and once the migration begins.
  5. File size - File size up to 10GB can be uploaded during the process of migration. For files more than 10GB please contact the support team at: support@zohodesk.com  
  6. Migration cancellation -  Data migration requests can only be cancelled if their status is Submitted in Queue.

Understanding the data migration process​

​The migration is carried out in two phases by Desk's migration team.

Best practices
  1. Before performing the full-scale migration (Phase I), it's advisable for customers to initiate a Sample Migration, a small-scale transfer of minimal data to test the migration process.
  2. Typically, data migrations are performed in two phases. In Phase 2, all additional requests will be accepted and completed. However, any requests made after Phase 2 will not be accepted.

Phase 1 

The Initial Migration phase involves transferring all data from your source account to the destination account (Zoho Desk account). Data from the modules, such as tickets, contacts, and accounts, are migrated in bulk. A support ticket will be created to share migration details.
Once the migration is complete, migration report and error logs are generated to give you a detailed view of the progress. These reports are shared with the primary contact (or who initiated the migration)  in a compressed .zip file format via email. The zip file will consist of:
  1. .csv files containing the successfully migrated modules.
  2. Error logs detailing the issues encountered during migration are provided in each  .csv file that  will be shared as a reply in the migration ticket. Customers must respond within two weeks of receiving the error log. Requests made after a two-week period will not be processed.

Once the initial migration is successfully completed, customers can begin to access their Zoho Desk account.

Phase 2 

Phase 2 begins approximately two weeks after the completion of Phase 1. This is the final stage of migration. Any files, records, or data that were not included during the Initial Migration (e.g., new tickets created in the old system during the two-week period) are transferred to Zoho Desk.
Failed migration shared in the error log are also re-migrated in phase 2. Some files or records might fail to migrate due to issues like missing mandatory fields, invalid formats, or mapping errors.

Initiating Data Migration

Data migration can be initiated by providing the following information:

Entering basic information  

This includes the name of the help desk software from which the data needs to be migrated. The email address and password used to access the platform from which the data needs to be migrated. Additionally, the service URL that is the company's access URL must be included. For example, https://portalname.freshdesk.com.

Uploading data file

The export file containing the data to be migrated must be uploaded. You can migrate up to 10 GB of data, with each file size limited to 2 GB. A maximum of 5 files can be uploaded simultaneously. If your data exceeds 10 GB, please contact our support team for assistance. We’ll ensure a seamless migration experience. Additionally, ensure that each module is saved as a separate .csv file for accurate processing.

Selecting modules and sub modules where data will be migrated to  

In this step, you must select the Zoho Desk modules to which the data should be migrated:
  1. Agents
  2. Accounts
  3. Contacts
  4. Products
  5. Tickets
  6. Threads
  7. Ticket comments
  8. Attachments
  9. Knowledge Base Articles (Attachments will not be migrated)
Data migration will be carried out to the modules in the order mentioned above. In other words, agent details will be migrated first, followed by accounts, contacts, and so on. Therefore, it is important that you provide the data for the modules in this order to prevent migration delays and data loss.

Providing additional info  

Any instruction that the Zoho Desk team must follow while migrating the data can be included in this section.

Authenticating data  

The Zoho Desk portal to which the data should be migrated should be selected. This is applicable only if the primary contact is part of multiple portals.

Acknowledging migration request  

Once the above steps are completed, the primary contact is sent an email with the migration details as provided during the initiation of migration. The migration is carried out by the Zoho Desk team after analyzing the submitted data.
The estimated time for completing the migration is provided based on the existing migration queue and the amount of data to be imported. The primary contact is informed of this by the support team.

To initiate data migration
  1. Navigate to Setup > Data Administration > Zwitch > New Migration
  2. On the New Migration page, do the following:
    1. In Basic Information select a service under Migration From, enter the Service URL, Email, Password, API Key, etc.
    2. The fields displayed here will depend on the service from which you are migrating. Refer to this table for more details
    3. In the Import Data From field, upload the file that needs to be migrated.
    4. Under Modules that will receive the data field, select the Modules.
    5. Under Additional Info, enter details to be conveyed to the migration team at Zoho Desk.
  3. Click Submit and Authenticate.

    You will be redirected to the Zwitch Migration Authentication page.
  4. Select a Desk portal to which the data should be migrated.
  5. Click Submit.
  6. In the Zwitch Migration page, click Accept.
  7. Click Reject to cancel the migration.
Notes
Note: Data migration request can be cancelled any time during the Submitted status. Once it is in progress, you cannot cancel the request.
To re-initiate data migration
  1. Navigate to Setup > Data Administration > Zwitch(Data Migration)
  2. To reinitiate a data migration record, navigate to the desired record. Reinitiation is only possible for records with the status Waiting for Authentication, typically when the process was paused during the authentication step (Step 4 from To initiate data migration).
  3. Click Submit & Authenticate.

Viewing Migration History

Migration history is an audit log that stores and displays the migration details in chronological order. It displays the zipped file names along with their current status of migration. The following status will be displayed:
  1. Waiting for Authentication: If the primary contact submits the data for migration without completing the authentication, the record will be displayed here.
  2. Submitted in Queue: The migration request has been successfully submitted and is queued for processing. The system will process the request in the order it was received.
  3. Completed: The migration process has been successfully completed, and all data has been imported into the system.
  4. Canceled: The migration request has been cancelled, either by the user or due to a system action, and no further processing will occur.

    Access your files securely from anywhere

      Zoho CRM Training Programs

      Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.

      Zoho CRM Training
        Redefine the way you work
        with Zoho Workplace

          Zoho DataPrep Personalized Demo

          If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.

          Zoho CRM Training

            Create, share, and deliver

            beautiful slides from anywhere.

            Get Started Now


              Zoho Sign now offers specialized one-on-one training for both administrators and developers.

              BOOK A SESSION





                          Quick LinksWorkflow AutomationData Collection
                          Web FormsEnterpriseBegin Data Collection
                          Interactive FormsWorkplaceData Collection App
                          CRM FormsCustomer ServiceAccessible Forms
                          Digital FormsMarketingForms for Small Business
                          HTML FormsEducationForms for Enterprise
                          Contact FormsE-commerceForms for any business
                          Lead Generation FormsHealthcareForms for Startups
                          Wordpress FormsCustomer onboardingOrder Forms for Small Business
                          No Code FormsConstructionRSVP tool for holidays
                          Free FormsTravel
                          Prefill FormsNon-Profit

                          Intake FormsLegal
                          Mobile App
                          Form DesignerHR
                          Mobile Forms
                          Card FormsFoodOffline Forms
                          Assign FormsPhotography
                          Mobile Forms Features
                          Translate FormsReal EstateKiosk in Mobile Forms
                          Electronic Forms

                          Notification Emails for FormsAlternativesSecurity & Compliance
                          Holiday FormsGoogle Forms alternative GDPR
                          Form to PDFJotform alternativeHIPAA Forms
                          Email Forms
                          Encrypted Forms
                          Embeddable Forms
                          Secure Forms
                          Drag & drop form builder
                          WCAG



                                            You are currently viewing the help pages of Qntrl’s earlier version. Click here to view our latest version—Qntrl 3.0's help articles.




                                                Manage your brands on social media


                                                  • Desk Community Learning Series


                                                  • Digest


                                                  • Functions


                                                  • Meetups


                                                  • Kbase


                                                  • Resources


                                                  • Glossary


                                                  • Desk Marketplace


                                                  • MVP Corner


                                                  • Word of the Day


                                                  • Ask the Experts


                                                    Zoho Marketing Automation

                                                      Zoho Sheet Resources

                                                       

                                                          Zoho Forms Resources


                                                            Secure your business
                                                            communication with Zoho Mail


                                                            Mail on the move with
                                                            Zoho Mail mobile application

                                                              Stay on top of your schedule
                                                              at all times


                                                              Carry your calendar with you
                                                              Anytime, anywhere




                                                                    Zoho Sign Resources

                                                                      Sign, Paperless!

                                                                      Sign and send business documents on the go!

                                                                      Get Started Now




                                                                              Zoho TeamInbox Resources



                                                                                      Zoho DataPrep Resources



                                                                                        Zoho DataPrep Demo

                                                                                        Get a personalized demo or POC

                                                                                        REGISTER NOW


                                                                                          Design. Discuss. Deliver.

                                                                                          Create visually engaging stories with Zoho Show.

                                                                                          Get Started Now









                                                                                                              • Related Articles

                                                                                                              • Assisted Data Migration Guide

                                                                                                                Whether you’re moving from a cloud-based or on-premise system, you’ll need to find an efficient method of migrating your data to Zoho Desk. Our dedicated migration team can help you migrate your data safely and ensure your help desk operation is up ...
                                                                                                              • Zwitch: Frequently Asked Questions and Answers

                                                                                                                What are the modules that can be migrated to Zoho Desk? Zoho Desk shares the same database as other competing help desks. This means data from the following modules can be migrated to your Zoho Desk. Organizations or Companies End users or Contacts ...
                                                                                                              • Migrating From Freshdesk to Zoho Desk

                                                                                                                When migrating data from a FreshDesk account to Zoho Desk, it's essential to seamlessly transfer crucial information such as customer details, ticket history, agent interactions, referenced articles, comments, and attachments. Ensuring an organized ...
                                                                                                              • Migrating From Zendesk to Zoho Desk

                                                                                                                When transitioning from a Zendesk account to Zoho Desk, the challenge lies in efficiently migrating critical data like customer information, ticket histories, agent interactions, referenced articles, comments, and attachments. A structured approach ...
                                                                                                              • Importing Data in Zoho Desk

                                                                                                                This feature is released in a phased manner and will be available only to those who request for it. To request early access, click the registration link and provide your details. We will enable the feature for your Desk account. Most organizations ...
                                                                                                                Wherever you are is as good as
                                                                                                                your workplace

                                                                                                                  Resources

                                                                                                                  Videos

                                                                                                                  Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.



                                                                                                                  eBooks

                                                                                                                  Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.



                                                                                                                  Webinars

                                                                                                                  Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.



                                                                                                                  CRM Tips

                                                                                                                  Make the most of Zoho CRM with these useful tips.



                                                                                                                    Zoho Show Resources