# Intercom

[<mark style="color:blue;">Intercom</mark>](https://www.intercom.com/) is a software company that specializes in business messaging, providing businesses with a way to chat with their customers.

Route detailed alerts from Intercom to the right users in Squadcast.

### Using Intercom as an Alert Source

1. Navigate to **Services** -> **Service Overview** -> select or search for your Service. Expand the accordion -> In the Alert Sources section, click **Add**.

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-4fbd74e7ca0b30173c47a1d58ed6a0804a0465aa%2FAlert_Sources.png?alt=media\&token=aaca6610-9d18-4dd4-9cf5-320042f326f1)

2\. Select **Intercom**. Copy the displayed **Webhook URL** to [configure](#create-a-squadcast-webhook-alert-in-intercom) it within **Intercom.** Finish by clicking **Add Alert Source** -> **Done.**

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-f7b29ca303866c9c4f37e9db5339ee037984527d%2FIntercom.png?alt=media\&token=d158d970-a069-4f28-8caa-adfcd1997981)

{% hint style="warning" %}
**Important:**

When an alert source turns Active, it’ll show up under Configured Alert Sources, you can either generate a test alert from the integration or wait for a real-time alert to be generated by the Alert Source. An Alert Source is active if there is a recorded incident via that Alert Source for the Service.
{% endhint %}

### Create a Squadcast Webhook Alert in Intercom

**(1)** Login to your Intercom dashboard. Head over to **Settings**, then under **Apps & Integrations** click on **Developer Hub**

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-cf4c45779d72c39ff29c95b278fcd2fefe61f4b3%2Fintercom_2.png?alt=media\&token=f1cf47c6-b487-4800-98fc-0e1a4fcd2bb2)

**(2)** Click on **New app**, put in the **App name** and choose your appropriate **Workspace**. Select **Internal integration** and click on **Create app**

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-fd2b0ddb21770b4aac061ff51c7601a24bc224fa%2Fintercom_3.png?alt=media\&token=3e32f7c5-0329-47f7-9ce8-928ba893e454)

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-f250b984fa88865f392da41cd4899cc98b7fcbc5%2Fintercom_4.png?alt=media\&token=97cefece-43c6-4b11-89ce-2d150598978c)

**(3)** Now, click on **Webhooks** and then paste the previously copied Squadcast Webhook URL under **Your request endpoint URL**. Choose **conversation.user.created** or **conversation.priority.updated** and **conversation.admin.closed** as **Webhook topics**. Then click on **Save**

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-1e9d92c213909746f88ad50da9e2b97b8d36995b%2Fintercom_5.png?alt=media\&token=f7115aa5-0968-49a4-a2d9-f17bac6b24f0)

That's it, you are good to go! Your Intercom integration is now complete.

Whenever a conversation is created in Intercom, an incident will be created in Squadcast for it. Also, when the conversation is closed in Intercom, the corresponding incident gets **auto-resolved** in Squadcast.

*Have any questions?* [*Ask the community*](https://community.squadcast.com/view/home)*.*