Ask AI

Integrating Evo with Halo PSA

Evo now integrates with Halo PSA

Evo now integrates with Halo PSA to help streamline customer and license management.

The Evo integration with Halo PSA simplifies synchronization between the two platforms — allowing you to import customers, align licensing data, and automate updates between Evo and Halo PSA. Companies can define unit costs and pricing for each license type, which are automatically created and updated within Halo PSA under the configured contracts.

With Evo and Halo PSA, you can:

  • Import customers from Halo PSA into Evo Security
  • Link existing Evo customers with corresponding Halo PSA accounts
  • Define unit cost and unit price for each Evo Security license type
  • Automatically create and update license details in Halo PSA under configured contracts
  • Synchronize license pricing bi-directionally between Evo and Halo PSA
  • Update license quantities in Halo PSA based on changes in Evo Security
  • Generate tickets or alerts within Halo PSA based on Evo events
 

Note: There is a new permission needed for roles to be able to manage the PSA integrations. Under Role-Based Permissions (On the Home Tab, select Access and Role-Based Permissions). The option to select for the appropriate role is "Manage PSA Integrations"

 

You can find the integration by navigating to Integrations on the Left side of your Evo Portal and selecting PSA and then HaloPSA

Notion image

Configure Integration

To configure the PSA integration, you'll need to create a new Client ID and API key ( Secret ) for Evo to integrate with HaloPSA.

Note: An application with these privileges is required to perform this configuration correctly.

Permission Category
Access Level
Tickets
read:tickets, edit:tickets
Customers
read:customers, edit:customers
Contracts
read:contracts
Items
read:items, edit:items
Invoices
read:invoices, edit:invoices

To Create API Credentials on Halo PSA, you will need to click “Configuration” on the home Page

Notion image
 

Once in here you would then Click on “Integrations”

Notion image

From here you will then click on “HaloPSA API”

Notion image

Then once you are on the “HaloPSA API” Page, there will be a button that says “View Applications”. After clicking into View applications you will click “+New”

 
Notion image

After clicking into View applications you will click “+New” at the top right

 
Notion image

When creating an application, the Authentication Method should be "Client ID and Secret" This will generate the Client ID and Secret needed when configuring the integration with Evo. You will also need to set a name and an agent to login as

Notion image

Retrieving the Base URI

Lastly, you will need to locate your Base URI, which can be found on the Halo PSA API page. This page displays both your Resource Server URL and Authorization Server URL.

For the Evo integration setup, use the base portion of either URL — omitting the suffix:

  • Remove /api from the Resource Server URL, or
  • Remove /auth from the Authorization Server URL

This resulting value is your Base URI, which will be entered in the Evo Portal during integration setup.

Notion image

At this stage, you’ve gathered all the required details to configure and finalize the Halo PSA integration in the Evo Portal.

Notion image

After entering the three required values obtained from Halo PSA, click Create to complete the integration setup. Once the integration has been created, you can proceed to configure synchronization settings for Companies, Billing, and Tickets within the Evo Portal

Notion image
 

Billing Setup

Recurring Products (Item Group Configuration)

When the HaloPSA integration is first created, Evo licenses are automatically created as items within Halo. In order for these licenses to properly link to contracts and invoices, they must be assigned to an Item Group with a Group Type of Recurring Products.

Verifying or Creating the Recurring Products Item Group

  1. Navigate to Configuration in HaloPSA.
  1. From the left-hand navigation, select Items and Stock Control.
    1. Notion image
  1. Click Item Groups.
    1. Notion image
  1. Verify that an Item Group named “Recurring Products” exists.
  1. If the Item Group does not exist:
      • Click + New in the top-right corner.
      • Create a new Item Group named Recurring Products.
      • Ensure the Item Group Type is set to Recurring Products.
      • Save your changes.

This step is required for Evo licenses to be billable through HaloPSA.

 

Recurring Invoices

As part of the HaloPSA integration, Evo automatically imports and links contracts (referred to as Agreements in Halo) to their corresponding companies. However, Evo licenses can only be billed when they are associated with a Recurring Invoice, which must be linked to the relevant agreement.

If a linked agreement does not have a recurring invoice, a warning will appear on the Integrations page stating:

“No recurring invoice associated with this contract.”

When this warning is present, billing for the affected company or contract will be disabled until a recurring invoice is created.

Creating a Recurring Invoice

  1. Navigate to Invoices in HaloPSA.
  1. Select Recurring Invoices from the left-hand navigation.
    1. Notion image
  1. Click + New > New Recurring Invoice in the top-right corner.
    1. Notion image
  1. Complete the required fields, ensuring:
      • The correct Customer is selected.
      • The appropriate Agreement (Contract) is linked.
  1. Save the recurring invoice.

Once the recurring invoice is in place, Evo license billing will be enabled for the associated company and contract.

 

Ticketing Configuration Requirements

To enable ticket creation and automated workflows with the HaloPSA integration, several required ticket fields must be configured within HaloPSA. These fields are synchronized into the Evo portal and are used when defining ticket automation rules, including automatic ticket creation and closure.

The required ticket fields are:

  • Impact
  • Urgency
  • Category
  • Type

Impact and Urgency Configuration

Impact and Urgency values are managed within HaloPSA’s Lookup Codes and must exist prior to enabling ticketing automation.

Verifying Impact and Urgency Levels

  1. Navigate to Configuration in HaloPSA.
  1. Scroll to the bottom of the left-hand navigation and select Advanced Settings.
    1. Notion image
  1. On the Advanced Settings page, scroll to the bottom and click Lookup Codes.
    1. Notion image
  1. In the top-left dropdown menu, review the following lookup categories:
      • Impact Level
      • Urgency Level
  1. Confirm that predefined values exist within both categories.
      • If no values are present, create the appropriate entries and save your changes.

These values will be automatically synced and made available in the Evo portal for ticket configuration.


Ticket Category and Type Configuration

Ticket Categories and Types are configured under HaloPSA’s ticket settings and are also required for automated ticket handling.

Verifying Ticket Types

  1. Navigate to Configuration.
  1. Select Tickets from the left-hand navigation.
  1. Click Ticket Types.
  1. Confirm that one or more ticket types are configured and active.
    1. Notion image

Verifying Ticket Categories (Category 1)

The Evo integration uses Category 1 values for ticket categorization.

  1. From Configuration, remain in the Tickets section.
  1. Navigate to Categorisation.
  1. Click Edit Category 1 Values.
  1. Verify that appropriate ticket category values are configured.
      • If needed, add or update category values and save your changes.
        • Notion image

These Category 1 values will be synchronized into the Evo portal and used for ticket classification during automated ticket creation.


Once all required ticket fields are configured in HaloPSA, they will be available within the Evo portal for ticket automation and workflow setup.

Did this answer your question?
😞
😐
🤩