Migrating to HumanTouchCX

This guide walks you through switching your customer support to HumanTouchCX from another platform. The process typically takes an hour or two for a small team. Larger teams with a long ticket history should set aside a day to import historical data and run both platforms in parallel before fully cutting over.

Before you start

A smooth migration depends on having a few things ready before you touch any settings. Work through this list first:

  • Know your support email address. This is the address your customers email today (e.g. [email protected] or [email protected]). You will redirect it to HumanTouchCX.
  • Check admin access. You need admin access to your current helpdesk to export data and deactivate it. You also need access to your email provider (Gmail, Outlook, etc.) to update forwarding.
  • Decide on your history import. HumanTouchCX can import your historical tickets via CSV upload or a direct platform connection (Gorgias and Zendesk). Either way, export a copy from your old platform first as a backup and as the source file for the import. See Import your ticket history and the platform-specific sections below.
  • Pick a go-live date. Avoid migrating during a peak support period. Give yourself a day of overlap where both systems are active so no ticket falls through the cracks.
  • Tell your team. Let agents know the switch is coming, when it is happening, and where to find the new dashboard.

Set up HumanTouchCX

Before you redirect any email or remove your old widget, get HumanTouchCX fully configured so it is ready to receive real traffic.

  1. Install the app. Find HumanTouchCX in the Shopify App Store and click Install. Complete the onboarding screens to set your support email address and display name.
  2. Invite your team. Go to Team and invite each agent. Set their roles before go-live so permissions are correct from day one.
  3. Configure your widget. Go to Settings → Widget and customise the appearance, greeting, and working hours to match what your customers expect. See Installing the Widget for full instructions.
  4. Set up email forwarding. Go to Settings → Email to find your unique HumanTouchCX inbound address, then forward your support email address to it. Full steps for every provider are in the Email Forwarding Setup guide.
  5. Set your working hours. Go to Settings → Working Hoursand enter the hours your team is available. This controls the widget's online and offline states.
  6. Add canned responses. If your old platform had saved replies or macros you use frequently, recreate the most important ones in Settings → Canned Responses before go-live.

Import your ticket history

HumanTouchCX can bring your historical tickets in from another platform using two methods. Both are in your dashboard under Settings → Data.

CSV import (any platform)

Export a CSV from your current helpdesk, upload it in HumanTouchCX, and map the columns to HumanTouchCX fields. The only required column is customer_email. Optional fields include subject, status, created date, message body, tags, and assignee email.

File size limit is 4 MB (roughly 25,000 tickets). For larger histories, use Connect Platform below.

  1. Export a CSV from your current platform (see the platform-specific sections below for export steps).
  2. In the HumanTouchCX dashboard, go to Settings → Data → Import.
  3. Drag and drop your CSV or click to browse. HumanTouchCX reads the headers and shows a column preview automatically.
  4. Map each CSV column to the corresponding HumanTouchCX field. Obvious column names (like customer_email or subject) are auto-matched.
  5. Click Start Import. A progress bar tracks imported and skipped tickets. When complete, a link takes you straight to the imported tickets in your inbox.

Connect Platform (Gorgias and Zendesk)

For Gorgias and Zendesk, you can connect directly via API and pull your full ticket history including complete message threads. No CSV export needed, and no file size limit.

  1. Go to Settings → Data → Connect Platform.
  2. Select your platform and enter your credentials. For Gorgias: your subdomain, email, and API key (find it in Gorgias under Settings → REST API). For Zendesk: your subdomain, admin email, and API token (find it under Admin → Channels → API).
  3. Click Test Connection. HumanTouchCX verifies your credentials and shows a preview of your ticket count.
  4. Click Start Import. The job runs in the background so you can close the page and check progress under Settings → Data → History.

Import jobs are resumable. If the connection drops, the job picks up where it left off rather than starting over.

Migrating from Gorgias

Import your ticket history

The easiest option is Connect Platform under Settings → Data, which pulls your full Gorgias history via API with complete message threading and no file size limit. See Import your ticket history above for steps.

To export a CSV as a backup or for use with the CSV importer instead:

  1. In Gorgias, go to Settings → Data & Privacy.
  2. Click Export data, select Tickets, and choose a date range. Gorgias will email you a download link when the export is ready.
  3. Upload the CSV in HumanTouchCX under Settings → Data → Import and map the columns.

Switch email

Gorgias connects to your support inbox by adding itself as a forwarding destination. Once HumanTouchCX email forwarding is active, remove the Gorgias forwarding rule from your email provider to avoid messages going to both platforms.

Remove the Gorgias widget

If you have the Gorgias live chat widget installed, remove it from your theme before enabling the HumanTouchCX widget:

  1. In Shopify admin, go to Online Store → Themes and click Customize on your live theme.
  2. Find the Gorgias app embed in the App Embeds section of the theme editor sidebar and toggle it off.
  3. Save the theme. Then enable the HumanTouchCX widget in App Embeds in the same panel.

Cancel Gorgias

Once you have confirmed email is flowing into HumanTouchCX and the new widget is live, cancel your Gorgias subscription from Settings → Billing in Gorgias.

Migrating from Zendesk

Import your ticket history

Like Gorgias, Zendesk supports Connect Platform for a direct API import of your full ticket history including message threads. See Import your ticket history above for steps.

To export a CSV as a backup or for use with the CSV importer:

  1. In Zendesk, go to Admin Center → Account → Tools → Reports.
  2. Under Export, select Tickets (CSV). For larger volumes, use the Full export (JSON) option instead.
  3. Zendesk will email you when the file is ready. Upload the CSV in HumanTouchCX under Settings → Data → Import and map the columns.

Switch email

Zendesk typically adds itself as your MX record or uses email forwarding. Either way, the change is made at your email provider or DNS level:

  • If you forwarded to Zendesk: Update the forwarding rule in your email provider to point to your HumanTouchCX inbound address instead.
  • If Zendesk is your MX record: Update the MX record with your domain registrar or DNS provider to route mail back to your original email provider, then set up forwarding from there to HumanTouchCX. DNS changes can take up to 48 hours to propagate, so plan accordingly.

Remove the Zendesk widget

The Zendesk Web Widget is usually added via a JavaScript snippet in your theme. Remove it from Online Store → Themes → Edit code → theme.liquid (look for a script tag referencing static.zdassets.com). Delete that snippet, save, and then enable the HumanTouchCX widget.

Cancel Zendesk

Cancel from Admin Center → Account → Billing → Subscription. Zendesk requires a billing period to run out on some plans, so check your terms before you expect the charge to stop.

Migrating from Re:amaze

Export and import your ticket history

Export your conversations as a CSV from Re:amaze, then import them into HumanTouchCX using the CSV importer (Settings → Data → Import).

  1. In Re:amaze, go to Settings → Account → Data Export.
  2. Request a Conversations export. Re:amaze will email you a download link.
  3. Upload the CSV in HumanTouchCX under Settings → Data → Import and map the columns.

Switch email

Re:amaze uses email channel integrations. Go to Settings → Channels, find your email channel, and note the forwarding address it is using. Then update your email provider to forward to your HumanTouchCX inbound address instead, and remove the Re:amaze channel.

Remove the Re:amaze widget

Re:amaze provides a Shopify app that installs their widget as an app embed. In Shopify, go to Online Store → Themes → Customize → App Embeds and toggle off the Re:amaze embed. Then toggle on HumanTouchCX.

Cancel Re:amaze

Go to Settings → Billing in Re:amaze and downgrade or cancel your plan.

Migrating from Freshdesk

Export and import your ticket history

Export your tickets as a CSV from Freshdesk, then bring them into HumanTouchCX using the CSV importer.

  1. In Freshdesk, go to Admin → Account → Export Data.
  2. Select Tickets and choose a date range. Freshdesk will email you a CSV when the export is complete.
  3. Upload the CSV in HumanTouchCX under Settings → Data → Import and map the columns.

Switch email

Freshdesk creates a forwarding rule in your email provider when you connect an inbox. Find that rule in your email provider's settings and update it to forward to your HumanTouchCX inbound address. Then deactivate the Freshdesk email channel from Admin → Email.

Remove the Freshdesk widget

If you are using the Freshdesk Freshchat widget, remove the script snippet from your theme (look for a reference to wchat.freshchat.com in theme.liquid). Save the theme, then enable the HumanTouchCX widget.

Cancel Freshdesk

Cancel from Admin → Account → Billing in Freshdesk.

Migrating from Gmail / shared inbox

Many Shopify merchants manage support from a shared Gmail inbox or a Google Workspace account with a few people on the same login. This is the simplest migration because there is no old platform to deactivate , just a forwarding rule to set up.

Set up forwarding

Follow the Gmail instructions in the Email Forwarding guide. If multiple team members share a single inbox login today, each person should create their own HumanTouchCX account, because the shared login approach does not give you per-agent visibility into who replied to what.

Keep Gmail as a backup

During the first week, keep Gmail forwarding set to Keep a copy in Inbox. This means emails land in both places and nothing is lost if you need to check something in the old inbox. Once you are comfortable, switch Gmail to Archive Gmail's copy to stop the duplicate.

Add the widget

If you previously had no live chat widget, this is a good time to enable one. Go to Installing the Widget for setup instructions.

Archive your Gmail history

Gmail doesn't export a ticket-style CSV, so direct import into HumanTouchCX isn't available for Gmail history. Use Google Takeout (takeout.google.com) to download an MBOX archive for your records. Your full Shopify order and customer context is available in HumanTouchCX from day one, so agents have what they need without the old thread history.

Onboard your team

The biggest friction in any migration is not the technology. It is getting your team comfortable in a new tool. A few things that help:

  • Invite everyone before go-live. Agents should log in, explore the inbox, and send a test reply at least a day before real tickets start arriving.
  • Set up profiles. Each agent should set their display name and photo in Your Profile. Customers see this on every reply.
  • Review canned responses together. If your team relied heavily on saved replies in the old platform, recreate the top 10 in HumanTouchCX before go-live so no one is hunting for them under pressure.
  • Walk through the inbox together. Do a 15-minute walkthrough on a screen share so everyone sees how to open a ticket, reply, assign, and close. The Using the Inbox guide covers each of these steps.
  • Keep a Slack/Teams channel open. During the first week, have a channel where agents can ask quick questions without slowing down their queue.

Go-live checklist

Run through this list on the day you switch over. Tick each item before you close your old platform.

  • HumanTouchCX installed and onboarding complete
  • All agents invited and logged in
  • Agent profiles set (name, photo)
  • Widget enabled and visible on storefront
  • Old widget removed from theme
  • Email forwarding pointing to HumanTouchCX inbound address
  • Test email sent and confirmed as a ticket in the inbox
  • Working hours configured
  • Canned responses recreated
  • Ticket history imported (or exported and stored as a backup)
  • Old platform set to forward or hold (not yet cancelled)
  • Team briefed on go-live time

After 48 hours of smooth operation, cancel your old platform subscription.

What doesn't carry over

Here is what requires manual rebuilding or will not transfer automatically:

  • Ticket history from Re:amaze, Freshdesk, and Gmail. Gorgias and Zendesk support a full direct import via Connect Platform. Re:amaze and Freshdesk can be imported via CSV, though the message body is typically a single text block rather than a full threaded conversation. Gmail history cannot be imported directly.
  • Canned responses and macros. Recreate the ones you use regularly in Settings → Canned Responses.
  • Tags and ticket categories. HumanTouchCX uses its own tagging system. Any tags from your old platform will not transfer automatically, though CSV imports do support a tags column.
  • Contact / customer profiles. HumanTouchCX pulls customer context directly from Shopify order data, so you will not lose visibility into your customers, you just will not have a history of their old tickets unless you run an import.
  • Automations and rules. Complex routing rules or trigger-based automations from your old platform will need to be reviewed and recreated where HumanTouchCX offers equivalent settings.

If any of this is a concern for your migration, email [email protected] before you start and we can talk through your specific setup.