Helpdesk migration

Migrate from OTRS to Intercom

Field-level mapping, validation, and rollback between OTRS and Intercom. We move data and schema; workflows are rebuilt natively in Intercom.

OTRS logo

OTRS

Source

Intercom

Destination

Intercom logo

Compatibility

50%

6 of 12

objects map 1:1 between OTRS and Intercom.

Complexity

BStandard

Timeline

2-4 weeks

Rollback included Accuracy guarantee Field-level validation

Overview

What this migration involves

OTRS and Intercom operate on fundamentally different service-desk models. OTRS organizes work around Tickets, Queues, SLA definitions, and optional Process Management workflows in a normalized MySQL or PostgreSQL schema. Intercom organizes work around Conversations threaded against Contacts in a flat, API-driven data model without queues, SLA objects, or CMDB records. We map OTRS Tickets directly to Intercom Conversations, map OTRS Queue assignments to Intercom Inbox routing, preserve OTRS article history as Intercom conversation parts, and carry OTRS SLA escalation thresholds as metadata tags on each conversation. Dynamic Fields from OTRS migrate as custom attributes on Intercom Contacts or as conversation metadata. OTRS Process Management XML workflows and Configuration Item (CMDB) records do not migrate as code or structured data; we deliver a written inventory of each for the customer's admin to rebuild in Intercom's Workflow Builder or as custom attributes. Intercom's API enforces a 1,000 request per minute rate limit distributed as 166 operations per 10-second window, which governs our batch chunking strategy during import.

Field-level fidelity

Every standard and custom field arrives verified.

Schema-aware mapping

AI proposes the map; you confirm before any record moves.

Relationships preserved

Parent–child, lookups, and ownership stay linked.

Full activity history

Calls, emails, meetings — with original timestamps.

Attachments & notes

Documents, uploads, and inline notes move with the record.

Why teams make this switch

Two sides of the same decision

Leaving

OTRS logo

OTRS

What's pushing teams away

  • Annual licensing and support contract costs scale steeply, prompting teams to evaluate lower-cost SaaS alternatives with similar capabilities.
  • The 300-page admin manual and $2,000+ per-person training requirement means teams cannot self-onboard, creating friction for smaller organizations.
  • Performance degrades noticeably on large ticket volumes without tuning, and slow loading pages frustrate agents handling high-throughput queues.
  • The Community Edition received no security patches after OTRS 6, forcing organizations onto paid tiers or unsupported forks to maintain compliance posture.

Choosing

Intercom logo

Intercom

What's pulling them in

  • Instant chat and message threading on websites and apps gives support teams a single inbox without context-switching, according to reviewers on Capterra and G2 who highlight fast response times as a primary benefit.
  • Fin AI handles repetitive inbound queries automatically, reducing agent workload measurably — G2 reviewers report fewer escalations and faster first-response times once Fin is configured.
  • Automation workflows (Outbound, Operator, and custom bots) allow teams to qualify leads and route tickets without manual intervention, appealing to growth-stage SaaS companies managing high ticket volumes.
  • Help center articles and self-service deflection are natively integrated, so knowledge base content and chat conversations live in the same workspace, simplifying reporting.
  • Multi-channel support (live chat, email, SMS, WhatsApp, Phone) consolidates customer touchpoints into one inbox, reducing the operational overhead of managing separate tools.

Object mapping

How OTRS objects map to Intercom

Each row shows how a OTRS 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.

OTRS

Ticket

maps to

Intercom

Conversation

1:1
Fully supported

OTRS Tickets map directly to Intercom Conversations. We extract ticket title as conversation subject, ticket state (open, pending, closed) as conversation state, and queue assignment as Inbox routing. Article history migrates as conversation parts in chronological order with sender type preserved (customer, agent, or system). Closed tickets migrate with their full article history; open tickets migrate with a delta run at cutover time. OTRS ticket priority maps to a custom priority attribute on the conversation.

OTRS

Article

maps to

Intercom

Conversation Part

1:many
Fully supported

OTRS Articles (emails, notes, external replies) map to Intercom Conversation Parts. Each article body migrates as a part with content-type preserved (plain text or HTML, converted to Intercom's markdown-equivalent format). Sender information from OTRS maps to the part author: OTRS customers become Intercom contacts, OTRS agents become Teammate parts. Attachments on each article migrate as file parts attached to the corresponding conversation part.

OTRS

Customer

maps to

Intercom

Contact

1:1
Fully supported

OTRS Customer records (with UserID, email, phone, and user preferences) map to Intercom Contacts. The OTRS CustomerID becomes the Intercom contact's external_id for dedupe. OTRS customer type (customer or company customer) determines whether the contact record is tagged as individual or linked to an Intercom Company. Customer preferences and valid/invalid phone flags are preserved as contact attributes.

OTRS

Dynamic Field (Ticket)

maps to

Intercom

Conversation Metadata or Custom Attribute

lossy
Fully supported

OTRS Dynamic Fields on tickets are enumerated during scoping, classified by data type (text, integer, date, dropdown, checkbox, multi-select). Text and numeric fields map to conversation metadata tags. Date fields map to conversation custom timestamps. Dropdown and multi-select fields map to conversation tags with the original OTRS field name preserved as tag namespace. We map Dynamic Fields on Customer records to Intercom custom attributes on the Contact object. Fields that have no equivalent in Intercom's schema are flagged as requires-admin-decision items during scoping.

OTRS

Queue

maps to

Intercom

Inbox

1:1
Fully supported

OTRS Queues (ticket routing units with access control and assignment rules) map to Intercom Inboxes. Each OTRS queue name becomes an Intercom inbox name. OTRS queue-level SLA definitions become SLA rules attached to the corresponding Intercom inbox on the Expert plan. Queue assignment rules map to Intercom assignment rules within the inbox. We enumerate all queues during scoping and document the mapping; inboxes that have no direct equivalent are flagged for the customer's admin to configure pre-migration.

OTRS

User / Agent

maps to

Intercom

Teammate

1:1
Fully supported

OTRS Agent records map to Intercom Teammates. We resolve by email match. OTRS roles and group memberships do not have a direct Intercom equivalent; Intercom's permission model is Inbox-based rather than role-based. We document the OTRS role-to-inbox mapping for the admin to implement post-migration. Agents without an active Intercom account at migration time go into a reconciliation queue for admin provisioning.

OTRS

Attachment

maps to

Intercom

Conversation Part (File)

1:1
Fully supported

OTRS attachments are stored as binary blobs in the database linked to ticket articles. We extract each blob with its original filename and MIME type and import it as a file part on the corresponding Intercom conversation part. Attachments exceeding Intercom's file size limits are flagged for alternative storage and link-sharing. We preserve the original filename in the file metadata for agent reference.

OTRS

SLA Definition

maps to

Intercom

SLA Rule (Expert plan) or Conversation Tag

lossy
Fully supported

OTRS SLA definitions (response time, resolution time, calendar-linked escalation thresholds) have no direct Intercom equivalent at Essential or Advanced tiers. At Expert tier, Intercom offers SLA rules that can be attached to conversations. We map OTRS SLA names and urgency levels as tags on each conversation, with the SLA threshold time preserved as a custom timestamp attribute. The customer's admin configures formal SLA rules in Intercom's SLA settings post-migration if Expert plan is selected.

OTRS

Service Catalog

maps to

Intercom

Help Center Article

1:many
Mapping required

OTRS Services define available offerings linked to SLAs and queues. Service definitions migrate as Intercom Help Center articles or as custom attributes on Contacts representing service subscriptions. We export service names, descriptions, and SLA associations and map them to articles grouped by category in Intercom's Help Center. Service catalog ordering and customer-facing portal routing do not have a direct Intercom equivalent and are documented for admin rebuild.

OTRS

Configuration Item

maps to

Intercom

Company Custom Attribute or No Equivalent

1:1
Fully supported

OTRS Configuration Items (CMDB entries with class-based schema) have no direct Intercom equivalent. Intercom Companies are CRM records, not IT asset records. We map CI data to custom attributes on the Intercom Company record where the CI's affected customer maps to a Company. For CIs not associated with a customer (internal infrastructure records), we deliver a written CI inventory document for the customer's admin to evaluate Intercom's custom object options or a third-party CMDB integration. CI-to-Ticket linking is not reconstructable in Intercom without a custom integration.

OTRS

Process Management (Workflow)

maps to

Intercom

Workflow Builder (rebuild required)

lossy
Fully supported

OTRS Process Management stores workflow definitions as XML with activity nodes, transition rules, and conditional branching. These workflows do not migrate as functional code to Intercom's Workflow Builder because the action models are structurally incompatible. We export the workflow structure (states, transitions, responsible agents, and condition logic) as a written process inventory document. The customer's admin uses this document to rebuild equivalent automations in Intercom Workflow Builder or to implement a third-party workflow integration.

OTRS

Stats and Reports

maps to

Intercom

No Equivalent

lossy
Not supported

OTRS reporting stores report definitions and rendered output in the database. These are proprietary to OTRS and cannot be directly imported into Intercom's reporting. We deliver a written inventory of existing OTRS report definitions and their parameters so the customer's admin can rebuild equivalent reports in Intercom's reporting dashboard or connect to a BI tool for historical OTRS reporting.

Gotchas + challenges

What specifically takes care here

Platform-specific issues from each side, plus the pair-specific challenges that don't show up on either platform's page on its own.

OTRS logo

OTRS gotchas

High

Community Edition security freeze forces migration

Medium

Direct database export preferred over SOAP API

Medium

Major version upgrades can leave login broken

Intercom logo

Intercom gotchas

High

S3 JSON export omits conversation transcripts

High

Workspace isolation prevents workflow migration

Medium

Fin AI resolution fees compound with automation success

Medium

Two-year conversation history limit on historical export

Low

Private app rate limits share workspace quota

Pair-specific challenges

  • OTRS Process Management workflows have no Intercom equivalent

    OTRS Process Management stores multi-step workflows as XML with activity nodes, conditional branching, and transition rules. Intercom's Workflow Builder is action-based with triggers and downstream actions, not a process-state machine. Workflows with branching logic, multi-agent handoffs, or conditional escalation cannot be migrated as functional code. We export the workflow structure as a written inventory document listing each state, transition, condition, and responsible role. The customer's admin rebuilds these in Intercom Workflow Builder or selects a third-party workflow integration post-migration. This is a high-severity gotcha because teams that rely on Process Management for ITSM approvals or service requests face a gap in automated process coverage after cutover.

  • CMDB Configuration Items do not map to Intercom objects

    OTRS Configuration Items (CI records with class-based schemas for hardware, software, contracts, and services) have no Intercom equivalent. Intercom Companies are CRM contact groupings, not IT asset records. We can map CI data to custom attributes on the matching Intercom Company where a relationship exists, but orphaned CIs and CI-to-Ticket linking are not reconstructable without a custom integration. We document the full CI inventory, class schema, and linking table during scoping and deliver it as a written asset handoff. Teams requiring CMDB functionality post-migration must evaluate Intercom's custom object options or a third-party CMDB integration.

  • Intercom API rate limit governs batch sizing

    Intercom's API enforces 1,000 requests per minute, distributed as approximately 166 operations per 10-second window. Exceeding this limit returns an HTTP 429 response. We implement exponential backoff on 429 responses, batch chunking at 100 records per request for contact and conversation imports, and header-based rate-limit tracking to pause and resume within the window. Large migrations with high article-per-ticket density require additional batch sequencing. Active automated email campaigns in Intercom should be disabled before migration to free API capacity.

  • OTRS SLA definitions require manual rebuild in Intercom

    OTRS SLA objects (named response and resolution time definitions linked to queues and ticket types) have no direct Intercom equivalent at the Essential or Advanced plan. At the Expert plan, Intercom supports SLA rules on conversations, but the SLA definitions themselves must be manually recreated. We export OTRS SLA names, thresholds, and calendar associations as metadata tags on each migrated conversation so the urgency level is visible to agents even without formal SLA enforcement. The customer's admin configures formal SLA rules in Intercom's SLA settings if the Expert plan is in scope.

  • OTRS Community Edition security freeze may require emergency migration

    OTRS stopped releasing security patches for Community Edition after version 6. Organizations running Community Edition versions below 9 face a compliance and risk exposure problem that makes migration urgent rather than optional. We advise customers on unsupported OTRS versions to treat the migration as time-sensitive. We validate agent login immediately before database export because OTRS schema changes across versions can invalidate session tokens. We recommend a clean database export before any OTRS upgrade attempt to preserve a fallback state.

Migration approach

Six steps for a successful OTRS to Intercom data migration

  1. Discovery and OTRS version audit

    We audit the source OTRS instance by connecting to the MySQL or PostgreSQL database directly (coordinating with the customer's DBA for read-only access during a maintenance window). We enumerate ticket volume, article count, attachment blob size, Dynamic Field names and types, queue count, SLA definition count, and Process Management workflow XML files. We identify whether the OTRS version is Community Edition (with the security-patch freeze risk) or Business Solution. We also identify Configuration Item tables and the CI-to-Ticket linking table. The discovery output is a written migration scope document that defines the object mapping, a reconciliation row-count target for each object, and a list of requires-admin-decision items for queues, SLAs, and CMDB that lack direct Intercom equivalents.

  2. Intercom workspace pre-configuration

    We guide the customer's Intercom admin through pre-migration workspace setup: creating inboxes mapped from OTRS queues, defining custom attributes on Contacts mapped from OTRS Customer fields and Customer Dynamic Fields, configuring custom metadata fields on Conversations mapped from Ticket Dynamic Fields, and setting up team accounts for each OTRS Agent. We document the OTRS role-to-Intercom-inbox mapping during this step so that permissions are ready before production migration. If the customer is on the Essential or Advanced plan, we note that SLA rules require manual configuration post-migration using the SLA metadata tags we carry over.

  3. Schema enumeration and sandbox pass

    We enumerate all Dynamic Field names, types, and current values across the OTRS ticket and customer tables and generate the corresponding Intercom custom attribute and conversation metadata schema. We run a sandbox migration pass (into the customer's Intercom workspace or a test environment) using a 30-day snapshot of data to validate record counts, field mapping, attachment extraction, and conversation threading. The customer reconciles the sandbox output against the OTRS source and signs off before production migration begins. Any missing field mappings or schema corrections happen at this stage.

  4. Agent and user reconciliation

    We extract every distinct OTRS Agent email address and match against the Intercom workspace's teammate list. Agents without an active Intercom account are held in a reconciliation queue. The customer's admin provisions missing teammates and assigns them to inboxes before production migration. Migration cannot proceed past this step because conversation assignment and conversation part authorship both require a valid Intercom Teammate reference.

  5. Production migration in dependency order

    We run production migration in record-dependency order: Contacts (from OTRS Customers), Companies (if the customer uses OTRS company-linked customers), Conversations (from OTRS Tickets with article history as conversation parts), custom attributes (from OTRS Dynamic Fields), and file attachments (extracted from article blobs and reattached as conversation file parts). SLA metadata from OTRS SLA definitions is written as conversation tags and custom timestamp attributes. Each phase emits a row-count reconciliation report. We apply batch chunking at 100 records per request and exponential backoff on Intercom 429 responses.

  6. Cutover, delta migration, and workflow handoff

    We freeze OTRS write access during cutover, run a delta migration of any tickets or articles modified during the migration window, then mark Intercom as the system of record. We deliver the Process Management workflow inventory document (XML structure replayed as written states and transitions) and the CMDB Configuration Item inventory document to the customer's admin. We support a one-week hypercare window for reconciliation issues. We do not rebuild OTRS workflows in Intercom Workflow Builder, configure SLA rules (if Expert plan), or set up CMDB integrations as part of the standard migration scope; these are separate configuration engagements.

Platform deep dives

Context on both ends of the pair

OTRS logo

OTRS

Source

Strengths

  • Per-ticket Dynamic Fields allow unlimited custom properties without code changes.
  • Multi-channel inbound (email, portal, chat, phone) unified into a single ticket thread.
  • Role-based access control with granular queue, group, and permission scoping.
  • Built-in asset management (CMDB) with ticket-to-CI relationship tracking.
  • Process Management supports multi-step ITSM workflows with conditional branching.

Weaknesses

  • Community Edition receives no security updates, creating compliance risk on unsupported versions.
  • Database is normalized across many tables, making direct exports complex without schema knowledge.
  • No publicly documented API rate limits; direct database access is the reliable bulk export path.
  • Complex permission model (roles, groups, queues, users) is difficult to replicate exactly in simpler SaaS tools.
  • Self-hosted deployment requires dedicated server administration and Perl runtime maintenance.
Intercom logo

Intercom

Destination

Strengths

  • Integrated AI agent (Fin) for automated resolution with per-resolution billing that rewards high automation rates.
  • Multi-channel inbox consolidating live chat, email, SMS, WhatsApp, and Phone into a single threaded view.
  • Native help center with articles, collections, and self-service deflection capabilities.
  • Workflow automation for routing, qualification, and proactive outbound messaging across channels.
  • Strong API ecosystem with 10,000 req/min rate limits for private apps enabling high-throughput migration pipelines.

Weaknesses

  • Pricing model compounds with seat count, AI resolution fees, channel costs, and multiple add-ons, making total cost hard to predict.
  • Workspace-level isolation prevents moving workflows or content between environments, requiring manual rebuilds.
  • S3 JSON export deliberately excludes conversation transcripts, necessitating REST API calls for full message history.
  • Outages are reported as frequent enough to be a concern for always-on support operations.
  • Setup complexity means teams often require internal guidance or professional services to configure bots and automation correctly.

Complexity grading

How hard is this migration?

Standard Helpdesk migration. 2 of 7 objects need a mapping; the rest are 1:1.

B

Overall complexity

Standard migration

Derived from compatibility, mapping clarity, API constraints, and data volume across OTRS and Intercom.

  • Object compatibility

    B

    2 of 7 objects need a mapping; the rest are 1:1.

  • Field mapping clarity

    C

    Field mapping is derived from defaults — final spec confirmed during the sample migration.

  • Timeline complexity

    B

    7-object category — typical timelines run 2–7 days end-to-end.

  • API constraints

    B

    OTRS: Not publicly documented; no published rate limit values.

  • Data volume sensitivity

    B

    OTRS doesn't expose a bulk API — REST + parallelization used for high-volume runs.

Estimator

Estimate your OTRS to Intercom migration cost

Rule-based pricing — no per-record fees, no manual quotes. Migrations over 2M records are scoped individually.

Step 1

What are you migrating?

Pick a category, then your source and destination platforms.

Category

FAQ

Frequently asked questions about OTRS to Intercom data migrations

Answers to the questions buyers ask most during OTRS to Intercom migration scoping. Not seeing yours? Book a call.

Can't find your answer?

Walk through your OTRS to Intercom migration with a real engineer — 30 minutes, free, written quote within 24 hours.

Book a free 30 minute consultation

Most migrations land between two and four weeks for accounts under 15,000 tickets with fewer than 20 Dynamic Fields and no CMDB records requiring mapping. Migrations with large article attachment blobs (over 50 GB), CMDB Configuration Item mapping to Intercom Companies, or Process Management workflow inventory documentation move to four to eight weeks because of the multi-pass schema enumeration, blob extraction, and workflow handoff documentation. Intercom's API rate limit (1,000 requests per minute) also governs batch sequencing for large record sets.

Adjacent paths

Related migrations to explore

Ready when you are

Move from OTRS.
Land in Intercom, intact.

Tell us record counts and timeline. We'll come back with a written quote inside 1 business day — no commitment, no sales pitch.

Accuracy guarantee Rollback included Quote in 1 business day