# Intercom Destination

## Destination Info

* Accepts [Page](/docs/segment/connections/spec/page), [Group](/docs/segment/connections/spec/group), [Identify](/docs/segment/connections/spec/identify), [Track](/docs/segment/connections/spec/track) calls.
* Refer to it as **Intercom** in the [Integrations object.](/docs/segment/guides/filtering-data/#filtering-with-the-integrations-object)

### Components

* [Browser](https://github.com/segment-integrations/analytics.js-integration-intercom)
* [iOS](https://github.com/segment-integrations/analytics-ios-integration-intercom)
* [Android](https://github.com/segment-integrations/analytics-android-integration-intercom)
* Server

> \[!WARNING]
>
> 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)](/docs/segment/connections/destinations/catalog/actions-intercom-cloud/) and [Intercom Web (Actions)](/docs/segment/connections/destinations/catalog/actions-intercom-web/) for more information.

## Getting started

1. From the Segment Destinations page, click **Add Destination**.
2. Search for "Intercom" and select it.
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](https://developers.intercom.com/installing-intercom/web/installation/#step-3-generate-a-config-file-with-this-command) or by navigating to the Gear Menu and clicking on **App Settings > API Keys**. It should look something like `9iefb489`.

## Mobile

### Kotlin

To find implementation details for Segment's Kotlin Intercom Destination Plugin, review the [Intercom plugin documentation](/docs/segment/connections/sources/catalog/libraries/mobile/kotlin-android/destination-plugins/intercom-kotlin-android/).

### Swift

To find implementation details for Segment's Swift Intercom Destination Plugin, review the [Intercom plugin documentation](/docs/segment/connections/sources/catalog/libraries/mobile/apple/destination-plugins/intercom-swift/).

## Settings

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

| Field                                         | Description                                                                                                                                                                                                                                                                                                                        | Required | Type    |
| --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ------- |
| Custom Inbox Button Selector                  | 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\` | No       | string  |
| API Base                                      | 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.                                                                                                                                                                   | No       | select  |
| Enter your API Key                            | Note: this is \*\*deprecated\*\* . Intercom requires events hitting their server-side api authenticated via OAuth.                                                                                                                                                                                                                 | No       | string  |
| App ID (required for analytics.js and mobile) | 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]\(https://intercom.io).  It should look something like this: \`9iefb489.\`                                  | No       | string  |
| Include Context with Identify Calls           | Pass context data with Identify calls as Custom Attributes. Includes device.type, device.manufacturer, device.model, os.name, os.version, app.name, app.version                                                                                                                                                                    | No       | boolean |
| Enter your Mobile API Key                     | Note: this is \*\*required\*\* to send data to Intercom from your mobile apps.                                                                                                                                                                                                                                                     | No       | string  |
| Rich Link Properties                          | 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.                                                                                                                                                          | No       | array   |