Intercom to Helpscout - Docs Migrator
This is a simple Node script to migrate an Intercom Articles site over to Helpscout Docs. It does the following:
- Migrates Intercom collections to Helpscout categories
- Migrates all images from your Intercom articles to Helpscout
- Migrates all your articles from Intercom to Helpscout
- Adds a redirect for the hold Intercom URL to your new Helpscout URL
How to use
To run the script, clone this repository and then update the
config.js file with your own settings.
intercomSite- A link to your support site homepage on Intercom (no trailing slash)
helpscoutKey- Your Helpscout docs API key
collectionId- Your Helpscout collection ID (you need to make the collection via the Helpscout admin panel)
siteId- Your Helpscout docs site ID (for redirects)
Then create an empty directory called
images. This is used to store your Intercom images for upload.
To run the script:
For a site with about 100 docs, it takes roughly an hour.
Issues & Warranty
We're offering this migration tool with no support or warranty. We used it for our own migration, but we haven't done testing beyond that. It may break if Intercom change the class selectors we rely on.
Feel free to submit PRs/issues against this repository. We welcome PRs, we may not fix issues.
Raisely powers online fundraising for ambitious campaigns. We help charities raise money online through simple, easy to use fundraising websites. Love to code but want to work on projects that improve the wellbeing or people and planet? Get in touch.