HaloPSA Integration

HaloPSA is a comprehensive platform tailored for managed IT service providers, offering a suite of tools for efficient business management, including service desk, asset management, and billing.

In ilert: Create a HaloPSA alert source

Go to Alert sources --> Alert sources and click Create new alert source.
Search for HaloPSA in the search field, click the HaloPSA 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 HaloPSA: 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>>
    }
}

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" (the previously created method).
Save the Step.