# Intercom

### Setup

To set up Intercom, you'll need to create a new app in your workspace, and attach a webhook to it. 

1. From your Intercom dashboard, click your avatar in the bottom right hand corner, and select settings

![](/files/-MhUxYsLaSOSqtD23e90)

2\. Under settings, choose "Apps & Integrations" and then "Developer Hub".

![](/files/SuUQ7ZA5rxa12zK0aAJU)

{% hint style="warning" %}
Ignore the "Legacy Webhooks" page; Freshpaint is built to integrate with Intercom's modern app-based webhooks rather than the legacy workspace-based webhooks.
{% endhint %}

3\. Click "New App" and call the app whatever you'd like, perhaps "Freshpaint." Make sure you've connected it to the workspace that you'd like to collect data from. Select "Internal integration."

![](/files/-MhUy25C6P888pTz2l3x)

4\. In your new app configuration, go to "Webhooks"

![](/files/-MhUyBbWS-6vtqjHYGk3)

5\. For the endpoint URL, enter the url from the Intercom section of the [Freshpaint sources page](https://app.freshpaint.io/sources). It should look like `https://api.perfalytics.com/webhooks/intercom/<your env id>`

6\. You can now test the endpoint by going to the [Live View](https://app.freshpaint.io/events/liveview) page on Freshpaint, and trigger a test event from Intercom's webhook page. You should see an event come in called "Intercom ping"

![](/files/-MhUywtwg08FYEL_sybj)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.freshpaint.io/integrations/sources/intercom.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.