Intercom Destination

On this page


Destination Info
Components

Intercom (Classic) is in Maintenance mode

The Intercom (Classic) Destination has entered maintenance mode. Future updates are limited to security updates and bug fixes. This destination should only be used for Mobile connections. New versions of the destination are available for browser and server connections. See Intercom Cloud Mode (Actions) and Intercom Web (Actions) for more information.

Getting Started

  1. From the Segment Destinations page click Add Destination.
  2. Search for “Intercom” and select it in the results that appear.
  3. Choose a Kotlin or Swift Mobile source to connect to Intercom.
  4. Authorize your Intercom account in Segment and select the Intercom Account to sync with Segment.
  5. Find your “App ID” in the Intercom UI or by navigating to the Gear Menu and clicking on “App Settings” followed by “API Keys”. It should look something like 9iefb489.

Mobile

Kotlin

To find implementation details for Segment’s Kotlin Intercom Destination Plugin, please review the Intercom plugin documentation.

Swift

To find implementation details for Segment’s Swift Intercom Destination Plugin, please review the Intercom plugin documentation.

Settings

Segment lets you change these destination settings from the Segment app without having to touch any code.

Setting Description
Custom Inbox Button Selector string, defaults to #IntercomDefaultWidget .

By default, Intercom will inject their own inbox button onto the page, but you can choose to use your own custom button instead by providing a CSS selector like: #my-button. Note: you must have enabled the Show the Intercom Inbox setting for this to work. The default value is #IntercomDefaultWidget
API Base select. For customers who are using Regional Data Hosting for Intercom, you can choose the regional API to ensure your Messenger is pointing to your Regional workspace.
Enter your API Key string. Note: this is deprecated . Intercom requires events hitting their server-side api authenticated via OAuth.
App ID (required for analytics.js and mobile) string. Note: this is required to send data to Intercom from your browser or mobile app. You can find your App ID after activating your account under the Gear Menu > App Settings > API Keys at Intercom.io. It should look something like this: 9iefb489.
Include Context with Identify Calls boolean, defaults to FALSE .

Pass context data with Identify calls as Custom Attributes. Includes device.type, device.manufacturer, device.model, os.name, os.version, app.name, app.version
Enter your Mobile API Key string. Note: this is required to send data to Intercom from your mobile apps.
array, defaults to .

To use Intercom’s Rich Link object, list the name of the exact Segment property name and make sure the value of those properties only include url and value keys.

This page was last modified: 20 Mar 2024



Get started with Segment

Segment is the easiest way to integrate your websites & mobile apps data to over 300 analytics and growth tools.
or
Create free account