Helpdesk migration
Field-level mapping, validation, and rollback between OASYS and Intercom. We move data and schema; workflows are rebuilt natively in Intercom.
OASYS
Source
Intercom
Destination
Compatibility
9 of 12
objects map 1:1 between OASYS and Intercom.
Complexity
CModerate
Timeline
2-4 weeks
Overview
Moving from OASYS to Intercom is a structural migration from a ticket-centric helpdesk to a messenger-first conversational support platform. OASYS organizes support around Tickets, Customers, Companies, and Agents; Intercom uses Conversations as the primary support unit with Contacts and Companies as the customer record layer. We map OASYS Tickets to Intercom Tickets, preserve conversation chronology, and audit all OASYS custom fields to flag any unsupported field types that must be recreated in Intercom before data import. SLA definitions from OASYS use internal naming conventions that do not export as structured data; we document every SLA rule during discovery and deliver a written configuration guide so your admin rebuilds them in Intercom's native SLA UI. We do not migrate automations, workflows, or outbound campaigns as code; these require a separate rebuild scope post-migration.
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 OASYS 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.
OASYS
Ticket
Intercom
Ticket
1:1OASYS Tickets map directly to Intercom Tickets with ticket title, status, priority, and creation date preserved. The OASYS ticket ID is stored in a custom attribute oasys_ticket_id for audit traceability. We preserve full status transition history as ticket attribute changes in Intercom rather than separate timeline events.
OASYS
Customer
Intercom
People (Contact)
1:1OASYS Customer records map to Intercom People. The customer email is the dedupe key. We transfer all standard contact fields (name, email, phone, address) and preserve any OASYS lifecycle or segment data as custom attributes on the People record. Customer company associations resolve to Intercom Company records via the Company domain or explicit link.
OASYS
Company
Intercom
Company
1:1OASYS Company records map to Intercom Company records. Company name, domain, and metadata transfer as-is. We resolve the Company lookup for each Customer at migration time so that People records are linked to Companies on import rather than corrected post-migration. OASYS multi-customer company relationships become Intercom's company-to-people associations.
OASYS
Agent
Intercom
Teammate
1:1OASYS Agents map to Intercom Teammates by email address. We resolve agent email against the destination Intercom workspace and flag any OASYS agent without a corresponding Intercom user for admin provisioning before production migration. Historical ticket assignments preserve the agent identity even if the agent account is inactive in Intercom post-migration.
OASYS
Team
Intercom
Team
1:1OASYS Team structures and queue assignments map to Intercom Teams. We audit team rosters and queue routing rules during discovery and recreate equivalent Team structures in Intercom. If OASYS teams use dynamic membership rules, we document the equivalent Intercom Rules configuration for the admin to implement post-migration.
OASYS
Custom Field (Ticket)
Intercom
Ticket Attribute
lossyOASYS ticket custom fields map to Intercom Ticket Attributes. We audit every custom field type during discovery and flag any field using an OASYS-specific type that Intercom does not support. Unsupported field types must be recreated as string or number custom attributes in Intercom before ticket data imports, or values are stored as plain text custom properties. Field labels and help text are preserved in the migration documentation.
OASYS
Custom Field (Customer)
Intercom
People Custom Attribute
lossyOASYS customer custom fields map to Intercom People custom attributes. Multi-select, date, and numeric field types from OASYS require destination-side recreation in Intercom before migration because Intercom custom attributes have specific type requirements. We provide a field-by-field type mapping table during the scoping phase so the admin knows exactly what to create.
OASYS
Conversation
Intercom
Conversation
1:1OASYS conversation threads attached to tickets map to Intercom Conversations. We preserve the full thread chronology including customer replies and agent responses, internal notes, and timestamps. Each OASYS conversation thread becomes a single Intercom Conversation with all messages in chronological order. Intercom's conversation notes from OASYS internal notes migrate as private notes visible only to teammates.
OASYS
Attachment
Intercom
Attachment
1:1File attachments on tickets and conversations are downloaded from OASYS and uploaded to Intercom. We flag files exceeding 10MB during the audit phase because Intercom skips oversized files during import. The customer decides whether to compress, re-upload manually, or exclude oversized attachments. We preserve the original filename and attachment context so the admin can re-attach if needed.
OASYS
Tag
Intercom
Tag
1:1OASYS tags on tickets and customers map to Intercom Tags. We transfer all tag associations and preserve tag names. Note that Intercom's tag taxonomy has changed: tags now nest under categories. We add a migration-category tag prefix to all imported tags so the admin can reorganize them post-migration without losing the original tag data. Intercom has deprecated the flat tag behavior and recommends category-based reorganization.
OASYS
SLA Rule
Intercom
SLA Policy
lossyOASYS SLA definitions use internal naming conventions and condition logic that do not export as structured data. We capture screenshots and written documentation of every SLA rule during the audit phase. Post-migration, we deliver a configuration guide mapping each OASYS SLA to its Intercom SLA Policy equivalent with first response time, next response time, and resolution time targets. The admin rebuilds SLA policies in Intercom's native workspace settings.
OASYS
Internal Note
Intercom
Private Note (Conversation)
1:1OASYS internal notes on tickets migrate as Intercom private notes attached to the corresponding conversation. Private notes are visible only to teammates and not shown to customers, preserving the internal collaboration context from OASYS. We flag any note containing sensitive data (passwords, tokens) during the audit for the customer's security team to review before migration.
| OASYS | Intercom | Compatibility | |
|---|---|---|---|
| Ticket | Ticket1:1 | Fully supported | |
| Customer | People (Contact)1:1 | Fully supported | |
| Company | Company1:1 | Fully supported | |
| Agent | Teammate1:1 | Fully supported | |
| Team | Team1:1 | Fully supported | |
| Custom Field (Ticket) | Ticket Attributelossy | Fully supported | |
| Custom Field (Customer) | People Custom Attributelossy | Fully supported | |
| Conversation | Conversation1:1 | Fully supported | |
| Attachment | Attachment1:1 | Fully supported | |
| Tag | Tag1:1 | Fully supported | |
| SLA Rule | SLA Policylossy | Fully supported | |
| Internal Note | Private Note (Conversation)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.
OASYS gotchas
Custom field limitations require destination-side recreation
Attachment file size restrictions may cause partial migration
SLA rule mapping requires manual configuration post-migration
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 field audit
We audit the OASYS workspace across tickets, customers, companies, agents, teams, custom fields, conversation volumes, and attachment sizes. We identify every custom field type and flag any OASYS-specific types that require destination-side recreation in Intercom before import. We document SLA rules via screenshots and written notes because they do not export as structured data. The discovery output is a written migration scope, custom field recreation checklist, and SLA documentation package.
Intercom workspace provisioning and schema setup
The customer provisions an Intercom workspace and we guide the admin through creating equivalent custom attributes (typed to match OASYS field types), Teams (matching OASYS queue structure), and SLA Policies (from the documented SLA guide). We configure default assignment settings to allow unassigned tickets if any OASYS tickets lack an assigned agent. This phase runs in parallel with OASYS data extraction.
Data extraction and transformation
We extract all records from OASYS in dependency order: Customers first (as dedupe key for Conversations), then Companies, Agents, Teams, Tickets, Conversations, Attachments, and Tags. We apply field-level transformations including phone number format validation, custom field type mapping, and conversation thread normalization. Any invalid phone numbers are flagged for the admin to correct before import.
Demo migration and reconciliation
We run a demo migration of 20-50 sample tickets per category (open, closed, escalated) into a staging Intercom workspace. The customer's support operations lead reviews the migrated records against the OASYS source, confirms custom attribute mapping, and validates conversation thread ordering. Any mapping corrections happen in this phase before production migration begins. The demo migration serves as the formal sign-off checkpoint.
Production migration with delta sync
We run the production migration into the live Intercom workspace during a low-traffic window. Migration follows the dependency order established in extraction: People (Contacts), Companies, Tickets, Conversations, Attachments, Tags. We use Intercom's API with 500 requests per minute rate-limit handling, chunking conversation batches to avoid timeouts. A delta migration captures any records modified or created during the migration window before final cutover.
Cutover, validation, and SLA rebuild handoff
We freeze OASYS writes during cutover, run the final delta migration, then enable Intercom as the system of record. We deliver the SLA configuration guide and the automation inventory document to the customer's admin team. We support a three-day hypercare window where we resolve any reconciliation issues. Automations, Rules, and SLA policies require separate rebuild scope post-migration and are not included in the standard migration engagement.
Platform deep dives
OASYS
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 OASYS 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
OASYS: Not publicly documented..
Data volume sensitivity
OASYS 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 OASYS to Intercom migration scoping. Not seeing yours? Book a call.
Walk through your OASYS 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 OASYS
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.