Skip to main content

​
Prerequisites

In Halo ITSM, you need an API application configured with the Client Credentials grant type. To create one:
  1. Log in to your Halo ITSM instance
  2. Navigate to Configuration > Integrations > HaloPSA API
  3. Click New to create an application
  4. Set Authentication Method to Client Credentials
  5. Use Login type ‘Agent’ and Agent to log in as ‘Application identity’
  6. Grant the application access to the following scopes: read:tickets, edit:tickets
  7. Save the application and copy the Client ID and Client Secret

​
Connect Wirespeed to Halo ITSM

  1. Log in to Wirespeed
  2. Navigate to Integrations > Add Integration
  3. Select Halo ITSM and click Integrate
  4. Fill in the following fields:
    • Halo Instance URL — the base URL of your Halo instance (e.g. https://yourcompany.halopsa.com)
    • Client ID — from the API application created above
    • Client Secret — from the API application created above
  5. Click Save
Wirespeed will verify the credentials by checking access to Teams, Ticket Types, and Categories. If any check fails, the integration will not be enabled — double-check the credentials and scopes.

​
Configure Ticket Behavior

After enabling the integration, click Configure to set ticket creation preferences:
SettingDescription
TeamHalo team to assign tickets to
CategoryIncident category to assign to all tickets (required)
Create Tickets for Standalone DetectionsWhen enabled, tickets are created for detections that are closed and not part of a case
Case Ticket Title TemplateTitle template for case tickets. Supports variables like `sid` and `title`
Detection Ticket Title TemplateTitle template for detection tickets. Supports variables like `sid` and `title`
Click Save when done.

​
Add a Webhook

To have Wirespeed cases closed automatically when a ticket is resolved in Halo, and to sync notes back, set up a webhook:
  1. Log in to Wirespeed
  2. Navigate to Integrations > select your Halo ITSM integration > Configure
  3. Copy the Webhook URL and the Webhook Secret
  4. Log in to your Halo ITSM instance
  5. Navigate to Configuration > Integrations > Webhooks
  6. Click New to create a webhook
  7. Paste the Webhook URL from Step 3
  8. Set the Secret to the Webhook Secret from Step 3
  9. Under Events, enable Ticket Updated by Agent and Ticket Updated by User
  10. Save the webhook
The webhook secret is required. Wirespeed uses HMAC-SHA256 to verify that incoming requests originate from your Halo instance.

​
How It Works

  • When a Wirespeed case or detection triggers, a ticket is created in Halo as an Incident with priority mapped from severity (Critical → P1, High → P2, Medium → P3, Low/Info → P4).
  • When a ticket is closed in Halo (status ID 9), the corresponding Wirespeed case is automatically closed.
  • Notes added to a ticket in Halo are synced back to the Wirespeed case timeline.