# Samsara Integration

If Samsara's fleet management system identifies a problem, such as a vehicle malfunction or a driver safety incident, ilert can promptly send alerts to the relevant team members, ensuring a quick response. Here's a step-by-step guide on how to connect Samsara and ilert.

## In ilert: Create a Samsara alert source

1. Go to **Alert sources** -> **Alert sources** and click on **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 **Samsara** in the search field, click on the Samsara tile, and click **Next**.&#x20;

   <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.&#x20;

   <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 customer alert templates or notification priority. Click **Finish setup** for now.
7. On the final page, an API key and / or webhook URL will be generated that you will need later in this guide.

   <figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FmOV5sHlCxwou1lUgj9Xz%2F1-1.png?alt=media&#x26;token=c7eb712d-03f3-4797-b56e-d3ab36379dff" alt=""><figcaption></figcaption></figure>

## In Samsara: Create a webhook

1. In the sidebar, click on the Alert bell icon.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FqEjdAQSj1W7ih5MhirBs%2F1-2.png?alt=media&#x26;token=13f1e755-ff04-4057-8e67-d1a64348afde" alt="" width="563"><figcaption></figcaption></figure>

2. On the next screen, click on **Create Alert**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2Fl8koO7uDmB8qqcDDCRpx%2F2.png?alt=media&#x26;token=d35ce007-efd4-4b0a-8d84-1d2389d3e245" alt="" width="563"><figcaption></figcaption></figure>

3. Now select a desired **Trigger**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FpxuG7uvOZwNmDcYvT1jo%2F3.png?alt=media&#x26;token=ea581692-9d23-43d1-8641-f4ee7dc85188" alt="" width="563"><figcaption></figcaption></figure>

4. Now open the **Add Action** menu and choose **Send Webhook**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2Fw2IBKFLpa5gMDljHZntV%2F3-2.png?alt=media&#x26;token=c307a6a0-1869-4d4a-a3c9-b8e6aff9888f" alt="" width="563"><figcaption></figcaption></figure>

5. A new tab will open. Now click on **Manage**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2Fl6pHmGhswF7PvKV0CDPY%2F3-3.png?alt=media&#x26;token=5722906b-379a-47eb-8279-a4c968797ad0" alt="" width="563"><figcaption></figcaption></figure>

6. Click on **Add Webhook**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2F6ZUjbciIvq5Uzntil7tC%2F4.png?alt=media&#x26;token=9528a5c4-d5d7-419c-bbab-d4289432993c" alt="" width="563"><figcaption></figcaption></figure>

7. Enter a **Name**, the ilert alert source URL created in this [step](#in-ilert-create-a-samsara-alert-source) into the **Payload URL** field, and select some desired **Event Subscriptions**.
8. Click on **Create** to finish the webhook setup.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FTBLd5XMxhiyntKU9hYvW%2F5-2.png?alt=media&#x26;token=01d14a14-504d-4cf9-8dfd-235002504c1c" alt="" width="563"><figcaption></figcaption></figure>

9. Optional: Click on the **Test** button to send a test alert to ilert.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FbyjVTs2AtM2Neb4FWVgb%2F6.png?alt=media&#x26;token=8910eefc-b745-433b-8828-220435da95fe" alt="" width="563"><figcaption></figcaption></figure>

## FAQ <a href="#faq" id="faq"></a>

**Are alerts in ilert automatically resolved?**

Yes, as soon as an alert is resolved in Samsara, the corresponding Alert is automatically resolved in ilert.
