Helpdesk migration
Field-level mapping, validation, and rollback between HelpDesk 3 and Zendesk. We move data and schema; workflows are rebuilt natively in Zendesk.
HelpDesk 3
Source
Zendesk
Destination
Compatibility
8 of 10
objects map 1:1 between HelpDesk 3 and Zendesk.
Complexity
CModerate
Timeline
3-5 weeks
Overview
Moving from HelpDesk 3 to Zendesk is an export-then-import migration constrained primarily by HelpDesk 3's absence of a documented public API. We work around this by requesting CSV exports per object through the admin panel, validating field completeness, and remapping custom field definitions to Zendesk equivalents. HelpDesk 3 stores in-app chat transcripts and email threads as separate conversation objects under a single ticket; we merge these into a single chronological conversation record in Zendesk, tagging each message with its original channel so context is preserved. FAQ articles migrate as structured HTML with category remapping. We do not migrate HelpDesk 3's client portal configurations or billing module records as code; we document these for manual rebuild and flag billing data for the customer's admin to determine whether Zendesk Sunshine Objects or a separate billing tool will hold invoice and payment history 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 HelpDesk 3 object lands in Zendesk, including any object-level transformations, lookup resolution, or schema-design dependencies.
Typical mapping — final map is confirmed during the sample migration step.
HelpDesk 3
Tickets
Zendesk
Ticket
1:1HelpDesk 3 Tickets map directly to Zendesk Tickets with status, priority, assignee, linked customer, and conversation thread preserved. We resolve the assignee by matching HelpDesk 3 agent email to Zendesk User email. HelpDesk 3's status values (open, pending, resolved, closed) map to Zendesk Ticket Status; any custom statuses without direct Zendesk equivalents are flagged in the audit. SLA timestamps migrate to Zendesk SLA Policy fields if the destination Suite plan supports SLA tracking. Multi-email linking to a single ticket is preserved as additional Requester emails on the Zendesk Ticket.
HelpDesk 3
Customers
Zendesk
User (End User)
1:1HelpDesk 3 Customer records map to Zendesk End Users. Contact details, company association, and email address transfer directly. Email address serves as the dedupe key; duplicate matches by email are merged during import. Customers with linked company data in HelpDesk 3 map to Zendesk Organizations if the company association is present, or remain as standalone Users if no company link exists. Billing profile fields migrate to a custom field section or to a separate customer notes field depending on the customer's post-migration billing strategy.
HelpDesk 3
Agents
Zendesk
Agent
1:1HelpDesk 3 Agent accounts (name, email, role, availability) map to Zendesk Agent accounts. We resolve agents by email match. Role assignments (Admin, Agent, Viewer) map to Zendesk Roles where Admin maps to light agent with admin rights, Agent maps to standard agent, and Viewer maps to an end-user role with view-only access. Availability settings in HelpDesk 3 do not have a direct Zendesk equivalent; we flag these for manual configuration in Zendesk admin settings post-migration.
HelpDesk 3
FAQ Articles
Zendesk
Article (Zendesk Guide)
1:1HelpDesk 3 FAQ Articles export as structured HTML with title, body content, category, and visibility settings. We remap article categories to Zendesk Guide Sections and map visibility settings to Zendesk Article permissions (public, authenticated, or draft). HTML body content migrates directly; any embedded images are exported to cloud storage and their URLs updated in the article body to point to Zendesk's attachment hosting. Article publish date and author information migrate as metadata fields.
HelpDesk 3
Conversations
Zendesk
Ticket Comments
1:manyHelpDesk 3 stores in-app chat transcripts and email threads as separate conversation objects under a single ticket. We merge these into a single chronological conversation record in Zendesk by timestamp-ordering all messages and tagging each with its original channel (email or chat) in the Zendesk Comment author_type and public/private fields. Chat messages from HelpDesk 3 are imported as private comments in Zendesk unless the customer specifies they should be public. This merge step is critical to avoid duplicate or out-of-order message artifacts in the ticket timeline.
HelpDesk 3
Attachments
Zendesk
Attachments (Ticket and Article)
1:1File attachments linked to HelpDesk 3 tickets and FAQ articles export to cloud storage, and their references relink to Zendesk's attachment hosting during import. Attachments stored as linked URLs (not uploaded files) are flagged separately and require a decision on whether to migrate as URL fields in Zendesk or leave them as-is with the original links preserved in ticket comments. Orphaned attachments with no parent ticket reference are logged and excluded unless the customer explicitly requests inclusion.
HelpDesk 3
Tags
Zendesk
Tags
1:1HelpDesk 3 tags on tickets and articles preserve as Zendesk tags. Tag namespaces are normalized at migration time so that a tag named priority-high in HelpDesk 3 does not conflict with a differently-named tag in Zendesk. We map tag names directly without namespace prefixing unless the customer requests a specific naming convention. Tags used for categorization across both tickets and articles migrate with their source object context preserved.
HelpDesk 3
Custom Fields
Zendesk
Custom Ticket Fields and User Fields
1:1HelpDesk 3 per-ticket and per-customer custom field definitions and values are extracted during the audit phase. Custom field types (text, number, dropdown, checkbox, date) map to Zendesk field types (text, integer, dropdown, checkbox, date). Dropdown and multi-select custom fields in HelpDesk 3 require pre-creation of the field in Zendesk with matching option values before import; we handle this by exporting the option lists and uploading them as Zendesk field values via CSV before record migration begins. Custom field values migrate as typed field values, not as tags, to preserve reporting integrity in Zendesk.
HelpDesk 3
Pipeline / Status Workflows
Zendesk
Ticket Status and Fields
lossyHelpDesk 3 ticket status workflows (open, pending, resolved, closed, and any custom statuses) map to Zendesk Ticket Status values. We configure Zendesk ticket fields to represent HelpDesk 3's priority levels (low, medium, high, urgent) as a separate priority field or as custom field values, depending on the customer's reporting needs. Custom status values that lack a direct Zendesk equivalent are flagged in the audit and mapped to the nearest Zendesk Status value, with a note in the migration report.
HelpDesk 3
Client Portal Settings
Zendesk
N/A - not migrated
1:1HelpDesk 3 portal visibility rules and submission form configurations are tied to HelpDesk 3's CMS and are not structurally portable to Zendesk Guide or Support. We document the portal configuration during the audit, including visibility settings, submission form field layouts, and any custom branding or theming, and deliver a written configuration guide for the customer's admin to rebuild in Zendesk's Help Center and ticket form settings.
| HelpDesk 3 | Zendesk | Compatibility | |
|---|---|---|---|
| Tickets | Ticket1:1 | Fully supported | |
| Customers | User (End User)1:1 | Fully supported | |
| Agents | Agent1:1 | Fully supported | |
| FAQ Articles | Article (Zendesk Guide)1:1 | Mapping required | |
| Conversations | Ticket Comments1:many | Mapping required | |
| Attachments | Attachments (Ticket and Article)1:1 | Mapping required | |
| Tags | Tags1:1 | Mapping required | |
| Custom Fields | Custom Ticket Fields and User Fields1:1 | Mapping required | |
| Pipeline / Status Workflows | Ticket Status and Fieldslossy | Mapping required | |
| Client Portal Settings | N/A - not migrated1:1 | Not supported |
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.
HelpDesk 3 gotchas
No documented public API for automated migration
Server connection instability during peak usage
Live chat and email conversations stored as separate objects
Zendesk gotchas
Data export requires API scripting on non-Enterprise plans
Automations cap at 500 active rules and 1,000 tickets per hour
Help Center has no native export feature
Custom Objects and full data export are Enterprise-only
Pair-specific challenges
Migration approach
Discovery and export coordination
We audit HelpDesk 3 across all objects (Tickets, Customers, Agents, FAQ Articles, Conversations, Attachments, Tags, Custom Fields, and Pipeline/Status Workflows) by requesting admin panel exports. Because HelpDesk 3 lacks a documented API, we coordinate with the customer's HelpDesk 3 admin to generate CSV exports per object type. We validate field completeness in each export, identify any truncated or malformed records, and flag custom field definitions that require separate extraction. If the admin panel does not support full exports, we request database-level access or partial exports split by date range. The discovery output is a written migration scope, a field mapping document, and a list of any export gaps requiring remediation before migration begins.
Zendesk environment preparation
We configure the Zendesk destination environment before any data import. This includes pre-creating custom ticket fields and user fields with matching types (text, integer, dropdown, checkbox, date), uploading dropdown and multi-select option values via Admin Center CSV import, and setting up Zendesk Guide sections mapped to HelpDesk 3 article categories. We configure ticket status values and priority fields to match HelpDesk 3's taxonomy, and set up Organizations if HelpDesk 3 customer records include company associations. All configuration happens in a Zendesk sandbox or the production account depending on the customer's preference, and the customer's Zendesk admin reviews and approves the configuration before we proceed to data migration.
Conversation thread merge and custom field mapping
We process HelpDesk 3 conversation data separately from ticket records to handle the chat-and-email merge logic. Each HelpDesk 3 ticket's conversation objects are extracted, timestamp-ordered across both chat and email channels, and merged into a flat comment sequence for Zendesk import. Each message is tagged with its original channel (email or chat) in the import payload. Simultaneously, we extract HelpDesk 3 custom field definitions and values, map field types to Zendesk equivalents, and apply the custom field values against the pre-created Zendesk fields during the ticket import phase. This split processing ensures that conversation integrity and custom field completeness are both maintained before tickets are loaded.
User and agent provisioning reconciliation
We extract every distinct agent email from HelpDesk 3 tickets and match against the Zendesk User table. Agents without a matching Zendesk account enter a reconciliation queue, and the customer's Zendesk admin provisions the missing accounts before ticket migration proceeds. Customer records from HelpDesk 3 (end users and any organizations) are loaded into Zendesk as Users and Organizations, using email as the dedupe key. Any HelpDesk 3 customers with duplicate email addresses are flagged for the customer's admin to resolve before the final import batch.
Production migration in dependency order
We run production migration in record-dependency order: Agents (provisioned, validated), Users and Organizations (customer records), Ticket custom fields (field definitions deployed), Tickets (with conversation comments merged and attached, assignee resolved to Zendesk User, custom field values applied), Tags (applied post-insert to tickets), FAQ Articles (to Zendesk Guide with section remapping), and Attachments (exported to cloud storage and relinked to Zendesk ticket and article records). Each phase emits a row-count reconciliation report before the next phase begins. We implement retry logic with exponential backoff on any API failures, and checkpoint exports so that a partial failure does not require restarting from scratch.
Cutover, validation, and FAQ rebuild handoff
We freeze HelpDesk 3 writes during cutover, run a final delta migration of any records created or modified during the migration window, then enable Zendesk as the system of record. We validate ticket conversation ordering against a sample of original HelpDesk 3 tickets (random 25-50 record audit), verify custom field values are populated correctly, and confirm article visibility settings in Zendesk Guide. We deliver the Client Portal Configuration documentation to the customer's admin for manual rebuild in Zendesk Help Center settings. We support a one-week hypercare window where we resolve any reconciliation issues. We do not rebuild HelpDesk 3 automations or workflows in Zendesk as part of the migration scope; that is documented separately for the customer's admin to configure in Zendesk's business rules, triggers, and macros.
Platform deep dives
HelpDesk 3
Source
Strengths
Weaknesses
Zendesk
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 HelpDesk 3 and Zendesk.
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
HelpDesk 3: Self-hosted — no vendor-imposed limits; constrained by hosting capacity.
Data volume sensitivity
HelpDesk 3 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 HelpDesk 3 to Zendesk migration scoping. Not seeing yours? Book a call.
Walk through your HelpDesk 3 to Zendesk migration with a real engineer — 30 minutes, free, written quote within 24 hours.
Book a free 30 minute consultationAdjacent paths
Other ways to leave HelpDesk 3
Other ways to arrive at Zendesk
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.