# Twilio Alarms Integration

The [Twilio Alarms](https://www.twilio.com/docs/usage/monitor-alarms) integration forwards alarms such as SMS failures or Twilio API issues as technical alerts to on-call personnel. These alerts activate escalation policies and help ensure communications remain operational.

## In ilert: Create a Twilio Alarms 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 **Twilio Alarms** in the search field, click on the Twilio Alarms tile and click on **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 you [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 show additional settings such as customer alert templates or notification prioritiy. Click on **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%2Fi3TIOBvNYBQfDtNpmm0A%2FScreenshot%202023-08-28%20at%2011.47.34.png?alt=media&#x26;token=6cae965a-e448-4443-8c20-37cf501c43b2" alt=""><figcaption></figcaption></figure>

## In Twilio Alarms: Add ilert Webhook

1. Navigate to **Monitor -> Alarms -> Manage alarms** and click on the **Create alarm** button on the top right corner.

   <figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FGvl0bJkBGdvsY2scZHP1%2Ftwilio-1.png?alt=media&#x26;token=fec67e9b-6c9b-4c4f-ba2f-e23ad66e4873" alt=""><figcaption></figcaption></figure>
2. Select a desired Error in the **Error code** field.

   <figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FjpCPE8Fobm0LJQ5jyuBf%2Ftwilio-2.png?alt=media&#x26;token=f303a3c2-84f0-4c59-9775-c3b4d2d7dd0e" alt=""><figcaption></figcaption></figure>
3. In the next step define an alarm threshold and a time period.

   <figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2F1kVOZGADQyIEC7B1hj1I%2Ftwilio-3.png?alt=media&#x26;token=8393a1c2-6ddf-4ad6-b9e5-8a58bc8ae255" alt=""><figcaption></figcaption></figure>
4. Select **Enable webhook** and enter the **Webhook URL** from ilert created in [this step](#in-ilert-create-twilio-alarms-alert-source) into the field below.

   <figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FnQeS6fC5kcGfSB03ExrG%2Ftwilio-4-1.png?alt=media&#x26;token=41aab78c-9378-49b9-aca1-3a3210870e37" alt=""><figcaption></figcaption></figure>
5. Enter a name for the alarm and click on Save.

## FAQ

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

No, unfortunately Twilio Alarms is not compatible with ilert's resolve event.
