Particle Integration

Create alerts in ilert from Particle alerts.

Particle.io is a platform that provides everything necessary for organizations to develop, deploy, and manage their Internet of Things (IoT) products. It serves as a comprehensive ecosystem for connected device development with robust tools, APIs, and hardware kits. With Particle.io, you can build IoT devices at scale, delivering connectivity, device management, and security features out-of-the-box.

ilert's integration for Particle enables users to receive alerts from their devices via SMS, push, voice, and messenger notifications. It helps to connect Particle devices with other services and tools in the tech stack and speed up incident response.

In ilert: Create a Particle alert source

1. Go 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.

1. Now click on ADD NEW INTEGRATION.

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

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

ALERT

RESOLVE

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

1. Click on SAVE.

2. 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 this step to create the alert template.

FAQ

Will alerts in ilert be resolved automatically?

Yes, as soon as a webhook integration is sending an RESOLVE event, the alert in ilert will be fixed. To create RESOLVE events, follow the guide and use RESOLVE as Event Name.