Helpdesk migration
Field-level mapping, validation, and rollback between Teamwork Desk and Gorgias. We move data and schema; workflows are rebuilt natively in Gorgias.
Teamwork Desk
Source
Gorgias
Destination
Compatibility
12 of 14
objects map 1:1 between Teamwork Desk and Gorgias.
Complexity
CModerate
Timeline
1-2 weeks
Overview
Teamwork Desk and Gorgias serve different primary use cases: Teamwork Desk is a general-purpose per-agent help desk built for agencies and product teams already using the Teamwork.com ecosystem, while Gorgias is an ecommerce-native support platform with tight Shopify and order-management integrations. Moving from Teamwork Desk to Gorgias typically means adopting a per-ticket pricing model (versus Teamwork's per-agent model), gaining native ecommerce automations, and accepting a simpler reporting and knowledge base structure. We migrate the full ticket history, customer records, agent assignments, inbox routing, Helpdocs articles, and tags. We do not migrate Triggers, Business Hours configurations, Time Tracking entries (Pro+), or CSAT ratings as native objects; these are documented for manual recreation. The migration runs through Gorgias's REST API with batch chunking and rate-limit handling, and it excludes spam-marked tickets per Teamwork Desk's own export behavior.
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 Teamwork Desk 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.
Teamwork Desk
Customer
Gorgias
Customer
1:1Teamwork Desk Customers map to Gorgias Customers by email address, which is the dedupe key. Name, email, company, and metadata transfer directly. Spam-marked customers are excluded from Teamwork's native export, which is replicated in our migration to avoid creating phantom customer records. We flag any orphaned tickets whose customer was spam-excluded and present them for admin review before finalizing the import.
Teamwork Desk
Ticket
Gorgias
Ticket
1:1Teamwork Desk Tickets map to Gorgias Tickets with full conversation history preserved including internal notes and public replies. Status (open, pending, resolved, closed), priority (low, medium, high, urgent), and assignee transfer as typed fields. The original Teamwork ticket ID is preserved in a custom property for audit and cross-reference.
Teamwork Desk
Agent
Gorgias
Agent
1:1Teamwork Desk Agents map to Gorgias Agents by email address. We validate that the migrating agent email exists in the Gorgias destination before assignment; unprovisioned agents go to a reconciliation queue for the customer's admin to resolve before record import resumes. Active and inactive status carries over, though Gorgias licenses agents by seat regardless of active/inactive status.
Teamwork Desk
Inbox
Gorgias
Channel
1:1Teamwork Desk Inboxes (email addresses, forwarding rules, and channel sources) map to Gorgias Channels. Each inbox-to-agent assignment is preserved as a routing rule in Gorgias. If Teamwork Desk has more than 15 active inboxes, we consolidate routing rules by channel type (email, forwarding) during mapping to avoid exceeding Gorgias channel limits on Starter and Basic plans.
Teamwork Desk
Helpdocs (Knowledge Base)
Gorgias
Knowledge Base
1:1Teamwork Helpdocs articles map to Gorgias Knowledge Base articles with content, publication status, and category associations preserved. The hierarchical category structure in Teamwork Desk maps to Gorgias's flat category hierarchy; we flatten multi-level categories into top-level categories and preserve the full path as tags for navigation. Article attachments migrate as Gorgias-attached files subject to the 25MB per-file limit.
Teamwork Desk
Category
Gorgias
Category (flattened)
lossyTeamwork Desk Helpdocs Categories are hierarchical (up to 5 levels in Premium). Gorgias uses a flat category structure. We preserve the full category path as a category name string and add the intermediate levels as tags on the article so that navigation structure is recoverable. The customer chooses whether to recreate the full hierarchy in Gorgias or accept the flattened model during scoping.
Teamwork Desk
Tag
Gorgias
Tag
1:1Tags from Teamwork Desk transfer as-is to Gorgias Tags. Both platforms support tagging on tickets and customers. Tag vocabulary is preserved in full, and Gorgias's native tag autocomplete handles new tag creation at agent-time if needed.
Teamwork Desk
Custom Fields (Premium/Enterprise)
Gorgias
Ticket Properties / Customer Attributes
lossyTeamwork Desk custom fields exist only on Premium and Enterprise tiers. We enumerate every custom field during scoping (text, multi-line, dropdown, checkbox, number, date) and map each to the nearest Gorgias equivalent. Dropdown fields map to Gorgias drop-down ticket properties; checkbox fields map to multi-select. Text and date fields map directly. Required field enforcement in Gorgias is configurable post-migration and may differ from Teamwork's required-at-submit behavior.
Teamwork Desk
Customer Happiness Rating (CSAT)
Gorgias
Custom Ticket Property
1:1CSAT ratings attached to tickets in Teamwork Desk Premium and Enterprise migrate as a custom numeric property on the Gorgias ticket. Gorgias does not have a native CSAT object; the rating value is stored as a custom field. We map the 1-5 star scale from Teamwork to a numeric property named csat_score for reporting.
Teamwork Desk
Time Tracking (Pro tier and above)
Gorgias
Note / External Export
1:1Time entries logged against tickets in Teamwork Desk Pro and above export as a separate structured CSV alongside the ticket migration. We do not create native time-logging records in Gorgias because Gorgias lacks a time-tracking feature. The CSV is delivered to the customer for import into their billing or project management system, or manual entry into a Gorgias note attached to the relevant ticket.
Teamwork Desk
Triggers (Pro tier and above)
Gorgias
Gorgias Rules / Macros
1:1Teamwork Desk Triggers are workflow automation rules that fire on ticket events (status change, assignee change, customer reply). These are configuration objects and do not migrate. We document every active Trigger with its trigger condition, filter criteria, and action sequence during discovery and deliver a written inventory with recommended Gorgias Rules or Macros equivalents for the customer's admin to rebuild.
Teamwork Desk
Business Hours (Premium tier)
Gorgias
Business Hours (configuration)
1:1Business Hours in Teamwork Desk define SLA availability windows. This is a configuration object with no data payload. We document the current Business Hours schedule during discovery and the customer's admin recreates it in Gorgias Settings. Typical reconfiguration time is 30-60 minutes.
Teamwork Desk
Attachments
Gorgias
Attachments
1:1File attachments on tickets and Helpdocs are referenced by URL in Teamwork's API. We download all attachments, validate file type and size (Gorgias enforces a 25MB per-file limit), and re-upload to Gorgias storage. Files exceeding 25MB are flagged for the customer to host externally and link from the ticket. Inline images in Helpdocs content migrate as embedded attachments subject to the same size constraint.
Teamwork Desk
Reports
Gorgias
Reports
1:1Reports and analytics in Teamwork Desk are generated views and do not carry a data payload. We do not migrate reports. We recommend rebuilding key reports in Gorgias using its native reporting suite or exporting the Teamwork Desk report definitions as reference for the admin to recreate. Custom metrics in Gorgias Advanced and Enterprise can approximate Teamwork Desk Premium reporting features.
| Teamwork Desk | Gorgias | Compatibility | |
|---|---|---|---|
| Customer | Customer1:1 | Fully supported | |
| Ticket | Ticket1:1 | Fully supported | |
| Agent | Agent1:1 | Fully supported | |
| Inbox | Channel1:1 | Fully supported | |
| Helpdocs (Knowledge Base) | Knowledge Base1:1 | Fully supported | |
| Category | Category (flattened)lossy | Fully supported | |
| Tag | Tag1:1 | Fully supported | |
| Custom Fields (Premium/Enterprise) | Ticket Properties / Customer Attributeslossy | Mapping required | |
| Customer Happiness Rating (CSAT) | Custom Ticket Property1:1 | Fully supported | |
| Time Tracking (Pro tier and above) | Note / External Export1:1 | Mapping required | |
| Triggers (Pro tier and above) | Gorgias Rules / Macros1:1 | Not supported | |
| Business Hours (Premium tier) | Business Hours (configuration)1:1 | Not supported | |
| Attachments | Attachments1:1 | Mapping required | |
| Reports | Reports1: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.
Teamwork Desk gotchas
Spam tickets are silently excluded from Teamwork customer exports
Custom fields gated behind Premium and Enterprise tiers
API rate limit of 120 requests per minute constrains bulk export speed
Helpdesk Migration Service charges fees separate from Teamwork subscription
Triggers and business hours do not migrate as data
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 inbox audit
We audit the Teamwork Desk account to enumerate inboxes, agents, ticket volume (open, closed, archived), Helpdocs article count with attachment inventory, and any Premium/Enterprise custom fields. We run a parallel discovery of the Gorgias destination to identify the current plan tier, existing channels, and any pre-existing customer records that could cause deduplication. The discovery output is a written migration scope with object counts, a Gorgias plan sizing recommendation based on historical ticket volume, and a list of agent email addresses that need provisioning in Gorgias.
Agent provisioning and channel setup
We provide the customer with a list of Teamwork Desk agent email addresses that do not yet exist in Gorgias. The customer's admin provisions the missing agents (accepting invitations and activating accounts). Simultaneously, we map Teamwork Inboxes to Gorgias Channels so that routing rules are ready before ticket import. This step gates the migration: ticket import cannot proceed until all assigning agents exist in Gorgias.
Schema alignment and sandbox migration
We align Teamwork Desk custom fields (from Premium/Enterprise) to Gorgias ticket properties and customer attributes. Categories are flattened per the agreed mapping strategy. CSAT ratings are mapped to a custom numeric property. We run a sandbox migration with a subset of tickets (typically the last 30 days or 500 tickets) to validate mapping accuracy, verify that agent assignments resolve, and confirm that attachments upload without size errors. The customer's admin reviews the sandbox output and signs off before production migration begins.
Production migration in dependency order
We run production migration in dependency order: Customers first (with spam exclusion applied), then Tickets (with assignee resolution against the pre-provisioned agent list), then Helpdocs articles (with category and attachment mapping), then Tags (recreated in full). Each phase emits a row-count reconciliation report before the next phase begins. We monitor Gorgias API rate limits (handled server-side by Gorgias) and throttle the Teamwork Desk extraction layer to stay within the 120 req/min ceiling on the source side.
Cutover and delta migration
We freeze new ticket creation in Teamwork Desk during cutover, run a final delta migration of any tickets created or modified after the main migration window began, and validate the total record count against the discovery baseline. We deliver a migration summary report with record counts by object, attachment count and size, skipped records with reasons (spam exclusion, size limit, unmapped field), and a list of any agent email addresses that failed to resolve.
Automation handoff and post-migration support
We deliver the Trigger and Business Hours inventory document to the customer's admin for manual rebuild in Gorgias. We deliver the Time Tracking CSV as a separate export for the customer's billing system. We support a 5-business-day hypercare window where we resolve any data quality issues (duplicated customers, missing attachments, mapping corrections) raised by the customer's team. We do not rebuild Teamwork Desk Triggers as Gorgias Rules within the migration scope; that work is documented for the admin to complete post-migration.
Platform deep dives
Teamwork Desk
Source
Strengths
Weaknesses
Gorgias
Destination
Strengths
Weaknesses
Complexity grading
Moderate Helpdesk migration. 3 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 Teamwork Desk and Gorgias.
Object compatibility
3 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
Teamwork Desk: 120 requests per minute per org, returning X-Rate-Limit headers on every response.
Data volume sensitivity
Teamwork Desk 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 Teamwork Desk to Gorgias migration scoping. Not seeing yours? Book a call.
Walk through your Teamwork Desk 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 Teamwork Desk
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.