# Integrate OpManager with ilert

OpManager alerts can now be converted into ilert Events, enabling customers to monitor, acknowledge, and resolve alarms before escalation. This integration supports event deduplication and suppression, helping reduce alert noise. Thereby, it streamlines response to critical issues, minimizes downtime, and improves overall system reliability.

**Steps to perform in ilert**

1. [Create an Alert Source](https://www.manageengine.com/network-monitoring/help/configure-opm-ilert.html#alert-source)

**Steps to follow in OpManager**

1. [Configure Custom Integration](https://www.manageengine.com/network-monitoring/help/configure-opm-ilert.html#custom-integration)
   1. [Create an Event](https://www.manageengine.com/network-monitoring/help/configure-opm-ilert.html#create-event)
   2. [Update an Event](https://www.manageengine.com/network-monitoring/help/configure-opm-ilert.html#update-event)
   3. [Close an Event](https://www.manageengine.com/network-monitoring/help/configure-opm-ilert.html#close-event)
2. [Associate a notification profile](https://www.manageengine.com/network-monitoring/help/configure-opm-ilert.html#notification-profile)

## Steps to perform in ilert

### Create an Alert Source

1. Navigate to **Alert Sources** → **New Alert Source** → search for **OpManager** → and select **OpManager**.

![opmanager-ilert-integration](https://www.manageengine.com/network-monitoring/help/images/opm-ilert.png)

2. Enter a **Name**.
3. Select **escalation policy** and **alert groupings** as needed (both are optional).
4. Click **continue setup**.
5. Verify the configuration and click **Finish setup**.
6. Copy the **integration key** and **API URL**.

![ilert-integration-key](https://www.manageengine.com/network-monitoring/help/images/opm-ilert-0.png)

## Steps to perform in OpManager

### Configure Custom Integration

1. Go to **Settings** → **General Settings** → **Integrations** → **New Custom Integration**.
2. Name the integration as **ilert Integration** and add a description.
3. In Integration Type, select **Event Management**.

### Create an Event

Enter the following details under **Create Event** to create an event in OpManager:

- **Method Type:** POST
- **Method URL:** https://api.ilert.com/api/events
- **Data Type:** Raw
- **Payload Type:** JSON
- **Body Content:**

```json
{
   "integrationKey": "<integ_key>",
   "eventType": "ALERT",
   "summary": "$displayName - $stringseverity",
   "details": "$message",
   "priority": "HIGH",
   "alertKey": "$entity"
}
```

**Note:** Replace `<integ_key>` with the integration key copied from the ilert page.

![create-event](https://www.manageengine.com/network-monitoring/help/images/opm-ilert-3.png)

- Click **Test action** to verify the connection and check the **Manage Event** box.
- In Fetch Event id, enter **$id**.

### Update an Event

To **update an event**, enter the following details:

- **Method Type:** POST
- **Method URL:** https://api.ilert.com/api/events
- **Data Type:** Raw
- **Payload Type:** JSON
- **Body Content:**

```json
{
   "integrationKey": "<integ_key>",
   "eventType": "ALERT",
   "summary": "$displayName - $stringseverity",
   "details": "$message",
   "priority": "HIGH",
   "alertKey": "$entity"
}
```

**Note:** Replace `<integ_key>` with the integration key copied from the ilert page.

### Close an Event

Enter the following details to close an event in OpManager:

- **Method Type:** POST
- **Method URL:** https://api.ilert.com/api/events
- **Data Type:** Raw
- **Payload Type:** JSON
- **Body Content:**

```json
{
   "integrationKey": "<integ_key>",
   "eventType": "RESOLVE",
   "summary": "$displayName - $stringseverity",
   "details": "$message",
   "priority": "HIGH",
   "alertKey": "$entity"
}
```

**Note:** Replace `<integ_key>` with the integration key copied from the ilert page.

![close-event](https://www.manageengine.com/network-monitoring/help/images/opm-ilert-4.png)

- Click **Save** to finalize the configuration.
- Click **Configure Now** under "Associate Notification Profile".

![associate-notification-profile-in-opmanager](https://www.manageengine.com/network-monitoring/help/images/opm-associate-notification-profile.png)

- Select **Custom_Integration** and choose the profile named "ilert integration".
- Learn more about configuring [criteria](https://www.manageengine.com/network-monitoring/help/configuring-notifications.html#criteria-notifications), [devices](https://www.manageengine.com/network-monitoring/help/configuring-notifications.html#select-devices), and [time window](https://www.manageengine.com/network-monitoring/help/configuring-notifications.html#applying-time-window) in notification profiles [here](https://www.manageengine.com/network-monitoring/help/configuring-notifications.html?custom_integration_ilert).
- Click **Save**.

Refer to the steps below to **configure multiple notification profiles**.

### Associate a Notification Profile

Follow the steps below to configure the notification profile:

1. Go to **Settings** → **Notifications** → **Notification Profiles** → **Add**.
2. Select **Custom_Integration** and choose the profile named "ilert integration".

![opmanager-ilert](https://www.manageengine.com/network-monitoring/help/images/opm-ilert-6.png)

3. Learn more about configuring [criteria](https://www.manageengine.com/network-monitoring/help/configuring-notifications.html#criteria-notifications), [devices](https://www.manageengine.com/network-monitoring/help/configuring-notifications.html#select-devices), and [time window](https://www.manageengine.com/network-monitoring/help/configuring-notifications.html#applying-time-window) in notification profiles [here](https://www.manageengine.com/network-monitoring/help/configuring-notifications.html?custom_integration_ilert).
4. Click **Save**.

### Verifying the Integration

Trigger a real-time alert in OpManager, then log in to your ilert interface to verify that the alert has been logged as an event.

![ilert-ui](https://www.manageengine.com/network-monitoring/help/images/opm-ilert-5.png)

[Know more about the integrations offered by OpManager](https://www.manageengine.com/network-monitoring/integration.html?custom_integration_ilert)

[Know more about dynamic variables used in request body](https://www.manageengine.com/network-monitoring/help/workflow-variables.html?custom_integration_ilert)