On this page

Intercom Airdrop

The Intercom Airdrop simplifies migration from Intercom to DevRev, supporting both one-time imports and ongoing syncs.

Supported Objects

The following is a list of Intercom objects and their corresponding DevRev equivalents. Those marked as Sync to DevRev are eligible for import from Intercom to DevRev.

Intercom ObjectDevRev ObjectSync to DevRev
ConversationsConversations
Conversation Parts (comments)Conversation comments
TagsTags
Attachment in conversation/commentsAttachment in conversation/comments
AdminsDevUser
CompaniesAccounts
ContactsContacts
CollectionsCollections
ArticlesArticles
Attachment in ArticlesAttachment in Articles

Connect to Intercom

To configure the Intercom connection, there are two ways to create it: using an OAuth connection or an API key.

Import from Intercom

Follow the steps below to import from Intercom:

  1. Go to Marketplace and search for Intercom in the Airdrop category and install it.
  2. In the snap-in config modal, click Install.
  3. In the snap-in config, turn ON the toggle to Import all conversations as per requirement. If enabled, both open and closed conversations are imported; otherwise, only closed conversations are imported.
  4. (Optional) Provide a contact reference ID. You can specify any custom contact field name to use as the reference ID for a contact in DevRev. If not provided, the reference ID from the Intercom's contact is used.
  5. Go to the Airdrop section in your settings left navigation.
  6. Click +Import and select the Intercom logo.
  7. Create a new connection to your Intercom account, or use an existing connection if you already have one.
  8. Once the connection is established, select the Intercom account you want to import and specify the DevRev part that should be used for any imported work (future releases will make use of this). This initiates a bulk import of the selected site.
  9. DevRev makes an effort to automatically map the fields from Intercom to the corresponding fields in DevRev. However, you may be prompted to manually map certain fields if needed.

The duration of the import depends on the size of the Intercom conversations and the data being imported. It can take seconds for an account with only a few dozen conversations or a few hours for an account with tens of thousands of conversations and many attachments. DevRev honors the Intercom API rate limits and automatically handles back-off and resumption.

Post-Import Options

After a successful import, you have the following options available for the imported account:

  • Sync to DevRev
    This option allows you to synchronize any modifications made in Intercom with the corresponding items previously imported into DevRev. It also creates new items in DevRev for any new modification in items of Intercom after the last sync or import.

  • View Report
    This option allows you to access detailed information about the initial import and any subsequent syncs performed.

  • Delete Import
    If you wish to remove the import and all items that were imported from Intercom into DevRev, you can use this option.

  • Edit Connection
    Use this option to change the connection used for any subsequent actions. It can be helpful if a connection becomes inactive or the user who established it is no longer available.

Sync to DevRev

After a successful import from an Intercom account, you can choose to sync the imported data with DevRev. This feature imports any new data and applies any changes made to previously imported items from Intercom.

To perform a one-time sync to DevRev, follow these steps:

  1. Go to Settings > Integrations > Airdrops.
  2. Locate the previously imported project.
  3. Select the ⇆ > ⇾ From Intercom to DevRev option.
icon

A one-time sync may overwrite fields in previously imported items, even if they were modified in DevRev.