Requirements
Using this requires either PostHog Cloud with the data pipelines add-on, or a self-hosted PostHog instance running a recent version of the Docker image.
You'll also need access to the relevant Intercom account.
Setting up Intercom as a PostHog destination
- In PostHog, click the Data pipeline tab in the left sidebar.
- Click the Destinations tab.
- Search for Intercom and click the Create button for either Contacts or Events.
- In the destination editor, click Select Intercom connection to log into your Intercom account.
- You can test your destination by sending a test event with Test function.
- When all is as you like it, click Create & enable.
Configuration details
The Intercom destination requires that contacts already exist in Intercom before you can send events associated with them.
You can use the Intercom contact creation destination to ensure those records exist. It is pre-configured to fire on identify events, enabling Intercom to capture the same information on each user that PostHog does.
| Option | Description |
|---|---|
Intercom accountType: integration Required: True | |
Email of the userType: string Required: True | Where to find the email of the user. |
Include all properties as attributesType: boolean Required: True | If set, all person properties will be included. Individual attributes can be overridden below. |
Default property mappingType: dictionary Required: False | Map of Intercom properties and their values. |
Custom property mappingType: dictionary Required: False | Map of custom properties and their values. Check out this page for more details: https://www.intercom.com/help/en/articles/179-create-and-track-custom-data-attributes-cdas |
FAQ
Can I send session replays to Intercom?
Yes, you can add a link to the session replay in Intercom by setting the integrations config option when initializing PostHog's Web SDK to { intercom: true }. See our tutorial on adding session replays to Intercom for more details.
Can I add PostHog person profile data to Intercom?
Yes, you can add a link to the PostHog person profile in Intercom by setting the integrations config option when initializing PostHog's Web SDK to { intercom: true }. See our tutorial on adding session replays to Intercom for more details.
Is the source code for this destination available?
PostHog is open-source and so are all the destination on the platform. The source code is available on GitHub.
Who maintains this?
This is maintained by PostHog. If you have issues with it not functioning as intended, please let us know!
What if I have feedback on this destination?
We love feature requests and feedback. Please tell us what you think.
What if my question isn't answered above?
We love answering questions. Ask us anything via our community forum.