Helpdesk migration
Field-level mapping, validation, and rollback between OASYS and Zoho Desk. We move data and schema; workflows are rebuilt natively in Zoho Desk.
OASYS
Source
Zoho Desk
Destination
Compatibility
9 of 12
objects map 1:1 between OASYS and Zoho Desk.
Complexity
CModerate
Timeline
1-3 weeks
Overview
Moving from OASYS to Zoho Desk is a schema translation and data restructuring exercise, not a simple record export. OASYS organizes support around Tickets, Customers, Companies, and Agents with a flat team structure; Zoho Desk adds a department-centric hierarchy where custom fields are scoped per department and agent roles (Agent, Light Agent, Support Administrator) govern access. We resolve the OASYS team-to-department mapping during scoping, pre-create Zoho Desk departments with matching custom field definitions, and import in dependency order starting with Agents (required for ticket assignment), then Accounts, Contacts, Tickets, and thread history. SLA rules use internal naming conventions in OASYS that do not export as structured data; we document every SLA rule with screenshots and deliver a configuration guide for the destination admin to rebuild. We do not migrate workflows, automations, or SLAs as code, and we deliver an automation inventory for admin rebuild post-migration.
Every standard and custom field arrives verified.
AI proposes the map; you confirm before any record moves.
Parent–child, lookups, and ownership stay linked.
Calls, emails, meetings — with original timestamps.
Documents, uploads, and inline notes move with the record.
Why teams make this switch
Leaving
What's pushing teams away
Choosing
What's pulling them in
Object mapping
Each row shows how a OASYS object lands in Zoho Desk, including any object-level transformations, lookup resolution, or schema-design dependencies.
Typical mapping — final map is confirmed during the sample migration step.
OASYS
Ticket
Zoho Desk
Ticket
1:1OASYS Tickets map directly to Zoho Desk Tickets with fields transferred 1:1 including status, priority, created time, modified time, resolution details, and ticket number as an external reference. We preserve full status transition history and apply OASYS priority levels to Zoho Desk priority values (Low, Medium, High, Urgent). Department assignment in Zoho Desk requires pre-creation of departments during schema design to satisfy the required DepartmentId field.
OASYS
Customer
Zoho Desk
Contact
1:1OASYS Customer records map to Zoho Desk Contacts with contact information, email, phone, and lifecycle data transferred directly. We use email as the primary deduplication key. Customer-to-Contact mapping preserves the association to the OASYS Company record, which maps to a Zoho Desk Account. Contact records are imported after Accounts to satisfy the AccountId lookup on Contact.
OASYS
Company
Zoho Desk
Account
1:1OASYS Company records map to Zoho Desk Accounts. We transfer company name, domain, phone, industry, and description fields. The Account record is created before Contact import so that the Contact-Account relationship is established at the moment of Contact insert. Website field carries the original company domain for reference.
OASYS
Agent
Zoho Desk
Agent
1:1OASYS Agent records map to Zoho Desk Agents resolved by email address match. Zoho Desk requires agents to have an existing Zoho account before ticket assignment. We audit all OASYS agents during scoping, flag any without a matching Zoho Desk user, and hold those records in a reconciliation queue until the customer's admin provisions the Zoho accounts. Inactive agents from OASYS are recreated as inactive Zoho Desk agents to preserve historical ticket ownership.
OASYS
Team
Zoho Desk
Department + Team
lossyOASYS team structures and queue assignments vary by configuration and do not export as structured data. We audit team rosters, queue rules, and member lists during discovery and document the equivalent Zoho Desk Department and Team structure. Departments must be created in Zoho Desk before agents and tickets are imported, because Zoho Desk scopes custom fields and layouts per department. We deliver a written department and team rebuild guide with the migration package.
OASYS
Conversations
Zoho Desk
Threads + Comments
1:manyOASYS conversation threads attach to Tickets as a flat chronology of customer replies and agent responses. Zoho Desk splits these into Threads (the channel-level conversation container) and Comments (individual entries with author, direction, and timestamp). We split OASYS conversation entries by author type (customer vs. agent) and direction (Incoming vs. Outgoing) during the transform phase, preserving the full thread chronology and original timestamps on each Comment record.
OASYS
Custom Fields
Zoho Desk
Custom Fields
1:1OASYS custom fields extend Tickets and Customers with business-specific data. We audit all custom field definitions during discovery, map supported field types to their Zoho Desk equivalents (string, decimal, integer, currency, checkbox), and flag any OASYS-specific field types that cannot be transferred automatically. Custom fields in Zoho Desk are scoped per department, so we recreate field definitions in each destination department that requires them before ticket import begins. Unsupported field types are stored as plain-text custom properties in Zoho Desk for manual resolution.
OASYS
Attachments
Zoho Desk
Attachments
1:1File attachments on tickets and conversations are downloaded from OASYS and re-uploaded to Zoho Desk. We validate attachment file types and sizes against Zoho Desk upload limits (10 GB total per migration request per Zoho Desk documentation). Oversized files or unsupported file types are flagged during the audit phase so the customer can decide whether to compress, re-upload manually post-migration, or exclude them from the transfer. KB article attachments cannot be migrated via the assisted migration path and require separate manual re-upload.
OASYS
Tags
Zoho Desk
Tags
1:1OASYS Tags that categorize Tickets and Customers transfer to Zoho Desk Tags with their associations preserved. Zoho Desk tag taxonomies are flat within each module, so destination tagging taxonomies may require post-migration reorganization if OASYS used a hierarchical tag structure. We map all tag values directly and deliver a tag reorganization guide if the customer had more than 50 distinct tag values.
OASYS
SLA Rules
Zoho Desk
SLA Policies
lossyOASYS SLA definitions use internal naming conventions and condition logic that do not export as structured data. We capture screenshots and documentation of every SLA rule during the audit phase. Post-migration, we deliver a Zoho Desk SLA Policy configuration guide that maps each OASYS SLA to its Zoho Desk equivalent (SLA Name, Applicable Hours, First Response Target, Next Response Target, Resolution Target), so the customer's admin can rebuild SLA policies using Zoho Desk's native SLA configuration UI. SLA policy assignment to departments and ticket types is documented separately.
OASYS
Products
Zoho Desk
Products
1:1OASYS Product records map to Zoho Desk Products if the support operation tracks product information against tickets. We transfer product name, SKU, description, and unit price where these fields exist in the source. Products are imported before tickets that reference them so that the product lookup is satisfied at the time of ticket insert.
OASYS
Tasks
Zoho Desk
Tasks
1:1OASYS task records linked to tickets map to Zoho Desk Tasks attached to the corresponding Ticket. We preserve task subject, due date, status, and assignment (resolved by agent email to Zoho Desk Agent lookup). Task chronology relative to ticket conversation threads is preserved using the original OASYS created timestamp.
| OASYS | Zoho Desk | Compatibility | |
|---|---|---|---|
| Ticket | Ticket1:1 | Fully supported | |
| Customer | Contact1:1 | Fully supported | |
| Company | Account1:1 | Fully supported | |
| Agent | Agent1:1 | Fully supported | |
| Team | Department + Teamlossy | Fully supported | |
| Conversations | Threads + Comments1:many | Fully supported | |
| Custom Fields | Custom Fields1:1 | Mapping required | |
| Attachments | Attachments1:1 | Mapping required | |
| Tags | Tags1:1 | Mapping required | |
| SLA Rules | SLA Policieslossy | Mapping required | |
| Products | Products1:1 | Mapping required | |
| Tasks | Tasks1:1 | Mapping required |
Gotchas + challenges
Platform-specific issues from each side, plus the pair-specific challenges that don't show up on either platform's page on its own.
OASYS gotchas
Custom field limitations require destination-side recreation
Attachment file size restrictions may cause partial migration
SLA rule mapping requires manual configuration post-migration
Zoho Desk gotchas
Agent email identity determines comment ownership after migration
Blueprints and SLA policies do not export via API
File upload capped at 10GB per migration batch
Tier-gated export and migration capabilities
Inbound migration is two-phase with a hard Phase 2 cutoff
Pair-specific challenges
Migration approach
Discovery and data audit
We audit the OASYS instance across all objects: Tickets, Customers, Companies, Agents, Teams, Custom Fields, Conversation histories, Attachments, Tags, SLA Rules, and Products. We record distinct record counts, custom field definitions and their data types, team roster structure and queue assignment rules, attachment file types and total volume, and SLA rule screenshots with condition logic. We also identify any OASYS-specific field types that may require destination-side recreation. The discovery output is a written migration scope document with record counts per object, a custom field audit table, and a team-to-department mapping recommendation.
Zoho Desk schema design and pre-creation
We design the Zoho Desk destination schema before any data moves. This includes creating Departments that map to OASYS teams, configuring Agent roles (Agent, Light Agent, or Support Administrator based on OASYS role scope), recreating Custom Fields per department, setting up Teams within each Department, configuring tag taxonomies, and creating placeholder SLA Policies using the naming conventions documented in discovery. We run this in a Zoho Desk trial or sandbox instance first for validation. The customer's Zoho Desk admin creates all agent Zoho accounts during this phase so that agent email matching can resolve during import.
Sample migration and reconciliation
We run a sample migration with a representative subset of data (typically 100-500 tickets plus associated contacts and accounts) into the destination Zoho Desk instance. The customer's support operations lead reconciles record counts, spot-checks 25-50 records against the OASYS source for field accuracy and thread chronology, and verifies that custom field values are appearing correctly in the department-scoped layouts. Any mapping corrections, field type mismatches, or department assignment errors are resolved in this phase before full production migration begins.
Agent reconciliation and provisioning
We extract every distinct OASYS agent referenced on Tickets, Customers, and Companies, and match by email against the Zoho Desk User table. Agents without a matching Zoho Desk user are added to a reconciliation queue. The customer's admin provisions any missing Zoho accounts (active for current agents, inactive for departed agents to preserve historical assignment). Migration cannot proceed to ticket import until all agent references are resolved, because OwnerId is a required field on Zoho Desk Tickets.
Production migration in dependency order
We run production migration in strict dependency order: Agents (validated), Departments and Teams (pre-created and verified), Accounts (from OASYS Companies), Contacts (with AccountId resolved from the Accounts phase), Products (if applicable), Tickets (with DepartmentId, AgentId, and AccountId resolved), Conversations split into Threads and Comments with correct author direction, Attachments (chunked to stay within the 10 GB Zwitch limit, or via API for larger volumes), Tags (applied to ticket records post-insert), and Custom Fields (values mapped to the pre-created field definitions). Each phase emits a row-count reconciliation report before the next phase begins.
Cutover, validation, and SLA rebuild handoff
We freeze OASYS write access during cutover, run a final delta migration of any records created or modified during the migration window, then enable Zoho Desk as the system of record. We deliver the SLA Policy configuration guide and the automation inventory document to the customer's admin team. We support a one-week hypercare window where we resolve any data reconciliation issues reported by the support team. We do not rebuild OASYS automations, workflows, or SLAs as code inside the migration scope; those are separate engagements or internal admin rebuilds using the guides we deliver.
Platform deep dives
OASYS
Source
Strengths
Weaknesses
Zoho Desk
Destination
Strengths
Weaknesses
Complexity grading
Moderate Helpdesk migration. 4 of 7 objects need a mapping; the rest are 1:1.
Overall complexity
Moderate migration
Derived from compatibility, mapping clarity, API constraints, and data volume across OASYS and Zoho Desk.
Object compatibility
4 of 7 objects need a mapping; the rest are 1:1.
Field mapping clarity
Field mapping is derived from defaults — final spec confirmed during the sample migration.
Timeline complexity
7-object category — typical timelines run 2–7 days end-to-end.
API constraints
OASYS: Not publicly documented..
Data volume sensitivity
OASYS doesn't expose a bulk API — REST + parallelization used for high-volume runs.
Estimator
Rule-based pricing — no per-record fees, no manual quotes. Migrations over 2M records are scoped individually.
Step 1
Pick a category, then your source and destination platforms.
Category
FAQ
Answers to the questions buyers ask most during OASYS to Zoho Desk migration scoping. Not seeing yours? Book a call.
Walk through your OASYS to Zoho Desk migration with a real engineer — 30 minutes, free, written quote within 24 hours.
Book a free 30 minute consultationAdjacent paths
Other ways to leave OASYS
Other ways to arrive at Zoho Desk
Same-Helpdesk migrations
Ready when you are
Tell us record counts and timeline. We'll come back with a written quote inside 1 business day — no commitment, no sales pitch.