- Calculated Property
IntercomLast Updated: 2022-01-03
Grouparoo's Intercom Integration enables you to export contacts and tags to Intercom.
Intercom is a messaging platform for customer communications. You can use Intercom to stay in touch with customers. Grouparoo can help you to sync data from your warehouse to Intercom easily.
|Destination Name||Destination Description|
|Intercom Export Contacts||This Destination exports Grouparoo Records to Contacts in an Intercom account.|
You will need an Intercom account and an access token to sync data to Intercom.
To find your access tokens, or create a new one, visit the Intercom Developer Hub and navigate to Your Apps. Choose an existing app or add a new one with internal integration (this means you are not publishing your app to the marketplace). From here, you should be able to copy an access token from the Authentication page for setting up your Intercom App in the Grouparoo UI.
To connect Intercom to Grouparoo, you create an App to tell Grouparoo how to connect to Intercom. This specifies the account used for any Destinations.
In Grouparoo, you specify the options to connect to Intercom.
|Access Token (required)||Access token from your private app in the developer hub.|
For more information on options for keeping your credentials secure, visit our documentation on secrets.
This Destination enables you to sync your Grouparoo Records to Contacts in Intercom as either Users, Leads, or a dynamic combination of both depending on data.
Companies use Grouparoo to keep their Intercom Contacts up-to-date in order to communicate with their customers through a wide array of channels using one tool.
To create a Destination, you make choices about what data to sync.
A Destination’s sync mode determines what to update in a Destination. The following are supported by Intercom:
- Sync: Add, update, and remove Intercom Contacts as needed.This option looks for new records, changes to existing records, and deletions.
- Additive: Add and update Intercom Contacts as needed, but do not remove anybody. This option looks for new Contacts to add to Intercom and changes to existing Intercom Contacts, but does not keep track of deletions.
- Enrich: Only update those Contacts that already exist in Intercom. Do not add or remove Contacts. This option will only update existing Contacts in Intercom.
To further clarify how Intercom should sync data, select how data should be synced.
|Creation (required)||There are three creation options for Intercom.|
These options only apply if using a syncMode that can add new contacts.
|Removal (required)||There are two removal options for Intercom.|
These options only apply if using a syncMode that can remove contacts.
Mapping Record Properties to Intercom User Attributes is the key to syncing data to Intercom.
In Intercom, User Attributes can be used to filter and create customer segments. You can also use Intercom User Attributes to qualify leads and trial users.
Some properties are required to be able to find or create the correct Contacts in Intercom.
In Lead creation mode, the only required field for mapping Grouparoo Properties to Intercom User Attributes is email. Otherwise, when using User or Lifecycle creation mode, there are two required fields to map: email and external_id.
- email: a Contact’s email address in Intercom
- exernal_id: set on a Contact with an identifier from your internal system, often assigned when they sign up for your service
In addition to required fields, Intercom has many other User Attributes available to map data to including custom attributes that you have already created. Any of these can be synced to from Grouparoo Properties.
In addition to mapping Grouparoo Properties to Intercom User Attributes, you can use Grouparoo Groups to apply tags to Intercom User Records.
In Intercom, tags are similar to User Attributes and segments but they are used for grouping users and companies manually to highlight special features such as those requiring VIP support or those who are loyal customers. Tags can be synced using Grouparoo Groups.
We strive to keep our documentation accurate, easy to use, and up to date. If you notice that something has changed or is not addressed in the process of setting up your Grouparoo connection with Intercom, please let us know by reaching out to email@example.com.
As always, if you need support using Grouparoo, reach out to community members in our Slack channel. We are always happy to help!
- Calculated Property