# Help Scout Integration

[Help Scout](https://www.helpscout.com/) is a customer support platform for managing conversations across email and shared inboxes. By integrating Help Scout with ilert, you can route important support events to the right on-call teams and manage incident response in one place.

## In ilert: Create a Help Scout alert source

1. Go to **Alert sources** -> **Alert sources** and click **Create new alert source**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FjX0cS4q7woTXKajZmc1W%2FScreenshot%202023-08-28%20at%2010.21.10.png?alt=media&#x26;token=8ef3666b-84eb-4b51-abee-f07303313941" alt=""><figcaption></figcaption></figure>

2. Search for **Help Scout** in the search field, click the Help Scout tile, and then **Next**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FlXzQlJpaTFSR49AZk0xA%2FScreenshot%202023-08-28%20at%2010.24.23.png?alt=media&#x26;token=cffeacb4-57b9-47d4-827d-b0f6b1afd914" alt=""><figcaption></figcaption></figure>

3. Give your alert source a name, optionally assign teams, and click **Next**.
4. Select an **escalation policy** by creating a new one or assigning an existing one.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FNnuZqONaIhbOf6fn4OkZ%2FScreenshot%202023-08-28%20at%2011.37.47.png?alt=media&#x26;token=8a74f7b5-5bd2-4eea-97fa-1c1dbb041333" alt=""><figcaption></figcaption></figure>

5. Select your [Alert grouping](https://docs.ilert.com/alerting/configure-alerting/alert-sources#alert-grouping) preference and click **Continue setup**. You may click **Do not group alerts** for now and change it later.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FueugN4JgHn1c90ggFA6u%2FScreenshot%202023-08-28%20at%2011.38.24.png?alt=media&#x26;token=b8009daf-3ca8-4264-a6fa-e42ef7333205" alt=""><figcaption></figcaption></figure>

6. The next page shows additional settings, such as custom alert templates or notification priority. Click **Finish setup** for now.
7. On the final page, copy the generated **Help Scout URL**. You will use this URL in Help Scout.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2Fgit-blob-786716c07a3892a0bc7aa6d8b0c6353087665044%2Fhelpscout-01-ilert-alert-source-url.png?alt=media" alt=""><figcaption></figcaption></figure>

## In Help Scout: Add a webhook app

1. In Help Scout, go to **Manage** -> **Apps**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2Fgit-blob-8fee37668bb2701eea169b724b419c1f17a2cc07%2Fhelpscout-02-manage-apps-menu.png?alt=media" alt=""><figcaption></figcaption></figure>

2. Search for **webhook** in the Apps Directory and click **Add** on **Webhooks**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2Fgit-blob-b315c4de0efb9df662363aa83bd998d3d23e02ea%2Fhelpscout-03-apps-directory-webhook-add.png?alt=media" alt=""><figcaption></figcaption></figure>

3. In the **Webhooks** app settings, paste the previously copied Help Scout URL from ilert into **Callback URL**.
4. Keep the app **Active** and select the event types you want to send to ilert (for example, conversation created, assigned, and status updated events).

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2Fgit-blob-3d1da3831e3d23a21cc7adf9491064c4b166bb26%2Fhelpscout-04-webhook-callback-url-events.png?alt=media" alt=""><figcaption></figcaption></figure>

## FAQ

#### **Will alerts in ilert be resolved automatically?**

Yes. When Help Scout sends the corresponding closed/status update event for the same conversation, ilert resolves the matching alert automatically.
