Intercom

Use GrowthLoop audiences for Intercom contact attributes you can filter on.

Connect this destination to export audience membership as a flywheel_segment_id custom attribute on Intercom contacts, for use in Intercom messages.

This destination writes to your Intercom account and is a good fit when you want to:

  • Make GrowthLoop audiences available for Intercom messaging
  • Match contacts on Intercom External ID and email

This maps to GrowthLoop Audiences and Journeys:

Use it forAudiencesJourneys
Marking audience membership on Intercom contacts✓✓

Prerequisites

Make sure you have:

  • An Intercom account you can authorize for GrowthLoop.
  • A dataset column for Intercom External ID.
  • A dataset column for the contact's email. GrowthLoop uses email to find or create the Intercom contact.
  • The GrowthLoop Team this destination should belong to, if your organization uses more than one team.

Set up Intercom as a destination

  1. In GrowthLoop, click the Destinations tab on the left sidebar.
  2. Click New Destination in the upper right corner.
  3. Search for Intercom under Livechat and click Add Intercom.
Select Destination modal showing Intercom under Livechat
  1. Log in to Intercom and authorize access for GrowthLoop.
Intercom authorization screen for GrowthLoop
  1. After you grant GrowthLoop access, enter the required information, then click Create.
Intercom destination setup form with team, destination name, and sync frequency
FieldDescription
TeamThe GrowthLoop team this destination belongs to. If your organization has more than one team, select the team your user belongs to.
Destination NameName this destination in GrowthLoop. Use a name so your team recognizes its purpose, like "Intercom Messaging".
Sync FrequencySet the default export frequency to Daily or Hourly. You can override this setting for individual exports.
OAUTH TokenAutomatically populated when Intercom redirects you back to GrowthLoop. If it is empty, generate the token in Intercom and try again.

GrowthLoop validates the connection by calling Intercom as that authorized user. Intercom then appears in your list of connected destinations.

Export to Intercom

From within GrowthLoop, export from an audience or from a journey Destination Node. See Export an audience or Build a journey if you need more information on these steps.

After building or selecting an audience, click Export, then search for Intercom. In a journey, add a Destination Node under Livechat and select Intercom.

Journey Destination Node with export name, match fields, and personalization signals

Map contact identifiers

On an audience or in a journey Destination Node, map Intercom External ID. This field is required in the export.

GrowthLoop also needs email on each row to find or create the Intercom contact. Map the warehouse column that holds the email address you use in Intercom.

This destination does not send additional personalization fields.

Configure the export

This is where you set the campaign type and schedule for audience exports. On a journey Destination Node, you set timing on the journey canvas.

SettingAudience exportJourney Destination Node
Export NameDefaults to the audience name. GrowthLoop writes that name into flywheel_segment_id.Required. Enter a name so you can find the export in GrowthLoop. GrowthLoop writes that name into flywheel_segment_id.
Campaign typeChoose a one-time or ongoing export.The journey schedule controls when the journey runs and contacts are sent to Intercom.
ScheduleSet frequency, start date, end date, and days of the week for ongoing exports.Users reach this node when the journey runs. Add a Delay Node or set Criteria Evaluation to control timing.

Export behavior

This is what GrowthLoop writes when you export an audience.

BehaviorWhat happens
What GrowthLoop writesThe flywheel_segment_id custom attribute on the Intercom contact. The value is a list of GrowthLoop audience names. Direction is GrowthLoop → Intercom.
When it runsGrowthLoop sends the export as a batch on the next successful run. An export that starts Now runs within about 15 minutes. Journeys send exports on demand when users reach the Destination Node.
Match fieldsIntercom External ID is required in the export. GrowthLoop finds or creates the contact by email.
Contact createIf Intercom has no matching contact, GrowthLoop creates one and sets flywheel_segment_id.
Archived contactsIf the email matches an archived contact, GrowthLoop unarchives it and then updates membership.
One-time exportsGrowthLoop adds the audience name to flywheel_segment_id for current members.
Ongoing adds and removalsOngoing exports add the audience name when someone enters and remove it when they leave.
DeletesGrowthLoop does not delete Intercom contacts.
Intercom segmentsGrowthLoop does not write an Intercom segment. Build a segment in Intercom that filters on flywheel_segment_id.

Confirm the export was successful

When the run finishes, confirm you can use the data in Intercom.

  • Audience export: Open People and look up a contact from the export. Check the flywheel_segment_id custom attribute. It should include the GrowthLoop audience name.
  • Journey Destination Node: Open People and look up a contact who reached the node. Check that flywheel_segment_id includes the export name.

To message those contacts, create an Intercom segment that filters on flywheel_segment_id containing that audience name.

In GrowthLoop, review Added, Removed, and failed counts on the audience Exports tab, or open the Activity tab on the journey Destination Node. See Export an audience or Monitor a journey for more information.

Congrats on successfully exporting to Intercom!

Troubleshooting

These are the issues we see most often. You can always email us at [email protected] for help.

ProblemCauseResolution
OAUTH Token is empty after you return to GrowthLoopIntercom did not finish authorization, or the token was not generatedAuthorize GrowthLoop again in Intercom. Confirm the token exists in your Intercom account, then reconnect
The destination is on the wrong teamTeam does not match the GrowthLoop team you intendedEdit the destination and select the team your user belongs to
Rows fail to exportIntercom External ID or email is missingMap Intercom External ID and include the contact's email on the row
You cannot find an Intercom segment for the audienceGrowthLoop writes a custom attribute, not an Intercom segmentOpen the contact in People and check flywheel_segment_id. Create an Intercom segment that filters on that attribute
The contact is missing in PeopleEmail did not match, or the contact is still archivedConfirm the email on the row matches Intercom. Search again after the export completes

What’s Next

Export an audience after you connect a destination

Did this page help you?