Helpdesk migration
Field-level mapping, validation, and rollback between HelpDesk 3 and Intercom. We move data and schema; workflows are rebuilt natively in Intercom.
HelpDesk 3
Source
Intercom
Destination
Compatibility
10 of 12
objects map 1:1 between HelpDesk 3 and Intercom.
Complexity
CModerate
Timeline
2-4 weeks
Overview
Moving from HelpDesk 3 to Intercom is a structural migration with three compounding challenges: HelpDesk 3 has no documented public API, so all data extraction requires admin-panel or CSV-based exports that must be validated for field completeness before mapping. Second, HelpDesk 3 stores in-app chat transcripts and email threads as separate conversation objects under a single ticket; we flatten these into a single chronological Intercom conversation and tag each message by its original channel so context is preserved. Third, HelpDesk 3's knowledge base uses a CMS-linked article model; we export as structured HTML, remap categories to Intercom Collections, and automatically rewrite internal cross-links to match the new URL structure. Workflows, automations, client portal configurations, and billing records tied to HelpDesk 3's CMS do not migrate; we deliver a written inventory for manual rebuild and note where Intercom's Fin AI Agent can replace existing rule-based automation at a fraction of HelpDesk 3's manual effort.
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 Intercom, 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
Intercom
Tickets
1:1HelpDesk 3 Tickets map 1:1 to Intercom Tickets. The HelpDesk 3 ticket status (open, pending, resolved, closed) maps to Intercom Ticket State, and priority maps to Ticket Priority. We preserve the original ticket ID in a custom attribute for audit traceability. Multi-email linked tickets are flattened to a single Intercom ticket with the original email references stored as message metadata.
HelpDesk 3
Customers
Intercom
Contacts
1:1HelpDesk 3 Customer records map to Intercom Contacts. Contact fields (name, email, phone, company) migrate directly. HelpDesk 3 company associations map to Intercom Companies via domain match or explicit company field. We deduplicate contacts by email address during import and flag any duplicates for customer admin review.
HelpDesk 3
Agents
Intercom
Teammates (Admins/Agents)
1:1HelpDesk 3 Agent accounts (name, email, role, availability) map to Intercom Teammates. Role assignments migrate to Intercom Inbox permissions (admin, agent, viewer). We match by email and hold any Agent without a matching Intercom workspace invite in a reconciliation queue until the admin provisions the account.
HelpDesk 3
Conversations (Email)
Intercom
Conversations
1:1HelpDesk 3 email thread objects migrate to Intercom Conversations as email-channel messages. Each message carries its original sender, recipient, timestamp, and body content. Attachments referenced in the email thread are downloaded, re-hosted, and linked to the corresponding Intercom message.
HelpDesk 3
Conversations (Chat)
Intercom
Conversations
1:1HelpDesk 3 in-app chat transcripts migrate to Intercom Conversations as messenger-channel messages. We tag each chat message with channel:chat in the message metadata so agents can distinguish the original channel at a glance. Both conversation types are merged under the parent Ticket in chronological order.
HelpDesk 3
FAQ Articles
Intercom
Articles
1:1HelpDesk 3 FAQ articles export as structured HTML with title, body content, category, and visibility. We remap HelpDesk 3 categories to Intercom Collections and Sections, preserving the hierarchy. Multilingual articles are mapped to their corresponding Intercom locale. Internal cross-links between articles are automatically rewritten to match Intercom's URL structure using the migration tool's link-rewrite engine.
HelpDesk 3
Attachments
Intercom
Attachments
1:1File attachments linked to tickets and FAQ articles are exported to cloud storage, re-hosted, and relinked in Intercom. Attachments stored as external URLs in HelpDesk 3 are validated for accessibility before migration; broken URLs are flagged in the post-migration report. Inline images in FAQ articles are extracted and re-hosted as article attachments.
HelpDesk 3
Tags
Intercom
Tags
1:1HelpDesk 3 ticket tags migrate to Intercom Conversation Tags. Tag names are preserved verbatim. HelpDesk 3 article tags migrate to Intercom Article Labels. Tag namespaces between the two platforms differ; we normalize at import time to prevent duplicate tag creation.
HelpDesk 3
Custom Fields
Intercom
Custom Attributes
lossyHelpDesk 3 per-ticket and per-customer custom fields are extracted during the audit phase with their data types, picklist values, and usage frequency. We pre-create matching custom attributes in Intercom with equivalent types (text, number, date, select, multi-select) before ticket import begins. Custom field values are remapped during the ticket migration phase.
HelpDesk 3
Pipeline / Status Workflows
Intercom
Ticket Statuses / Ticket Types
lossyHelpDesk 3 ticket status workflows (open, pending, resolved, closed) map to Intercom Ticket Status values. Custom statuses are flagged for manual configuration in Intercom Admin if no direct equivalent exists. The workflow rules that trigger on status change are documented in the automation inventory and are not migrated as code.
HelpDesk 3
Billing Records
Intercom
Customer Notes (or archived)
1:1HelpDesk 3 billing module records (invoices, payments) tied to client accounts are not standard Intercom objects. We consolidate billing metadata (outstanding balance, subscription tier, last payment date) into the Intercom Contact or Company record as custom attributes. Full invoice history is exported as a CSV archive and linked from the Company record for admin reference.
HelpDesk 3
Client Portal Settings
Intercom
Documented (not migrated)
1:1HelpDesk 3 portal visibility rules, submission form configurations, and CMS embedding settings are tied to the source platform's infrastructure and are not structurally portable. We document the full portal configuration during the audit phase, including form fields, routing rules, and branding settings, so the customer admin can replicate them in Intercom's Message templates and Article visibility settings post-migration.
| HelpDesk 3 | Intercom | Compatibility | |
|---|---|---|---|
| Tickets | Tickets1:1 | Mapping required | |
| Customers | Contacts1:1 | Fully supported | |
| Agents | Teammates (Admins/Agents)1:1 | Fully supported | |
| Conversations (Email) | Conversations1:1 | Mapping required | |
| Conversations (Chat) | Conversations1:1 | Mapping required | |
| FAQ Articles | Articles1:1 | Mapping required | |
| Attachments | Attachments1:1 | Mapping required | |
| Tags | Tags1:1 | Mapping required | |
| Custom Fields | Custom Attributeslossy | Mapping required | |
| Pipeline / Status Workflows | Ticket Statuses / Ticket Typeslossy | Mapping required | |
| Billing Records | Customer Notes (or archived)1:1 | Mapping required | |
| Client Portal Settings | Documented (not migrated)1: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
Intercom gotchas
S3 JSON export omits conversation transcripts
Workspace isolation prevents workflow migration
Fin AI resolution fees compound with automation success
Two-year conversation history limit on historical export
Private app rate limits share workspace quota
Pair-specific challenges
Migration approach
Discovery and export feasibility assessment
We audit HelpDesk 3 across available export methods: admin-panel CSV export, database-level access, or custom script extraction. We inventory ticket count, customer count, agent count, FAQ article count, conversation volume (email vs chat split), attachment count and average size, and any active custom fields. We also assess HelpDesk 3 server stability history and schedule a test export during an off-peak window to validate field completeness. The discovery output is a written migration scope with record counts, export method confirmation, and a custom fields catalog.
Export execution and data validation
We run CSV exports from HelpDesk 3 admin panel per object (Tickets, Customers, Agents, FAQ Articles, Attachments). Each export is validated for column completeness, null-rate analysis on required fields, and date-format consistency. Attachments are downloaded from HelpDesk 3 and staged in cloud storage. Any export failures trigger retry with backoff. We checkpoint after each successful export phase so the project can resume from the last successful row if HelpDesk 3 connectivity drops.
Intercom workspace provisioning and schema design
We provision the Intercom workspace, create Teammate accounts matching the HelpDesk 3 agent list, configure Inbox permissions, and pre-create custom attributes (mapped from HelpDesk 3 custom fields) on Contacts, Companies, and Tickets. Knowledge base Collections and Sections are created to match HelpDesk 3 FAQ categories. Ticket Status values and Ticket Types are configured to match HelpDesk 3 workflow states. This phase runs in parallel with export validation.
Conversation merge and ticket migration
We run HelpDesk 3 ticket migration with chat and email conversation threads merged into single Intercom conversation records per ticket. Messages are ordered chronologically and tagged by original channel. Custom field values from HelpDesk 3 are mapped to the corresponding Intercom custom attributes during ticket insert. Tags are applied via a post-insert tag-mapping phase using the Intercom API. We run this phase in batches of 500 tickets with row-count reconciliation after each batch.
Knowledge base import with cross-link rewriting
FAQ articles are exported from HelpDesk 3 as structured HTML and imported into Intercom Articles under the matching Collections and Sections. Inline images are extracted, re-hosted, and relinked. Multilingual articles are mapped to their corresponding Intercom locales. The migration tool automatically rewrites internal cross-links between HelpDesk 3 articles to match Intercom's URL structure so that every migrated article link resolves correctly after go-live.
Cutover, validation, and automation inventory delivery
We freeze HelpDesk 3 writes during cutover, run a final delta migration of any records modified during the migration window, then enable Intercom as the system of record. We deliver a row-count reconciliation report (tickets in, contacts in, articles in, attachments in) plus a spot-check validation on 25-50 records selected by the customer. We deliver the automation and workflow inventory document listing every HelpDesk 3 workflow rule, client portal configuration, and billing module setting that requires manual rebuild in Intercom. We support a three-day hypercare window for reconciliation issues raised by the support team.
Platform deep dives
HelpDesk 3
Source
Strengths
Weaknesses
Intercom
Destination
Strengths
Weaknesses
Complexity grading
Moderate Helpdesk migration. 5 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 Intercom.
Object compatibility
5 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 Intercom migration scoping. Not seeing yours? Book a call.
Walk through your HelpDesk 3 to Intercom 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 Intercom
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.