Freshdesk
Connect NetLock RMM to Freshdesk: alerts become tickets, the all-clear adds a private note and sets a status, companies can be imported as tenants.
Freshdesk
Requirements
- A Freshdesk account, reached at
https://<account>.freshdesk.com. Other addresses are refused. - The API key of an agent who may create tickets, add notes, change the status, and read companies and contacts. The key is shown in the profile settings of the agent.
Setup
- In
Settings → Integrations, open the Freshdesk tile and chooseConnect. - Enter the
Instance addressand theAPI key. - Under options, enter the requester of tickets, the e-mail address under which tickets are created. Freshdesk creates the contact if it does not exist. Optionally choose a
Group, and choose theStatus when closing. - Map each tenant to a company, or import companies as tenants. Tenants without a mapping are not included. Without a severity mapping the four severities follow the four priorities.
- Activate the connection.
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.
What happens to a ticket
- An alert becomes a ticket with the reference as tag. The subject ends in
[NetLock-Alert-<id>]. - When the alert ends, the ticket gets a private note and moves to the chosen status if nobody is assigned.
The behaviour is set in the Settings tab, see A.14.4. NetLock never closes a ticket whose status somebody changed in the meantime, and it never deletes anything at the vendor.
Tickets and companies
A Freshdesk ticket belongs to the company of its requester. By default the configured address is the requester, so the ticket does not belong to the company; the tenant is named in the ticket text.
First contact of the company as requester assigns the ticket to the company. Freshdesk may then send its new-ticket notification to that contact, who is a customer. Check the requester notifications of your account before you switch it on.
Send the company with the ticket is for accounts with the Freshdesk feature Multiple Companies. Without that feature Freshdesk refuses the ticket.
Known limits
- If your account requires fields on closing, Freshdesk refuses the status. The ticket stays open with its note and the history shows
close_refused. - Devices are not synced to Freshdesk.
Related
Freshservice
Connect NetLock RMM to Freshservice: alerts become tickets, the all-clear adds a private note and sets a status, devices can optionally be synced as assets.
Odoo Helpdesk
Connect NetLock RMM to Odoo Helpdesk: alerts become tickets in a team, the all-clear adds an internal note and moves the ticket to a stage, companies can be imported as tenants.