NetLock RMMNetLock RMM Docs
IV — Administration

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

  1. In Settings → Integrations, open the Freshdesk tile and choose Connect.
  2. Enter the Instance address and the API key.
  3. 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 the Status when closing.
  4. 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.
  5. 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.