https://github.com/gma/intercom-dump
Download your data from your Intercom account
https://github.com/gma/intercom-dump
customer-support intercom
Last synced: 6 months ago
JSON representation
Download your data from your Intercom account
- Host: GitHub
- URL: https://github.com/gma/intercom-dump
- Owner: gma
- Created: 2022-09-30T13:15:45.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2022-09-30T13:18:07.000Z (about 3 years ago)
- Last Synced: 2025-02-01T14:31:40.368Z (8 months ago)
- Topics: customer-support, intercom
- Language: Ruby
- Size: 2.93 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Intercom Dump
=============
This is a quick script that I knocked up to extract all the messages stored in an account on [Intercom]. It's useful if you're moving away from Intercom and want to keep a copy of your data.
[Intercom]: https://intercom.com
Install
-------
To setup the Docker image run:
$ docker-compose build
Then add your [Intercom access token] to the `.env.secrets` file:
$ vi .env.secrets
It only needs to contain one line. Make it look like this:
ACCESS_TOKEN=
Finally, run the script to download all the data from your account:
$ docker-compose run --rm intercom ruby dump.rb
You should then find that the script starts retrieving data from the Intercom API, and storing the raw JSON that their API returns in files inside a folder called `./intercom-dump`.
At this point, **protect your customers' data by removing `.env.secrets`**.
I also recommend you **encrypt the `./intercom-dump` folder immediately**. Use a strong encryption tool such as PGP (or GnuPG). Can't be bothered? What happens if you should lose your computer, with all your customers' contact details, geographic locations, etc on it? It doesn't bear thinking about, right?
And please don't run this on any computers whose filesystems aren't encrypted with strong encryption. You can't securely delete a file from an SSD drive, so if you save one of these JSON files containing customer data to such a disk, the only way you'll be able to reliably destroy the data is to destroy the drive.
[Intercom access token]: https://developers.intercom.com/building-apps/docs/authorization