Helpdesk migration
Field-level mapping, validation, and rollback between Movidesk and Gorgias. We move data and schema; workflows are rebuilt natively in Gorgias.
Movidesk
Source
Gorgias
Destination
Compatibility
10 of 12
objects map 1:1 between Movidesk and Gorgias.
Complexity
CModerate
Timeline
3-5 weeks
Overview
Moving from Movidesk to Gorgias is a data migration from a Brazilian-market SMB helpdesk into a Shopify-native ecommerce support platform. Movidesk organizes tickets with a unified People object for agents and customers, separate Organizations, and Movidesk-specific abstractions like Services and Billing agreements. Gorgias separates Customers (Shopify-linked customer profiles) from Agents (agent workspace accounts), lacks a native Services or Billing agreement concept, and uses a per-ticket pricing model rather than Movidesk's flat agent-rate. We handle the 10 req/min API rate limit through chunked batching and exponential backoff, resolve custom field values via Movidesk's POST-only InsertValues/UpdateValues/DeleteValues operations, and deliver a written inventory of Workflow rules and SLA configurations that require manual rebuild in Gorgias. Knowledge base Articles and Categories migrate as-is; multilingual KB requires post-migration verification of Help center appearance per language.
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 Movidesk 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.
Movidesk
Ticket
Gorgias
Ticket
1:1Movidesk Tickets map directly to Gorgias Tickets. The Movidesk schema (status, priority, owner, ownerTeam, changedBy, changedDate, permanencyTimeFullTime, permanencyTimeWorkingTime, statusHistories) maps to Gorgias's ticket object. Status values from Movidesk map to Gorgias Ticket Status values; Priority maps to Gorgias priority. We preserve the original created date, updated date, and closed date as ticket metadata. Note: Gorgias cannot auto-sync ticket statuses post-import—if a Movidesk ticket resolves after import, Gorgias won't reflect that change automatically.
Movidesk
People (agents)
Gorgias
Agent
1:1Movidesk People records with agent role map to Gorgias Agent accounts. We match by email address as the dedupe key. Agent name, email, and active status migrate. Movidesk access profile permissions (which control Workflow visibility and feature access) do not map to Gorgias agent permissions; we document the Movidesk access profile assignments in a permissions matrix for the customer's admin to configure in Gorgias Settings.
Movidesk
People (customers)
Gorgias
Customer
1:1Movidesk People records with customer role map to Gorgias Customer profiles. Email, name, phone, and any custom field values migrate. Customers are created before tickets so that the customer reference is satisfied at ticket import time. If the customer has a linked Shopify account, Gorgias's native Shopify integration can re-link the profile post-migration using the email address.
Movidesk
Organization
Gorgias
Customer (organization link)
lossyMovidesk Organizations (companies) have no direct Gorgias equivalent. Gorgias Customer records support a company name field but no separate Organization object. We map Organizations to the company name field on Gorgias Customer records. If the customer maintains separate Organization records with additional attributes (industry, size, contract tier), those attributes require custom field creation in Gorgias and migration as Customer custom fields. We flag this during scoping.
Movidesk
Services
Gorgias
(no equivalent — custom field or tag)
1:1Movidesk Services represent service-level abstractions (e.g., Platinum Support, Enterprise SLA) that are distinct from ticket properties. Gorgias has no Services object. We map Service values to Gorgias ticket tags or a custom select field (e.g., service_tier) that the customer's admin configures in Gorgias Settings > Custom Fields before migration. The customer chooses the target strategy during scoping.
Movidesk
Billing agreements
Gorgias
(no equivalent — custom field)
1:1Movidesk Billing agreements track contractual service terms (contract dates, billing cycles, SLA commitments) that are Movidesk-specific. Gorgias has no Billing agreement object. We map available Billing agreement fields to Gorgias Customer custom fields (e.g., contract_start_date, contract_end_date, billing_cycle). Complex contractual hierarchies may require a separate spreadsheet inventory for the admin to reference post-migration.
Movidesk
Asset
Gorgias
(no equivalent — ticket association)
1:1Movidesk Assets track equipment or products linked to tickets and Organizations. Gorgias has no Asset object. We migrate asset data as a JSON attachment on the related Gorgias ticket or as a note with the asset identifier and attributes. Cross-references to Organizations become references to the company name field on the Customer record. If asset tracking is a core requirement, we recommend a third-party asset management integration post-migration.
Movidesk
Ticket Custom Field Values
Gorgias
Custom Fields (Ticket)
1:1Movidesk ticketCustomFieldValue uses a POST-only API with three named operations: InsertValues, UpdateValues, DeleteValues. There is no GET endpoint to retrieve custom field schemas. We discover Movidesk custom field definitions during the scoping phase (by inspecting a sample of ticket records), generate the corresponding Gorgias custom field definitions, create them via the Gorgias API (POST /custom-fields with object_type=Ticket), then issue InsertValues POSTs per field per ticket under the 10 req/min rate limit. Each custom field update counts toward the rate limit, so we batch and space these calls carefully.
Movidesk
Knowledge base Articles
Gorgias
Help Center Articles
1:1Movidesk KB Articles map to Gorgias Help Center Articles. We export article title, body content (HTML), author, folder/category assignment, and status (published/draft). Articles are created in Gorgias after their parent Category exists. Note: multilingual KB requires post-migration verification—Movidesk mandates separate Help center appearance configurations per language, and Gorgias requires translations to be attached to each article. Incomplete translation sets may prevent articles from displaying correctly in the target language.
Movidesk
Knowledge base Categories
Gorgias
Help Center Categories
1:1Movidesk KB Categories map to Gorgias Help Center Categories (top-level) and sub-Categories. We preserve the category hierarchy and position ordering. Categories must exist in Gorgias before articles can be assigned, so we sequence the KB migration as: top-level Categories, sub-Categories, then Articles. Multilingual KB requires that categories have translations in all enabled languages before articles can publish—this is a known Movidesk requirement that carries forward to Gorgias.
Movidesk
Tag
Gorgias
Tag
1:1Movidesk tags on tickets and articles migrate as Gorgias Tags. Tags are flat label associations without hierarchy. We import tags as a tag list on the relevant Ticket or Article record. Tag naming is preserved as-is; no transformation is applied unless duplicate tag names are detected across ticket and article scopes.
Movidesk
Workflow rules
Gorgias
(no equivalent — inventory delivered)
lossyMovidesk Workflow rules define sequential task execution and automation routing. Gorgias uses Macros (agent-triggered templates) and Rules (trigger-action automations), which are architecturally different. We do not migrate Workflows as code. We export the full Workflow definition including triggers, conditions, actions, and SLA escalations and deliver a written inventory with each Workflow mapped to a recommended Gorgias Rule or Macro equivalent. The customer's admin rebuilds the automations in Gorgias post-migration. Note: Movidesk Workflow requires the 'Allow registering work sequences' setting to be enabled per access profile—if this feature was disabled in Movidesk, the Workflow menu won't appear, and we verify this during scoping.
| Movidesk | Gorgias | Compatibility | |
|---|---|---|---|
| Ticket | Ticket1:1 | Fully supported | |
| People (agents) | Agent1:1 | Fully supported | |
| People (customers) | Customer1:1 | Fully supported | |
| Organization | Customer (organization link)lossy | Fully supported | |
| Services | (no equivalent — custom field or tag)1:1 | Mapping required | |
| Billing agreements | (no equivalent — custom field)1:1 | Mapping required | |
| Asset | (no equivalent — ticket association)1:1 | Fully supported | |
| Ticket Custom Field Values | Custom Fields (Ticket)1:1 | Fully supported | |
| Knowledge base Articles | Help Center Articles1:1 | Fully supported | |
| Knowledge base Categories | Help Center Categories1:1 | Fully supported | |
| Tag | Tag1:1 | Fully supported | |
| Workflow rules | (no equivalent — inventory delivered)lossy | 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.
Movidesk gotchas
API rate limit of 10 requests per minute constrains bulk migrations
Custom field API is POST-only with three named operations
Workflow requires access profile activation before it is visible in the UI
Pricing is in Brazilian Real, not USD, and may fluctuate
Multilingual knowledge base requires per-language Help center appearance setup
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 scoping
We audit the source Movidesk account: ticket volume, People count (agent vs customer breakdown), Organization records, Asset records, Service definitions, Billing agreement schema, Knowledge base article and category count, active Workflow rules, SLA configurations, and custom field inventory. We inspect a sample of ticket records to discover custom field names and types (since the API has no GET schema endpoint). We confirm the Workflow feature is enabled in each agent's access profile. We review Gorgias destination settings: plan tier, existing custom fields, Help Center structure, and any active Rules or Macros. The discovery output is a written migration scope, object mapping table, and a Gorgias plan recommendation based on projected ticket volume.
Gorgias custom field and Help center provisioning
Before any data moves, we create all required Gorgias custom fields via the POST /custom-fields API. For ticket-level custom fields, we create them with object_type=Ticket; for customer-level attributes (from Movidesk Organizations or Billing agreements), we create them with object_type=Customer. We create the Help Center category hierarchy in Gorgias matching the Movidesk KB structure. We provision any required tags in Gorgias that will serve as the Services target. This step runs in the customer's Gorgias sandbox or staging environment first to validate before production.
Rate-limited data extraction from Movidesk
We extract all source records from Movidesk using the public API under the 10 req/min constraint. Records are extracted in dependency order: People (agents and customers) first (for dedupe key resolution), then Organizations (for company name lookups), then Tickets (with full comment and attachment history), then Assets, then KB Articles. Custom field values are extracted as a separate pass after ticket records, issued as a dedicated batch queue because each field per ticket requires a separate POST to InsertValues. We export to intermediate JSON/CSV staging files and run validation checks (record counts, required field completeness, date range coverage) before beginning the load phase.
Gorgias load in dependency order with parent-record resolution
We load records into Gorgias in strict dependency order: Customers (from Movidesk People with customer role), Agents (from Movidesk People with agent role), then Tickets (with customer references resolved by email match). Tags are imported alongside ticket records. Knowledge base Categories are created before Articles. Articles are loaded with their category assignments and published status preserved. Custom field values are loaded last via POST to InsertValues, batched under the source platform's rate limit (we cannot control Gorgias rate limits directly, but we sequence custom field loads after primary objects to avoid blocking). Each phase emits a row-count reconciliation report.
Knowledge base article migration and multilingual verification
We migrate KB Articles and Categories from Movidesk to Gorgias Help Center. If the Movidesk KB has multiple languages enabled, we verify that each article has translations attached in Gorgias (Gorgias requires translations to be added per article). We flag any articles with incomplete translation sets as a post-migration action item. Help center appearance configuration (branding, colors, logo) is Movidesk-specific and does not migrate; we recommend the customer's admin re-apply the Help center theme in Gorgias Settings post-migration.
Cutover, delta migration, and Workflow rebuild handoff
We freeze Movidesk writes at cutover, run a final delta pass to capture any records modified during the migration window, then mark Gorgias as the system of record. We deliver the Workflow and SLA inventory document to the customer's admin team with recommended Gorgias Rule and Macro equivalents. We support a one-week hypercare window where we resolve any record reconciliation issues. We do not rebuild Movidesk Workflows as Gorgias Rules inside the migration scope; that work is documented for the customer's admin to implement post-migration. Gorgias subscription billing activates at cutover and is managed directly between the customer and Gorgias.
Platform deep dives
Movidesk
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 Movidesk 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
Movidesk: 10 requests per minute per API token.
Data volume sensitivity
Movidesk 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 Movidesk to Gorgias migration scoping. Not seeing yours? Book a call.
Walk through your Movidesk 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 Movidesk
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.