Using NetCrunch to create tickets in LiveAgent Helpdesk

LiveAgent is one of the most popular helpdesk software for SMBs. This article will explain and show how to set up two-way integration between NetCrunch and LiveAgent Helpdesk.

Enable NetCrunch to post to LiveAgent

To enable NetCrunch to post essential alerts as Tickets directly to your LiveAgent Helpdesk, you need to set up an Integration Profile for LiveAgent. To do so, click Monitoring Integration Profiles at the top of the NetCrunch application.

In the editor, you need to enter the name for the new Integration Profile, and you will be asked for an API Key. To find out where to find your API Token follow the link: https://support.ladesk.com/741982-API-key. Now copy the key to the Integration Profile and save it.

LiveAgent Integration Profile

Create an alert and send a ticket to LiveAgent

To allow NetCrunch to utilize the integration, it's necessary to create an alerting script (or edit the already existing one). The steps below explain how to create a new alerting script.

  • Click Monitoring Alerting Escalation Scripts
  • In Alerting Scripts Window click Add Alerting Script
  • Click Add and select Action to Run Immediately
  • Click Integrations tab and select LiveAgent Ticket
Create alerting script for LiveAgent

A new window will appear, and NetCrunch will take a moment to load your Departments. Now select the Department the tickets should be sent to. It might be beneficial to create a separate Department for NetCrunch tickets for a better overview. Also, enter an email that will be shown as the requester of this ticket. You might want to create an individual account for this, make sure it is an active visitor email. Also, enter the Support Email of your Helpdesk, but ensure that the "Requester" can access this email.

Make sure that you are using the correct profile and test sending tickets to LiveAgent by clicking Test. A small window with the test procedure will appear, and if everything is properly configured the test will finish with the "Successfully executed"message. In the result, the test ticket should now appear in your Helpdesk in the configured Department.

Test LiveAgent integration

However, this will not work with the "Resolve Ticket" operation. To test the "Resolve Ticket" operation, you need to create an alerting script with an "Open Ticket" operation as Action to Run immediately and the "Close Ticket" operation as Action to Run on Alert Close. Then select a node and create an alert (for example Monitoring Disabled) to test and assign the alerting script to this alert. The following steps explain how to create a "Node Monitoring Disabled" alert for a single node.

  • Right-click the node where you want to create an alert
  • Select the Node Settings and click Alerts&Reports in the node settings window
  • Click Add Alert, select the Basic tab and choose Node monitoring is disabled
  • Right-click the new Alert and select Assign Predefined Alerting Script Your Script name
Assign the alerting script for LiveAgent

If you now trigger the alert (Disable the Node Monitoring), you will create a ticket. If this alert is closed (Node Monitoring Enabled) the ticket will be commented upon and resolved. After such an alerting script is attached to various alerts, NetCrunch will send messages to LiveAgent each time when the given alert is generated.

LiveAgent Result

You can also send tickets to different Departments. It can be done by creating a new alerting script for each department without creating a new Integration Profile each time. Just make sure to name the scripts clearly for easier distinguishing later.

WebHooks or HTTP Request (Two-way-integration)

LiveAgend Helpdesk is one of our two-way-integrations - it means that you can configure an HTTP Request that sends information back to NetCrunch when the ticket is resolved in LiveAgent so that the alert in NetCrunch is closed as well. This does not resolve the problem which caused the alert but it will close the alert generated by NetCrunch (i.e. Node is still down even though the alert is closed).

To be able to receive such a request from LiveAgent, you need to configure the NetCrunch API Key access. To do so, go to the LiveAgent Integration Profile and click "Open API Key Manager." Copy the WebHook URL and replace the [Web_access_address] with your Web access address (i.e., https://123.456.789.0/ncinf/rest...).

API Key Manager

Go to LiveAgent, select Configuration Automation Rules and create a new rule. Give the Rule a descriptive name and select Apply when "ticket status changed". Now define the conditions similar to this:

  • IF ticket department is (i.e.) NetCrunch Department AND new status is Resolved.
Request config

Now select the action "HTTP request" and add the URL with your replaced Web_Access_Address in the field for the URL. Select the HTTP Method "POST" and add the header "Content-Type:application/json". Enter this to the HTTP Body to be sent as Data to NetCrunch:

{
  "ID": "{$conv_conversationid}",
  "status": "{$conv_status}",
  "subject": "{$conv_subject}",
  "closedBy": "{$last_in_ticket_agent_lastname}, {$last_in_ticket_agent_firstname}"
}
Request config2

Save this Automation Rule. Now, when NetCrunch creates a ticket, and after LiveAgent Agent resolves it, the alert in NetCrunch will close. Please note that the problem may still exist, but the alert will be resolved in response to LiveAgent action.

Alert closed

integrationlive agentliveagent

NetCrunch Network Monitoring

Network Maps, Dashboards, and Alerts.
Monitor anything. Network, cloud, config.