Migrate from Freshdesk - Zoho Desk Knowledgebase

Migrating From Freshdesk to Zoho Desk

When migrating data from a Freshdesk account to Zoho Desk, it's important to seamlessly transfer crucial information such as customer details, ticket history, agent interactions, referenced articles, comments, and attachments. Ensuring an organized migration process is vital to maintain data integrity and operational continuity.

Zwitch, Zoho Desk's built-in migration tool, enables a structured transfer of customer support data from Freshdesk to Zoho Desk. The tool works with backup files exported from Freshdesk, validates them, reshapes the data to fit Zoho Desk, loads it in the correct order, and provides a detailed migration report. Throughout the migration, Zwitch stays connected to Freshdesk over the API to fetch inline images, attachments, and field values.

Availability

Permission required

The primary contact or users with Support administrator permission in their profile can initiate migration. 


Note: Users in Standard edition and above can perform migration. The Trial edition supports upto 2 GB of data for migration.

Before you start

 Account and access requirements

  1. Don't reset or revoke the API key you submitted. Resetting it in Freshdesk (Profile Settings) revokes the old key and disconnects Zwitch mid-migration.
  2. Disable any Zoho CRM or Salesforce integration during migration to avoid duplicate contacts and accounts.
  3. Remove any IP restriction settings that could block access.

Set up your agents first

  1. If an agent associated with a ticket matches an agent in the backup file and the agent is imported successfully, the ticket will be mapped to the corresponding agent. Otherwise, the ticket will be assigned to the "Unassigned" status.
  2. Each agent's Zoho Desk email must exactly match their Freshdesk email (tickets are mapped to agents by email), and they need access to the target department.
  3. If an agent is inactive or the email doesn't match, their tickets are assigned to the Primary Support Administrator.

What gets migrated

Zwitch migrates the following modules and processes them in a specific order to ensure links between records are never broken:

 

 Freshdesk

  Zoho Desk

 Notes

Companies

Accounts

Direct mapping

Users

Agents, Contacts, EndUsers

Freshdesk users are split into the three users types in Zoho Desk

Tickets

Tickets, Threads, Ticket Comments

Ticket conversations come across too

Solutions

KB Root Categories, Sections, Articles

Articles keep their inline images and attachments 


What happens during data processing?

  1. Data format: Freshdesk data is accepted in XML and JSON format.
  2. Zoho Desk migration:
    1. Zoho Desk has a migration wizard with a template for Freshdesk data.
    2. Use Zwitch to submit a Freshdesk backup for validation.
    3. The wizard extracts data module-wise and makes API calls to Freshdesk.
  3. File naming: Keep backup file names unchanged as exported from Freshdesk.
  4. Data deletion:
    1. Freshdesk backup files processed by the wizard are periodically deleted.
    2. Records are purged within 30 days of confirmation of migration.
  5. Freshdesk account maintenance:
    1. Keep Freshdesk account active until the final migration.
    2. Maintain the account with sufficient API rate limits for access during migration. The migration might take a minimum of two weeks, so ensure that the request is raised well within the subscription period. 

Notes
Note:
  1. All Freshdesk requesters/contacts arrive as EndUsers in Zoho Desk. If you don't want this, leave the EndUsers module out of the submission.
  2. Selecting Tickets automatically includes Threads, Ticket Comments, and Attachments.
  3. Deleted contacts are not included in the FreshDesk backup files. Hence tickets associated to the deleted contacts will not be migrated.
  4. Zwitch migrates everything into a single department (the default, or one you choose). Splitting data across multiple departments in one pass is not supported.
  5. A migration can be cancelled only while its status is "Submitted in Queue." Once it starts processing, it can't be cancelled.
Data migration rule
  1. Ticket identification:
    1. Tickets can be filtered with Freshdesk groups and products. Users can also skip irrelevant tickets and only migrate the selected ones into Desk.
    2. Freshdesk ticket IDs are preserved in the field 'display-id'.
  2. Custom fields in Desk:
    1. Desk custom field names may vary slightly, but types and values remain unchanged.
    2. Custom fields are created dynamically during migration, with types predicted from sampled data.
    3. Custom fields are subject to subscription-based limits and predefined regex pattern checks.
  3. Ticket notes and threads:
    1. Freshdesk ticket notes become Threads and Comments based on their privacy flag. Private notes turn into ticket comments, while public ones become threads.
  4. Channel tagging:
    1. Threads with an email address are mapped to the Email channel. If no channel or email address is available, the thread is mapped to the 'CUSTOMERPORTAL' channel.
Quick summary: a concise breakdown of who will appear as the author for each message type after migration

       Where did the message happen?
        Who usually appears as the author?
 Incoming email
    Customer (or a mail alias if the email addresses don’t match).
 Outgoing email
    Support rep (or the Admin doing the import if the agent is missing)
 Incoming portal message
    Customer
 Outgoing portal message
    Support rep (These will appear as Emails post-import).

Residual migration
Migration runs in two phases, roughly two weeks apart. This ensures that anything created in Freshdesk in the meantime and anything that needs another try or additional correction is picked up in the second phase.

Notes
Note: 
Failed records come back as a file, so user can correct them and re-migrate. Anything still unresolved is retried automatically in the second phase.
   

After migration : Finding data  

Zwitch tags migrated records so you can spot them easily:

 Record Type

 How to Identify It

Tickets

Original Freshdesk ID stored in the FreshDesk-Id field

Ticket Status

Original Freshdesk status is maintained. 

Contacts & Accounts

An Is Migrated checkbox set to true

KB Articles

Tagged ZohoDesk Migrated 

   

Custom fields 
Migrated custom fields land in the Unused Fields section of your department. Drag them onto the layout (Setup > Layouts and Fields) to surface their data.

 

Key facts at a glance  

Item

Detail

Who can start it

Primary Contact or Support Administrator

Supported editions

All paid editions; Trial Edition up to 2 GB

Upload limits

Each backup a zip under 5 GB; up to 5 files

Source format

XML or JSON

Department

Multi-department migration is supported

Error-log window

Respond within 2 weeks

Cancellation

Only while status = "Submitted in Queue"

Data retention

Customer-uploaded backup files and parsed migration data files are purged within 30 days of migration confirmation.


To initiate data export from Freshdesk
  1. Sign in to Freshdesk account.
  2. Click Admin icon (  ) on the left panel > Account > Account Details.

  3. On Account Details window, hover to Export data and click Export.

  4. Click on Any time, select a time range for created 
    1. Tickets
    2. Contacts 
    3. Companies
    4. Solutions, to be transferred. 


  5. Click Update.
  6. Click Export.

To check the export status

  1. Once Export has been initiated, a popup appears with the following message. 
    You will be directed to Account exports page.


  2. Alternatively, Click Admin icon (  ) on the left panel > Account > Account Exports.

  3. To check the details of exported files, click Details.

  4. Click Download.

 

NotesNote: Read more on how to import data from Freshdesk to Zoho Desk.






        Create. Review. Publish.

        Write, edit, collaborate on, and publish documents to different content management platforms.

        Get Started Now


          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 FormsEnterpriseOnline Data Collection Tool
                                Embeddable FormsBankingBegin 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 onboardingForms for Small Business
                                No Code FormsConstructionRSVP tool for holidays
                                Free FormsTravelFeatures for Order Forms
                                Prefill FormsNon-Profit

                                Intake FormsLegal
                                Mobile App
                                Form DesignerHR
                                Mobile Forms
                                Card FormsFoodOffline Forms
                                Assign FormsPhotographyMobile Forms Features
                                Translate FormsReal EstateKiosk in Mobile Forms
                                Electronic Forms
                                Drag & drop form builder

                                Notification Emails for FormsAlternativesSecurity & Compliance
                                Holiday FormsGoogle Forms alternative GDPR
                                Form to PDFJotform alternativeHIPAA Forms
                                Email FormsFormstack alternativeEncrypted Forms

                                Wufoo alternativeSecure Forms

                                TypeformWCAG

                                  Zoho FSM Video Tutorials


                                        All-in-one knowledge management and training platform for your employees and customers.

                                                  Create. Review. Publish.

                                                  Write, edit, collaborate on, and publish documents to different content management platforms.

                                                  Get Started Now




                                                                    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 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 Demo

                                                                                                              Get a personalized demo or POC

                                                                                                              REGISTER NOW


                                                                                                                Design. Discuss. Deliver.

                                                                                                                Create visually engaging stories with Zoho Show.

                                                                                                                Get Started Now








                                                                                                                                    • Related Articles

                                                                                                                                    • 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 ...
                                                                                                                                    • 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 Data between Zoho Desk Portals

                                                                                                                                      Organizations managing customer support across multiple Zoho Desk portals often face challenges with scattered data, inconsistent workflows, and increased administrative overhead. Each portal operates independently, making it difficult to maintain a ...
                                                                                                                                    • Zwitch Data Migration: Export from Zendesk

                                                                                                                                      When transitioning from a Zendesk account to Zoho Desk, the challenge lies in efficiently migrating critical data, such as customer information, ticket histories, agent interactions, referenced articles, and comments. A structured approach is crucial ...
                                                                                                                                    • 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 ...
                                                                                                                                      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