Helpdesk migration
Field-level mapping, validation, and rollback between Tidio and Intercom. We move data and schema; workflows are rebuilt natively in Intercom.
Tidio
Source
Intercom
Destination
Compatibility
9 of 12
objects map 1:1 between Tidio and Intercom.
Complexity
BStandard
Timeline
3-5 weeks
Overview
Tidio and Intercom use different data architectures, and bridging them requires explicit decisions at every object boundary. Tidio stores contacts, tags, and custom properties in a flat workspace model; Intercom uses a nested Contact model with associated conversation Parts, topics, and data attributes. We resolve the Contact-to-Contact mapping, import conversation threads as Intercom conversation Parts (preserving channel origin from Tidio's email, chat, WhatsApp, Messenger, and Instagram sources), and carry forward tags as contact labels. We cannot transfer Tidio Flows (the visual chatbot automations) or Lyro AI knowledge bases—there is no export API for either. We document them as structured manifests so your team can rebuild them manually in Intercom's Workflow builder. Conversation quotas, Lyro limits, and Flow visitor caps do not migrate because they are billing artifacts, not data. We flag these gaps explicitly in the scope so there are no surprises after cutover.
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 Tidio 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.
Tidio
Contact
Intercom
Contact
1:1Tidio Contacts (name, email, phone, location, and all custom contact properties) map directly to Intercom Contacts. We extract standard fields and custom properties, then create corresponding Intercom data attributes under Settings > Contact data. Tags attached to Tidio contacts migrate as Intercom contact labels. Email addresses serve as the dedupe key—if a contact with the same email already exists in Intercom, we skip the insert and flag the duplicate for the customer's admin to resolve.
Tidio
Conversation
Intercom
Conversation (with Parts)
1:1Tidio conversation threads become Intercom conversation records with individual messages as Parts. Channel origin (email, chat, WhatsApp, Messenger, Instagram) maps to the Intercom Part source attribute. Agent assignment migrates by resolving the Tidio agent email to an Intercom admin or agent user. Pre-chat and offline messages are preserved as separate Parts with the same thread identifier. Historical timestamps are preserved on each Part so the original conversation ordering is intact.
Tidio
Tag
Intercom
Contact Label
1:1Tidio tags are flat string labels applied to contacts. We export the complete tag list and create corresponding Intercom contact labels. Label creation is part of the migration payload and does not require manual entry. If a contact in Tidio has multiple tags, each tag becomes a separate label on the Intercom contact.
Tidio
Channel
Intercom
Channel / Inbox routing
1:1Tidio channel configuration (email addresses, WhatsApp number, Messenger page, Instagram account) includes platform-specific tokens and webhook URLs. We document which channels were active in Tidio and map them to the equivalent Intercom inbox or channel connection. Each Tidio email-address-based channel maps to a corresponding Intercom team inbox. Social channels (WhatsApp, Messenger, Instagram) require re-authorization at Intercom and are documented in the channel manifest so the admin knows which connections to re-establish.
Tidio
Flows (Chatbot Automations)
Intercom
Workflow
lossyTidio Flows cannot be exported via API—no public endpoint exposes Flow logic or trigger conditions. We enumerate all active Flows by name, trigger type (visitor action, keyword, time on page), and block count, and produce a structured JSON manifest so the customer's Intercom admin or partner can rebuild them in Intercom's Workflow builder. Flows are the most common source of migration surprises for Tidio customers; we surface this gap in the scoping call before any data moves.
Tidio
Lyro AI Knowledge Bases
Intercom
Fin AI Agent Knowledge Base
lossyLyro AI knowledge bases (Q&A pairs, imported Help Center articles, Shopify product feeds, web page crawls) live in Tidio's proprietary infrastructure with no export API. We document which data sources were connected to Lyro and their last sync dates so the admin knows what content to re-upload and retrain in Intercom's Fin AI Agent knowledge base. This is manual work outside the migration scope.
Tidio
Lyro Conversations
Intercom
Conversation history (N/A)
1:1Lyro conversation logs (AI-to-customer interaction records) are not accessible via Tidio API and cannot be migrated. We flag the existence of these records in the scope and document the date range so the admin understands what AI conversation analytics will not be available post-migration. Tidio conversation analytics do not include Lyro-specific data.
Tidio
Custom Contact Properties
Intercom
Contact Data Attributes
1:1Standard Tidio contact properties (name, email, phone, location) map to Intercom's built-in contact attributes. Custom contact properties use Tidio-specific field names and types that require creation of corresponding Intercom data attributes before migration. We flag any Tidio property that uses a type (date, number, URL, checkbox) that Intercom stores as string and document the type decision during scoping.
Tidio
Agent
Intercom
Admin or Agent
1:1Tidio agent records (name, email, role) map to Intercom admin or agent users. On Tidio Starter plans, every user is an admin by default with no role-based access control. We detect which Tidio plan was in use and flag any permission gaps when mapping to Intercom, which has a more granular admin, agent, and viewer role model on Advanced and Expert.
Tidio
Department
Intercom
Team
1:1Tidio departments (available on Plus tier only) map to Intercom Teams. Agent-to-department assignments and routing rules export as structured data. Tidio Starter and Growth accounts that did not use departments will have no corresponding structure in Intercom and will route all conversations to the default team inbox unless routing rules are configured post-migration.
Tidio
Macro
Intercom
Saved Content
1:1Tidio macros are pre-written response templates with variable placeholders. There is no export mechanism for macros as reusable templates. We list all macro names and full content as a structured document so the admin can create equivalent Saved Content in Intercom manually. Variable placeholders in Tidio (e.g., {{customer_name}}) will need to be recreated using Intercom's variable syntax.
Tidio
Operating Hours
Intercom
Working Hours
lossyTidio operating hours are configured per-channel and control when automated replies fire. We export the configured hours as structured data (day of week, start time, end time, timezone per channel) so they can be re-entered in Intercom under Settings > Working hours. If no operating hours were configured in Tidio, Intercom will assume 24/7 availability by default.
| Tidio | Intercom | Compatibility | |
|---|---|---|---|
| Contact | Contact1:1 | Fully supported | |
| Conversation | Conversation (with Parts)1:1 | Fully supported | |
| Tag | Contact Label1:1 | Fully supported | |
| Channel | Channel / Inbox routing1:1 | Fully supported | |
| Flows (Chatbot Automations) | Workflowlossy | Mapping required | |
| Lyro AI Knowledge Bases | Fin AI Agent Knowledge Baselossy | Not supported | |
| Lyro Conversations | Conversation history (N/A)1:1 | Not supported | |
| Custom Contact Properties | Contact Data Attributes1:1 | Fully supported | |
| Agent | Admin or Agent1:1 | Fully supported | |
| Department | Team1:1 | Fully supported | |
| Macro | Saved Content1:1 | Fully supported | |
| Operating Hours | Working Hourslossy | 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.
Tidio gotchas
Conversation and Lyro quotas reset monthly without rollover
Flows cannot be exported — only documented as a manifest
Lyro AI knowledge and conversation logs are not portable
Chat history requires manual export by agents
Agent limits and department routing are plan-gated
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 scoping call
We audit the Tidio workspace: plan tier (Starter/Growth/Plus), agent count, active conversations within a defined date window, custom contact properties, active Flows by name and trigger, connected Lyro data sources, tag inventory, and department/routing configuration. We pair this with an Intercom workspace audit to identify any pre-existing contacts or configurations that could create duplicates. The discovery output is a written migration scope that itemizes what migrates automatically, what requires manual configuration post-migration, and what cannot migrate at all. We review the Flow manifest and Lyro documentation items as separate scope items so the customer understands the rebuild work before committing.
Credential handoff and conversation export
We coordinate a credential handoff window where the Tidio admin provides OpenAPI access (or grants temporary OpenAPI via Plus plan if needed) and we authenticate to the Tidio API. We export all conversations within the agreed date range, preserving channel origin, agent assignment, timestamps, and message content as a structured JSON bundle. We export contacts and custom properties in parallel as a separate JSON bundle. We extract tags and apply them as contact labels in the contact export. This step runs before any Intercom import begins so that the data bundle is complete and validated.
Intercom data attribute and workspace preparation
We configure Intercom before importing any data. This includes creating custom data attributes to match Tidio custom contact properties (field names, types, and visibility settings), setting up team inboxes for each Tidio channel (email, WhatsApp, Messenger, Instagram), configuring working hours to match Tidio operating hours per channel, and creating Intercom contact labels to match the exported Tidio tag list. We create Intercom admin and agent user accounts to match the Tidio agent roster, with role assignments aligned to the Tidio plan's permission structure where available.
Sandbox migration and reconciliation
We run a full migration into an Intercom workspace using a subset of records (typically 50-100 contacts and 200-500 conversations) to validate the mapping. The customer's support team lead spot-checks records against the Tidio source: contact fields match, conversation threads are intact with correct ordering, tags appear as labels, and channel origins are preserved. We correct any mapping errors in this phase before running the production migration. This step also surfaces any Tidio data quality issues (duplicate contacts, missing emails, incomplete conversation threads) that need customer admin resolution before full cutover.
Production migration in dependency order
We run production migration in phases: (1) Intercom users provisioned and validated, (2) contacts with custom properties and tags imported, (3) conversation history imported as Part threads attached to contacts, (4) channel routing documented for admin re-authorization, and (5) operating hours re-entered by the admin using our structured export. Each phase emits a row-count reconciliation report. We freeze Tidio writes during the cutover window (typically 2-4 hours) and run a final delta migration of any records modified during that window before switching the live chat widget to Intercom.
Cutover, validation, and Flow rebuild handoff
We switch the live chat widget embed code to Intercom and validate that new conversations route to the correct Intercom inbox and team. We deliver the Flow manifest (JSON listing every Tidio Flow by name, trigger, and step count) and the Lyro data source documentation (listing every connected Help Center, Shopify feed, and web page crawl) to the customer's admin team. We support a 72-hour hypercare window for reconciliation issues. We do not rebuild Tidio Flows as Intercom Workflows inside the migration scope; that work is documented separately for the admin or an Intercom partner to execute.
Platform deep dives
Tidio
Source
Strengths
Weaknesses
Intercom
Destination
Strengths
Weaknesses
Complexity grading
Standard Helpdesk migration. 2 of 7 objects need a mapping; the rest are 1:1.
Overall complexity
Standard migration
Derived from compatibility, mapping clarity, API constraints, and data volume across Tidio and Intercom.
Object compatibility
2 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
Tidio: Not publicly documented on Tidio's developer portal; a rate limiting document exists but specific per-endpoint limits are not published..
Data volume sensitivity
Tidio 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 Tidio to Intercom migration scoping. Not seeing yours? Book a call.
Walk through your Tidio 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 Tidio
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.