Intercom Destination
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
- From the Segment Destinations page click Add Destination.
- Search for “Intercom” and select it in the results that appear.
- Choose a Kotlin or Swift Mobile source to connect to Intercom.
- Authorize your Intercom account in Segment and select the Intercom Account to sync with Segment.
- 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. |
| Rich Link Properties | 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
Need support?
Questions? Problems? Need more info? Contact Segment Support for assistance!