README.md

Particle Integration

ilert is an all-in-one platform for incident management. It provides a set of features that helps companies increase their uptime and react to incidents in the most comprehensive way. Alerting, call routing, on-call scheduling, ChatOps, AI assistance in incident communication and post-mortem creation — these and many more functions enable teams to concentrate their efforts on issue resolution. ilert integration for Particle enables users to receive alerts from devices and notify engineers by multiple channels, be it phone calls, push notifications, SMS, etc. Use alert templates to enrich alerts with all vital information to help your team react quicker.

In ilert: Create a Particle alert source

1. Got to Alert sources -> Alert sources and click on Create new alert source

2. Search for Particle in the search field, click on the Particle tile and click on Next.

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.

5. Select you Alert grouping preference and click Continue setup. You may click Do not group alerts for now and change it later.

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.

In Particle: Create a Webhook

1. In the sidebar click on Integrations.

2. Now click on ADD NEW INTEGRATION.

3. Click on Webhook, to create a new webhook integration.

4. Enter a Name, an Event Name(ALERT or RESOLVE) and the previous generated ilert webhook URL into the URL field.
5. Change the Request Type to POST and open the Advanced Settings.

ALERT	RESOLVE

6. Select Default. (for custom json data follow this step)

7. Click on SAVE.
8. Optional: Click on TEST to test the integration.

Custom Webhooks

In Particle: Custom json data

1. Under Advanced Settings choose Custom for JSON DATA.
2. Create a template using the Particle documentation. (it is also possible to add own customized values)

In ilert: Create a custom template

1. Go to the alert source edit view.
2. Under Alert template enable Alert summary and Alert details.
3. For a detailed guide on how to use our alert templating click here.
4. Use the payload keys created in Particle to create the alert template.