HaloITSM Integration

HaloITSM is an IT service management solution designed to streamline IT support processes and operations through ticketing, asset management, and workflow automation.

This integration enables you to connect ilert and HaloITSM easily and receive critical HaloITSM alerts via push, SMS, and voice notifications.

In ilert: Create a HaloITSM alert source

Go to Alert sources --> Alert sources and click Create new alert source.
Search for HaloITSM in the search field, click the HaloITSM tile, and then Next.
Give your alert source a name, optionally assign teams, and click Next.
Select an escalation policy by creating a new one or assigning an existing one.
Select your Alert grouping preference and click Continue setup. You may click Do not group alerts for now and change it later.
The next page shows additional settings, such as customer alert templates or notification priority. Click Finish setup for now.
On the final page, an API key and/or webhook URL will be generated. You will need it later.

In HaloITSM: Create a Custom Webhook integration

On the sidebar, click Configuration.

In the search bar enter "Custom integrations" and select Custom integrations from the results.

Click New.

Enter a Name and the following Base URL https://api.ilert.com/.

Save the custom integration.
Now, click Methods.

Then, click New.

Enter a Name.
Change the Method to POST and enter the previously created URL path into the field.

Click Body and choose JSON.

Add the following payload to the body.

{
    "ticket" : {
        "status" : {
            "id" : <<ticket^status^id>>,
            "name" : <<ticket^status^name>>,
            "shortname" : <<ticket^status^shortname>>
        },
        "id" : <<ticket^id>>,
        "summary" : <<ticket^summary>>,
        "details" : <<ticket^details>>,
        "dateoccurred" : <<ticket^dateoccurred>>,
        "dateclosed" : <<ticket^dateclosed>>,
        "tickettype" : {
            "id" : <<ticket^tickettype^id>>,
            "name" :  <<ticket^tickettype^name>>
        },
        "priority" : {
            "id" : <<ticket^priority_id>>,
            "name" : <<ticket^priority^name>>
        },
        "client_id" : <<ticket^client_id>>,
        "client_name" : <<ticket^client_name>>,
        "site_id" : <<ticket^site_id>>,
        "site_name" : <<ticket^site_name>>,
        "team" : <<ticket^team>>,
        "agent" : {
            "id" : <<ticket^agent^id>>,
            "name" : <<ticket^agent^name>>
        },
        "organisation_id" : <<ticket^organisation_id>>,
        "department_id" : <<ticket^department_id>>,
        "workflow_name" : <<ticket^workflow_name>>,
        "oppcompanyname" : <<ticket^oppcompanyname>>
    }
}

{
    "ticket" : <<ticket>>
}

In the next step add a new Runbook.

Enter a name for your newly created Runbook.

Add the following Events for the Runbook: "New Ticket Logged" and "Ticket Status Changed".

Now click Flow Chart and Edit.

Enter a Step Name.
Change the Type to Action. Choose the Action type "Execute an Integration Method" and Method "ilert integration: send ticket to ilert" (previously created method).
Save the Step.