Helpdesk migration
Field-level mapping, validation, and rollback between Help On Task and Gorgias. We move data and schema; workflows are rebuilt natively in Gorgias.
Help On Task
Source
Gorgias
Destination
Compatibility
10 of 12
objects map 1:1 between Help On Task and Gorgias.
Complexity
CModerate
Timeline
1-2 weeks
Overview
Moving from Help On Task to Gorgias is a multi-phase extraction, transformation, and reload migration driven by Help On Task's lack of a documented public REST API. We extract customer, agent, ticket, and conversation data from CSV exports, recreate the custom field schema in Gorgias using the four supported field types (Text, Number, Dropdown, Yes/No), and re-upload all attachments to Gorgias's storage before the source account closes so that URLs do not go stale. Ticket fields migrate with the constraint that Gorgias permits a maximum of 25 active Ticket Fields at a time; any above that threshold require archiving. Macros transfer as text actions and templates. Gorgias's per-ticket pricing model (versus Help On Task's per-agent model) means teams with high ticket volumes per agent may see cost increases, while teams with low volume per agent may see decreases. Workflows, automation rules, and rules-based routing do not migrate; we deliver a written inventory of these for the customer's admin to rebuild in Gorgias Rules or Gorgias Automate.
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 Help On Task object lands in Gorgias, including any object-level transformations, lookup resolution, or schema-design dependencies.
Typical mapping — final map is confirmed during the sample migration step.
Help On Task
Ticket
Gorgias
Ticket
1:1Help On Task tickets map to Gorgias tickets with the standard ticket fields preserved: ticket ID, subject, status, priority, requester email, assignee, created timestamp, updated timestamp, and closed timestamp. The source status and priority values are mapped to Gorgias's ticket status and priority taxonomies. Tickets with no assignee are imported as unassigned and flagged for manual routing in Gorgias.
Help On Task
Customer
Gorgias
Customer
1:1Help On Task customer profiles (name, email, phone, address) map to Gorgias customer records using email as the unique dedupe key. We extract customer email as the primary identifier and create Gorgias Customer records before any ticket import so that the customer reference on each ticket is satisfied at insert time. Any customer records with duplicate emails are merged at import.
Help On Task
Agent
Gorgias
Agent
1:1Help On Task agent accounts map to Gorgias agent profiles by email match. We extract agent name, email, and active/inactive status from the source and create matching Gorgias user accounts before ticket import so that the assignee reference on each ticket resolves correctly. Agents without email addresses in Help On Task are flagged for manual resolution before migration begins.
Help On Task
Tag
Gorgias
Tag
1:1Ticket tags from Help On Task map as label strings to Gorgias ticket tags. We preserve the full tag name and reconstruct tag associations per ticket in the destination. Tag naming conventions in Help On Task (commas, spaces, case) are kept as-is; Gorgias normalizes display but the underlying string value is preserved. Any tag that exceeds Gorgias's tag length limit is truncated and flagged.
Help On Task
Custom Field (ticket-level)
Gorgias
Ticket Field
lossyHelp On Task ticket custom fields require schema reconstruction in Gorgias before data import. We extract field values from the CSV export and request the customer provide a manual list of custom field definitions (field name, type, required flag, options for dropdowns) since Help On Task does not export field schema. We then create corresponding Gorgias Ticket Fields using the supported types: Text (for string fields), Number (for numeric fields), Dropdown (for single-select), and Yes/No (for boolean). Gorgias permits a maximum of 25 active Ticket Fields; any above this threshold require archiving lesser-used fields before migration.
Help On Task
Conversation / Thread
Gorgias
Message
1:1Help On Task conversation threads within a ticket are exported as a chronological list of message entries with author, body, timestamp, and privacy flag. We reconstruct the conversation in Gorgias by inserting messages in timestamp order against the correct ticket, preserving internal/private notes as private messages in Gorgias and customer-visible replies as public messages. Author attribution resolves to the matched Gorgias agent or customer record.
Help On Task
Attachment
Gorgias
Attachment
1:1Help On Task attachments stored as URLs must be downloaded to a temporary blob store before the source account closes, then re-uploaded to Gorgias storage and relinked to the correct ticket record. This is a critical step: if the source account is deactivated before all attachment URLs are fetched, the URLs expire and files become unrecoverable. We sequence this as the first step of the migration runbook so that attachment download completes before any account decommissioning.
Help On Task
Macro (template reply)
Gorgias
Macro
1:1If Help On Task stores templated replies or canned responses as structured records, these migrate to Gorgias Macros. Static text macros transfer fully. Macros that reference Help On Task-specific dynamic variables (such as ticket ID placeholders or customer property tokens) are imported as static text with a flag indicating which dynamic elements require rebuilding in Gorgias macro syntax post-migration.
Help On Task
Knowledge Base Article
Gorgias
Help Center Article
1:1Help On Task knowledge base articles (if present in the source) are exported with title, body content, category, and publication status. We map these to Gorgias Help Center structure with articles assigned to categories and publication status preserved. Any draft or unpublished articles are flagged so the customer admin reviews and publishes them post-migration rather than migrating in an unpublished state that may not display correctly.
Help On Task
Tag (customer-level)
Gorgias
Customer Tag
1:1Customer-level tags in Help On Task (labels applied to the customer profile rather than a specific ticket) migrate to Gorgias customer tags. These operate independently from ticket tags and are associated at the customer level for segmentation and routing purposes in Gorgias.
Help On Task
Group / Team
Gorgias
Group
1:1If Help On Task organizes agents into teams or groups for ticket routing, these migrate to Gorgias Groups. Group membership is resolved by matching agent email addresses to the migrated agent records. Group-level routing rules in Gorgias are created as part of the post-migration configuration phase.
Help On Task
Custom Field (customer-level)
Gorgias
Customer Custom Field
lossyHelp On Task customer-level custom fields (fields attached to the customer profile rather than individual tickets) require schema creation in Gorgias before customer import. We extract values from the source CSV, request the field schema definition from the customer, and create matching Customer custom fields in Gorgias using the four supported types. The same 25-field active limit applies to the combined count of Ticket Fields and Customer Custom Fields.
| Help On Task | Gorgias | Compatibility | |
|---|---|---|---|
| Ticket | Ticket1:1 | Fully supported | |
| Customer | Customer1:1 | Fully supported | |
| Agent | Agent1:1 | Fully supported | |
| Tag | Tag1:1 | Fully supported | |
| Custom Field (ticket-level) | Ticket Fieldlossy | Fully supported | |
| Conversation / Thread | Message1:1 | Fully supported | |
| Attachment | Attachment1:1 | Fully supported | |
| Macro (template reply) | Macro1:1 | Fully supported | |
| Knowledge Base Article | Help Center Article1:1 | Fully supported | |
| Tag (customer-level) | Customer Tag1:1 | Fully supported | |
| Group / Team | Group1:1 | Fully supported | |
| Custom Field (customer-level) | Customer Custom Fieldlossy | Fully 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.
Help On Task gotchas
No documented public API for automated exports
Custom field schema not exposed in exports
Attachment URLs become stale after account closure
Gorgias gotchas
AI Agent adds outcome-based fees on top of billable ticket costs
Overage billing for tickets scales nonlinearly
API rate limits restrict bulk export throughput
Agent data visibility cannot be restricted by role for GDPR use cases
Knowledge Base translations require separate API calls per locale
Pair-specific challenges
Migration approach
Discovery and export extraction
We audit the Help On Task account to confirm available export methods (CSV from admin panel, manual structured exports, or screenshots), ticket volume, custom field count, attachment count, and whether a knowledge base exists. We request a sample CSV export to validate data completeness. If CSV exports are unavailable in the customer's plan tier, we flag this as a blocker and request manual extraction before migration begins. We also request a written list or screenshots of all custom field definitions (name, type, required flag, options) since this schema is not included in Help On Task exports.
Attachment download and temporary storage
Before any other migration activity, we download all attachments referenced in the Help On Task export to a temporary blob store (S3-compatible storage). This step is sequenced first because attachment URLs expire when the source account closes. We log each downloaded file with its source URL, original filename, MIME type, and associated ticket ID. The source account must remain active through the completion of this step. We do not proceed to account closure until this phase is confirmed complete.
Schema creation in Gorgias
We create the destination schema in Gorgias before any data import. This includes provisioning Ticket Fields with correct types (Text, Number, Dropdown, Yes/No) and visibility settings (Always optional, Always required, or Conditionally visible) matching the customer's Help On Task definitions. We create Customer custom fields with equivalent types. If the combined field count exceeds 25 active fields, we prioritize by usage frequency and archive the remainder for post-migration review. We create Groups (if agent teams exist in Help On Task) and verify that at least one Gorgias user account exists for each agent email in the export.
Sandbox migration and reconciliation
We run a test migration into a Gorgias trial or sandbox environment using a representative subset of data (typically 50-100 tickets) to validate field mappings, conversation thread reconstruction, tag transfer, and attachment relinking. The customer reviews the sample records in Gorgias and confirms mapping accuracy before we proceed to production migration. Any field type corrections, custom field priority changes, or tag rename requests happen at this stage. We do not begin production migration until the sandbox sign-off is received.
Production migration in dependency order
We run production migration in record-dependency order: Gorgias Agents (from Help On Task agent export), Gorgias Customers (using email as dedupe key, resolving to agents before tickets), Ticket Fields (before ticket import so field references are valid), Tickets (with assignee and customer references resolved), Messages (in timestamp order per ticket), Tags (applied to tickets after ticket insert), Customer tags (applied at customer level), Macros (if present in source), and Knowledge Base articles (with category mapping and publication status). Attachments are uploaded from the blob store and relinked to ticket records during this phase. Each phase emits a row-count reconciliation report before the next phase begins.
Cutover, validation, and automation handoff
We freeze writes to Help On Task during cutover, run a final delta migration of any records modified during the migration window, then set Gorgias as the system of record. We deliver a written inventory of Help On Task automation equivalents: Gorgias Rules for routing and auto-assignment, Gorgias Macros for templated replies, and Gorgias Automate (paid add-on) for multi-step workflows. We do not rebuild automations as code inside the migration scope. We support a five-business-day hypercare window for reconciliation issues. Gorgias subscription setup and agent onboarding to the new platform remain the customer's responsibility.
Platform deep dives
Help On Task
Source
Strengths
Weaknesses
Gorgias
Destination
Strengths
Weaknesses
Complexity grading
Moderate Helpdesk migration. 6 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 Help On Task and Gorgias.
Object compatibility
6 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
Help On Task: Not publicly documented.
Data volume sensitivity
Help On Task 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 Help On Task to Gorgias migration scoping. Not seeing yours? Book a call.
Walk through your Help On Task to Gorgias migration with a real engineer — 30 minutes, free, written quote within 24 hours.
Book a free 30 minute consultationAdjacent paths
Other ways to leave Help On Task
Other ways to arrive at Gorgias
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.