Making the switch from Intercom to Enchant is a significant step toward a more streamlined and shared inbox experience.
While Intercom offers a wide array of tools for marketing and engagement, Enchant focuses on providing a clean, omnichannel environment for support teams.
To ensure your transition is smooth, you need a clear roadmap that respects the data models of both platforms.
Define Your Migration Scope
Before you write a single line of code, you must decide what stays and what goes. Most of your core support data will move through the API.
This includes your teammates, known as Admins in Intercom, and your customer database, which includes both Users and Leads.
Your conversation history, including the individual replies and internal notes, along with any relevant tags and file attachments, is also a perfect candidate for API migration.
Some elements require a bit more hands-on attention. Help center content, such as Articles and Collections, does not have a direct 1:1 API path in the current documentation and should be recreated manually within Enchant to ensure the formatting remains intact.
Similarly, since Enchant does not have a dedicated Company object or a Segment API, you will handle these via manual workarounds or custom fields during the process.
Any marketing campaign data or transient visitor sessions that are no longer relevant should be archived in Intercom for your records rather than imported into your new live environment.
Prepare Enchant for Data Import
Preparation is the secret to a successful import. You cannot simply dump data into a blank slate.
First, you must install the API app within your Enchant settings to generate the necessary access tokens. This token is your key to the system and should be treated with the same level of security as a password.
Next, you need to define your communication channels. In Enchant, every ticket must belong to an inbox. You should set up your inboxes to match your current support structure, whether that is organized by email, chat, or social media.
This is also the best time to recreate your organizational structure by defining your labels. Since Intercom tags will become Enchant labels, having those labels ready in the system ensures they attach correctly when the data arrives.
Migrate Objects
The order in which you move your data is vital because certain objects depend on others to exist first. The logical sequence begins with your team.
- Admins: Your first step is migrating your Intercom Admins into Enchant as Users. These are the people who will be answering the tickets.
By creating them first, you ensure that when you later import conversation history, you can accurately assign those conversations to the right person. - Contacts: Intercom differentiates between Leads and Users, but in Enchant, these are consolidated into Customer records.
You will map the names and contact information, such as email addresses or phone numbers, into the Enchant Customer model.
This creates the necessary identity that every ticket will eventually be linked to. - Companies and Segments: Because there is no direct Company object in the Enchant sources, you must use a clever workaround.
You can take the company details from Intercom and patch them into the summary field of the relevant Customer record. This keeps the company context visible for your agents.
For Segments, the best approach is to use labels. You can manually apply specific labels to customers or tickets that belonged to a segment in Intercom to maintain that categorization. - Attachments: Before moving messages, you must handle the files. Attachments in Enchant are a two-step process.
You have to upload the file data first to receive a unique identifier. This identifier is then used in the next step when you create the actual message. - Conversations and Messages: This is the heart of your data. Intercom Conversations or Tickets map directly to Enchant Tickets.
Each ticket acts as a container for the history of that interaction. Within those tickets, you will migrate Intercom's conversation parts and notes as Enchant Messages
It is essential to distinguish between a note, which is internal, and a reply, which is customer-facing.
You must also pay close attention to the direction of the message to ensure that inbound customer replies and outbound agent responses are displayed in the correct order.
Post Migration Configuration
Once the data is residing in its new home, you need to rebuild the logic that makes your help desk run. Intercom's automated workflows, such as bots or assignment rules, do not migrate through the API.
You will need to manually set up Enchant's internal automation to handle ticket routing and auto replies.
This is also the time to verify your help center. After manually moving your Articles and Collections, check that all internal links are functioning and that the content is organized in a way that is easy for your customers to navigate.
Finally, double-check your team's permissions to ensure everyone has access to the correct inboxes and labels.
Insider Secrets
One of the most important things to watch is the rate limit. Enchant allows 100 credits per minute. If you try to push your entire history at once, the system will pause your requests. A smart way to manage this is to use embedding when you fetch data.
By embedding labels or customer details within a single request, you reduce the number of round trips and save your credits for the actual data creation.
Another crucial tip involves file data. When you migrate attachments, you must convert the Intercom files into Base64 encoded strings before sending them over.
If you skip this step, the files will not upload correctly. Also, remember that a file ID in Enchant can only be associated with one single message.
If you have a file that was used multiple times in Intercom, you will need to upload it and get a new ID for each message it appears in.
Summary
Migrating from Intercom to Enchant is a process of refinement. By moving your team and customers first, followed by attachments and then the conversation history, you maintain a clear and logical data trail.
While some elements like companies and help center articles require manual intervention or creative workarounds, the result is a clean and highly organized support system.
Take your time with the preparation and respect the sequence, and your team will be up and running in their new inbox without losing a single piece of valuable customer context.
If you’d rather focus on your revenue instead of wrestling with mapping sheets and pagination loops, ClonePartner can handle the full migration for you. Every project gets a dedicated engineer who understands the nuances of both APIs and ensures zero downtime.