Integrations
Intercom is one place for every team in an internet business to communicate with customers, personally, at scale—on your website, inside web and mobile apps, and by email.
In order to enable mParticle’s integration with Intercom, you will need an account with Intercom to get the App ID and API Key for mParticle configuration. Your App ID is required for all platforms. The API Key is only required for iOS, tvOS and Android.
Click here for instructions on how to create your Intercom Full Access API Key. Your App ID and API Key settings are available on the API Keys page on Intercom, accessible from your Integration settings.
The Intercom integration requires the mParticle Intercom Kit when connected to a web input. If you are initializing the web SDK using the Snippet Option then the Kit is automatically included for you. If you are Self Hosting the SDK then you need to add this kit manually into your source code.
To be able to forward event data to Intercom, you need to have at least one of the following user identifiers:
Event data without at least one of these identifiers will not be forwarded.
Intercom has limits around the number of characters and number of attributes as noted below:
| Setting Name | Data Type | Default Value | Description |
|---|---|---|---|
| App ID | string |
Your App ID is available on the API Keys page on Intercom, accessible from your Integration settings. |
| Setting Name | Data Type | Default Value | Platform | Description |
|---|---|---|---|---|
| Widget ID | string |
#IntercomDefaultWidget | Web | Enter a Widget ID or class to customize the display of the Intercom Messenger or leave the default value. |
| API Key | string |
iOS, Android, tvOS | Your Api Key is available on the API Keys page on Intercom, accessible from your Integration settings. |
Was this page helpful?