Helpdesk migration
Field-level mapping, validation, and rollback between Vision Service Desk and Intercom. We move data and schema; workflows are rebuilt natively in Intercom.
Vision Service Desk
Source
Intercom
Destination
Compatibility
10 of 11
objects map 1:1 between Vision Service Desk and Intercom.
Complexity
CModerate
Timeline
3-5 weeks
Overview
Moving from Vision Service Desk to Intercom is a platform-category shift from ITSM-centric ticketing to customer-messaging-first conversation management. Vision Service Desk is built around ITIL-certified workflows with separate Problem Management, Change Management, and CMDB objects; Intercom is structured around a unified conversation thread linked to Users and Companies with a messenger-first agent experience. We resolve this architectural difference by mapping Vision Service Desk Tickets to Intercom Conversations, extracting threaded comments as conversation parts, and preserving the requester-to-contact relationship. Staff records map to Intercom Teammates with role assignment. We do not migrate Problem Management, Change Management, or SLA plan definitions as code because Intercom does not expose equivalents; we deliver a written inventory of these records for the customer's admin to rebuild. On-premises Vision Service Desk deployments require CSV or direct database access since there is no REST export API; we confirm deployment type during discovery and adjust the extraction strategy accordingly. Custom fields and tags migrate as supplementary properties on the parent ticket or contact object.
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 Vision Service Desk 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.
Vision Service Desk
Ticket/Request
Intercom
Conversation
1:1Vision Service Desk Tickets map to Intercom Conversations. The ticket subject becomes the conversation title, the ticket status (Open, Pending, Resolved, Closed) maps to Intercom's open, closed, snoozed state, and priority maps to a custom priority attribute on the conversation. Threaded ticket comments migrate as conversation parts in chronological order, with internal-only comments mapped to internal notes in Intercom using the comment privacy flag. Requester information links to the migrated Intercom User record.
Vision Service Desk
Client/User
Intercom
User
1:1Vision Service Desk Clients (end-users submitting tickets via portal) map to Intercom Users. We extract client profile fields including name, email, phone, and portal preferences. Client-side custom fields migrate as custom user attributes in Intercom. Clients without email addresses present a challenge because Intercom requires an email for User creation; we flag these records during scoping and either map to a placeholder email domain or exclude per the customer's preference.
Vision Service Desk
Staff/Agent
Intercom
Teammate
1:1Vision Service Desk Staff records map to Intercom Teammates with their display name, email, and admin status. Super-Admins and Team Managers from Vision Service Desk become Admin roles in Intercom; standard agents become Member roles. Staff hierarchy (team structure, reporting lines) does not have a direct Intercom equivalent and requires manual team configuration in Intercom's inbox settings post-migration.
Vision Service Desk
Company
Intercom
Company
1:1Vision Service Desk Companies (organization-level groupings for clients) map to Intercom Companies. Company-to-contact relationships preserve so that Intercom's unified contact profile shows all tickets and conversation history for a given company. Company-specific custom fields migrate as company attributes in Intercom.
Vision Service Desk
Knowledge Base Article
Intercom
Article
1:1Vision Service Desk KB Articles map to Intercom Help Center Articles. Article content migrates as HTML body, title migrates directly, and author information is preserved as an article attribute. Article-to-category associations are remapped to Intercom Collections during import. Custom article fields require field-type mapping because Intercom's article attribute model differs from Vision Service Desk's extended field support.
Vision Service Desk
KB Category
Intercom
Collection
1:1Vision Service Desk KB Categories map to Intercom Collections. The hierarchical category tree is preserved as a flat collection structure in Intercom because Intercom Collections do not support nested sub-collections at the same depth as Vision Service Desk's category hierarchy. We flatten the structure and confirm the collection mapping with the customer during scoping.
Vision Service Desk
Custom Field
Intercom
Custom Attribute
lossyVision Service Desk custom fields (drop-down, multi-select, date, string, boolean, numeric) defined on tickets and clients are extracted as supplementary properties and mapped to Intercom Custom Attributes. Intercom supports string, integer, float, boolean, date, and list attribute types; complex nested or relational custom fields from Vision Service Desk may require simplification or decomposition into multiple Intercom attributes. We build the custom field manifest during discovery to avoid silent data loss.
Vision Service Desk
Tag/Label/Flag
Intercom
Tag
1:1Vision Service Desk ticket tags, labels, and flags migrate as Tags on the corresponding Intercom Conversation. The tag taxonomy is preserved at the record level. Intercom's tag model is flat (no hierarchical tag groups), so nested Vision Service Desk label structures are flattened and delivered with a tag-naming convention that preserves hierarchy visually (e.g., product::feature::issue).
Vision Service Desk
SLA Plan
Intercom
SLA (configuration documentation)
1:1Vision Service Desk SLA Plans with calendar-based response and resolution targets are documented but not recreated as code. Intercom's SLA features are implemented through the inbox SLAs settings and First Response Time rules, which operate differently from Vision Service Desk's plan-based SLA model. We deliver a written SLA mapping document specifying which Intercom SLA rule corresponds to each Vision Service Desk plan, including target hours and business hours configuration.
Vision Service Desk
Problem Management Record
Intercom
No equivalent (archived)
1:1Vision Service Desk Problem Management records (Pro Service Desk tier and above) have no direct Intercom equivalent. Intercom does not expose a separate Problem object or incident-linking model. We extract Problem records and their linked incident associations and deliver them as a structured CSV for the customer's admin to review. If the customer requires this data in Intercom, we discuss a custom object implementation as a separate scope item.
Vision Service Desk
Change Management Record
Intercom
No equivalent (archived)
1:1Vision Service Desk Change Management records with approval workflows and schedules do not map to any Intercom construct. Intercom has no native change request or approval chain object. We export Change records with approval status history as a structured data file and flag them for manual reference. If ITSM compliance is required post-migration, the customer should evaluate adding a dedicated ITSM tool alongside Intercom for this scope.
| Vision Service Desk | Intercom | Compatibility | |
|---|---|---|---|
| Ticket/Request | Conversation1:1 | Fully supported | |
| Client/User | User1:1 | Fully supported | |
| Staff/Agent | Teammate1:1 | Fully supported | |
| Company | Company1:1 | Fully supported | |
| Knowledge Base Article | Article1:1 | Fully supported | |
| KB Category | Collection1:1 | Fully supported | |
| Custom Field | Custom Attributelossy | Fully supported | |
| Tag/Label/Flag | Tag1:1 | Fully supported | |
| SLA Plan | SLA (configuration documentation)1:1 | Fully supported | |
| Problem Management Record | No equivalent (archived)1:1 | Fully supported | |
| Change Management Record | No equivalent (archived)1:1 | 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.
Vision Service Desk gotchas
On-premises instances lack a unified REST export API
Custom ticket fields hidden from standard API responses
Satellite Desk tier has feature gating on data model objects
Staff import CSV requires specific column ordering
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 deployment type confirmation
We audit the source Vision Service Desk account across edition (Starter Help Desk, Pro Help Desk, Satellite, Pro Service Desk, Enterprise Service Desk), deployment type (SaaS region or on-premises), active ticket volume, client count, staff roster, Knowledge Base article count, and any active SLA plans, Problem records, or Change Management records. We confirm deployment type as the first item because SaaS and on-premises extraction strategies differ fundamentally. The discovery output is a written migration scope, a record-count estimate, and a custom field manifest.
Data extraction strategy and extraction pipeline build
For SaaS deployments, we connect to the Vision Service Desk REST API and extract Tickets, Clients, Staff, Companies, Knowledge Base Articles, and KB Categories with explicit custom field inclusion. For on-premises deployments, we coordinate CSV exports from the admin panel or, when CSV scope is insufficient, we build a direct database read using customer-provided database credentials. We extract threaded comments and internal notes with their privacy flags preserved, and we build the ticket-to-conversation transformation pipeline during this phase.
Intercom workspace setup and attribute pre-creation
We configure the Intercom destination workspace before any data loads. This includes creating all required Teammates with matching roles, setting up Inboxes and Teams corresponding to the Vision Service Desk staff hierarchy, creating custom user and conversation attributes for every migrated Vision Service Desk custom field, setting up Collections for Knowledge Base structure, and configuring SLA rules as documented equivalents to Vision Service Desk SLA plans. Attributes must exist in Intercom with their IDs before any records can be mapped to them.
Sample migration and mapping validation
We run a test migration with a representative sample of tickets (50-100 records), contacts, and Knowledge Base articles into a non-production Intercom workspace or a parallel Inbox. The customer reviews the conversation thread fidelity, attribute mapping accuracy, internal note classification, and Knowledge Base article rendering. Any mapping corrections happen here before production migration begins. We do not proceed to production migration until the sample is signed off.
Production migration in dependency order
We run production migration in record-dependency order: Companies first (to establish the Company entity), then Users (Clients mapped to Users with company links), then Staff (Teammates with roles), then Conversations (Tickets mapped to Conversations with thread parts and internal note flags), then Knowledge Base Articles (with collection assignments), then Tags (applied to conversations post-import). Each phase emits a row-count reconciliation report. We use the Intercom REST API with rate-limit handling and exponential backoff. On-premises extraction pipelines feed into this same import sequence.
Cutover, validation, and handoff documentation
We freeze Vision Service Desk writes during the cutover window, run a final delta migration of any records created or modified during migration, then enable Intercom as the system of record. We deliver the Problem and Change Management record archive, the SLA mapping document, the metric-alignment guide for conversation-based reporting, and the custom field manifest with Intercom attribute IDs. We support a three-day hypercare window for reconciliation issues. Workflows, automations, and SLA engine configurations are not migrated as code and are delivered as written documentation for the customer's admin to rebuild in Intercom Rules.
Platform deep dives
Vision Service Desk
Source
Strengths
Weaknesses
Intercom
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 Vision Service Desk and Intercom.
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
Vision Service Desk: Not publicly documented in available developer resources.
Data volume sensitivity
Vision Service 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 Vision Service Desk to Intercom migration scoping. Not seeing yours? Book a call.
Walk through your Vision Service Desk 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 Vision Service Desk
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.