Intercom (Event Stream)

Amplitude Activation's Intercom streaming integration lets you forward your Amplitude events and users to Intercom in a few clicks.

Set up the integration

Prerequisites

Create a new Intercom app

1. From the Intercom Developer Hub, click Your Apps.
2. Click New App.
3. Enter a name and select a workspace.
4. Click Create App.

Refer to Intercom's documentation for more detailed instructions on creating an app.

Required information

To configure streaming from Amplitude to Intercom, you need the following information from Intercom.

Intercom Access Token: The Intercom Access Token for your Intercom app.

1. From the Intercom Developer Hub, click Your Apps.
2. Click your app.
3. Navigate to the Authentication page.
4. The Intercom Access Token appears immediately below the workspace name under Access Token.

Create a new sync

1. In Amplitude Data, click Catalog and select the Destinations tab.
2. In the Event Streaming section, click Intercom.
3. Enter a sync name, then click Create Sync.

Enter credentials

1. Select your Intercom API Endpoint.
2. Enter your Intercom Access Token.

Configure mappings

This applies to both event and user forwarding.

1. From the left dropdown, select an Amplitude user property that corresponds to your Intercom user ID.
2. From the right dropdown, select the type of your Intercom user ID.
   • User ID: Any unique identifier for each user in Intercom.
   • Email

Configure event forwarding

Under Send Events, enable the toggle ("Events are sent to Intercom") to stream events to Intercom. When enabled, Amplitude automatically forwards events to Intercom as Amplitude ingests them. This integration doesn't send events on a schedule or on-demand. Amplitude sends events to Intercom as Intercom data events. Intercom has a limit of 120 event types.

Intercom triggers an [Intercom] event.created event when Intercom creates events, including events from Amplitude's Event Streaming integration. If you don't want Amplitude to store these events, use Amplitude's block or drop filters to remove this data.

1. In Select and filter events, choose the events to send. Choose only the events you need in Intercom.

2. (Optional) In Select additional properties, select any more event and user properties to send to Intercom. If you don't select any properties here, Amplitude doesn't send any. Amplitude sends these properties to Intercom as Intercom event metadata. Intercom has a limit of 20 metadata values per event.

Configure user forwarding

To stream user and property updates to Intercom, enable Send Users. This setting creates or updates users in Intercom when you update them in Amplitude with the HTTP V2 API or Identify API. This integration doesn't support scheduled or on-demand updates. Amplitude creates each user as an Intercom contact.

Optionally, select user properties to send to Intercom in the Select additional properties field. Amplitude sends only the properties you select and only when one of them is updated. Amplitude sends these properties as Intercom custom attributes.

Enable sync

When the configuration looks correct, toggle the Status at the top of the page to Enabled and click Save.