HaloPSA
Connect NetLock RMM to HaloPSA: alerts become tickets of the mapped client, the all-clear adds a hidden note and sets the closing status, devices can be synced as assets, clients and sites can be imported.
HaloPSA
Requirements
- An API application in HaloPSA under
Config > Integrations > Halo API, with the authentication methodClient ID and Secret, the permission scopeall, and an agent it runs as. - For a hosted instance, its tenant name, which is shown on the same page.
Setup
- In
Settings → Integrations, open the HaloPSA tile and chooseConnect. - Enter the
Instance address, for examplehttps://company.halopsa.com, theClient IDand theClient secret, and for a hosted instance theTenant. AnAuthorisation serveris only needed if it is not located at/authon the instance. - Under options, choose the
Ticket typeand theClosing status, and optionally aTeam.Outcome of the noteis the action outcome that writes a private note. - Map each tenant to a client, or import clients and sites. Tenants without a mapping are not included.
- Optionally map locations to sites and severities to priorities.
- Activate the connection.
The API allows 700 requests in five minutes per tenant; a job that hits this limit waits and then continues.
What goes to the vendor
For every alert that passes the filter of the connection: a title, the severity, tenant, location and device name, the source, first and last time seen, the alert text, and a link to the web console if the public console URL is set. Check that this matches your data processing agreements before you activate the connection.
With the asset sync on, also: device name, operating system, manufacturer, model, serial number, IP address and MAC address.
What happens to a ticket
- An alert becomes a ticket of the mapped client, at the mapped site if there is one. The reference
NetLock-Alert-<id>is added at the end of the summary. - When the alert ends, the ticket gets a note hidden from the user, without an e-mail, and it is set to the closing status if nobody is working on it.
- A ticket with an agent counts as assigned.
- If Halo refuses the status, for example because of a field required on closing, the ticket stays open with its note, and the history says
close_refused.
The behaviour is set in the Settings tab, see A.14.4. NetLock never deletes anything at the vendor.
Asset sync
The sync is off by default. Assets can count towards a license in Halo. Switch on Sync devices as assets, and map device classes to asset types or choose a Default asset type. A device of a class without a type is named in the history and waits; the other devices are still processed.
- An asset carries
NetLock-Device-<id>as inventory number. NetLock reuses an existing asset only on an exact match. - A device without a location mapping goes to the main site of its client.
- The fields of an asset type differ per instance, so the device details are written to the notes of the asset.
- A device that moved to another client gets a new asset there. The old one stays.
- An alert of a synced device links the asset to the ticket.
Contract quantities
The HaloPSA connector does not write contract quantities. The asset sync keeps the assets of each client current, which a recurring item in HaloPSA can count.
Known limits
- Tickets in NetLock show the ticket id, no link.
Related
NEXOWARE / c-entron
Connect NetLock RMM to NEXOWARE / c-entron ERP: alerts become helpdesk tickets of the mapped customer, the all-clear adds a comment and closes the ticket, devices can be kept as customer devices, device counts go to contract items.
Autotask PSA
Connect NetLock RMM to Autotask PSA: alerts become tickets of the mapped company, the all-clear adds a note and sets the closing status, devices can be kept as configuration items, device counts go to contract services.